Java Spring MVC入门（四）使用Maven创建项目

使用普通方式创建项目的问题

　　　前几篇文章中，我们使用普通方法在eclispe上创建了项目，并成功的运行了helloworld文件，那么普通方法创建的项目在多人协作开发项目的时候，可能会有下面问题

1、多人协作时候各成员所使用的jar包版本可能不一致，比如：张三下载的版本是3.2，而李四下载的版本是4.2 ，服务器上的版本是4.3，这样可能导致在本地运行正常，而在服务器上运行却有可能出现问题。

2、需要从网上去搜索自己所需要的依赖包，如果想要团队协作保证各个成员的jar包保持一致，需要来回的拷贝jar包。

什么是Maven

　　普通方式创建项目有上面所说的不足之处，还好我们有Maven可以解决上面的问题，那么什么Maven？（官网： http://maven.apache.org/index.html）

在这里我只能简单的介绍，让大家有个感性上的认识。

　　Maven是一个管理项目的工具，可以方便的管理项目的jar包依赖、测试、编译、打包、发布。

　　1、管理jar包依赖

　　　　这个功能可能是Maven最突出的特点，大家不用再去网上单独下载jar包，而是在pom.xml里配置jar包的依赖关系，具体看下面例子：

<dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>3.2.4.RELEASE</version>
</dependency>
<!-- Spring的核心工具包，其他包依赖此包 -->
<dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>3.2.4.RELEASE</version>
</dependency>

　大致解释下几个配置项的意思：

　　groupId：所述的项目名称，由于有的项目并不是一个jar包构成的，而是由很多的jar包组成的。因此这个groupId就是整个项目的名称。

　　artifactId：包的名称。

　　version：版本号。

　　packaging：包的类型，一般都是jar，也可以是war之类的。如果不填，默认就是jar。

　　大家可以看到每个jar包配置项内都有版本号，这样团队开发时候大家只要保证pom.xml一致，那么Maven就会自动下载pom.xml配置项内的包，这样既不用自己下载，又保证了团队内各个成员下载jar包的版本都一样。

　　2、其他功能

　　　　Maven除了管理依赖包之外，还可以编译、测试、打包项目，具体命令如下：　　　

mvn archetype：create 创建Maven项目
mvn compile 编译源代码
mvn deploy 发布项目
mvn test-compile 编译测试源代码
mvn test 运行应用程序中的单元测试
mvn site 生成项目相关信息的网站
mvn clean 清除项目目录中的生成结果
mvn package 根据项目生成的jar
mvn install 在本地Repository中安装jar
mvn eclipse:eclipse 生成eclipse项目文件
mvn jetty:run 启动jetty服务
mvn tomcat:run 启动tomcat服务
mvn clean package -Dmaven.test.skip=true:清除以前的包后重新打包，跳过测试类

　　如果想要更加深入了解Maven请看：

　　　maven学习（上）- 基本入门用法

　　 maven学习（中）- 私服nexus搭建

　　 maven学习（下）利用Profile构建不同环境的部署包

Eclipse建立Maven项目

　　1、打开eclispe 选择Fire-> New -> Maven Project

2、在弹框内填写选项

GroupID是项目组织唯一的标识符，实际对应JAVA的包的结构，是main目录里java的目录结构。

ArtifactID就是项目的唯一的标识符，实际对应项目的名称，就是项目根目录的名称。

Version是版本号，这个自己写了。

填写完成点击“Finish”。项目建好之后如下：

到这里项目已经基本成型，但是还没有完成，还要稍做配置，我们首先右击项目名->Build Path ->Configure Build Path..

把两个"missing"的项"Remove"掉，之后点"OK"。之后右击Java Resources -> New -> Source Folder

新增Source Folder

建立三个Source Folder

src/main/java

src/test/java

src/test/resources

完成之后如下：

之后再进入Java Build Path->Libraries标签，选中 JRE System Library[J2SE-1.5]，点击 Edit

选择下图选项：

接下来还要处理下排列顺序，进入Java Build path ->Order and Export

利用"Up" 和 "Down"将顺序调整成和上图一样。

最后还要设置部署程序集，右键项目名->Properties->Deployment Assembly，

此处列表是，部署项目时，文件发布的路径。

我们删除test的两项，因为test是测试使用，并不需要部署。见下图：

完成之后应该是下面这样

OK，终于完成了。

配置文件pom.xml

主要是要配置spring框架的一些依赖包，再就是和数据库相关的包，具体内容如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mavenPro</groupId>
  <artifactId>demo</artifactId>
  <packaging>war</packaging>
  <version>1.0</version>
  <name>demo Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
      <!-- spring需要的jar包 -->
      <!-- Spring的面向切面编程，提供AOP（面向切面编程）的实现 -->
      <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aop</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- Spring的核心工具包，其他包依赖此包 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 提供在基础IOC功能上的扩展服务，此外还提供许多企业级服务的支持，有邮件服务、任务调度、JNDI定位，EJB集成、远程访问、缓存以及多种视图层框架的支持。 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- Spring context的扩展支持，用于MVC方面 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context-support</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- Spring提供的对AspectJ框架的整合 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aspects</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 整合第三方的orm实现，如hibernate，ibatis，jdo以及spring 的jpa实现 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-orm</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 对JDBC 的简单封装 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 为简化jms api的使用而做的简单封装 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jms</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 包含SpringMVC框架相关的所有类。包含国际化、标签、Theme、视图展现的FreeMarker、JasperReports、Tiles、Velocity、XSLT相关类。当然，如果你的应用使用了独立的MVC框架，则无需这个JAR文件里的任何类。 -->
       <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 安全相关（待验证） -->
    <dependency>
        <groupId>org.springframework.security</groupId>
        <artifactId>spring-security-ldap</artifactId>
        <version>3.2.4.RELEASE</version>
    </dependency>
    <!-- 对JUNIT等测试框架的简单封装 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>3.2.4.RELEASE</version>
        <scope>provided</scope>
    </dependency>
    <!-- 使用 ehcache-spring-annotations 使得在工程中简单配置即可使用缓存   http://www.tuicool.com/articles/reuQvmn -->
    <dependency>
        <groupId>com.googlecode.ehcache-spring-annotations</groupId>
        <artifactId>ehcache-spring-annotations</artifactId>
        <version>1.2.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-mongodb</artifactId>
        <version>1.5.4.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.data</groupId>
        <artifactId>spring-data-redis</artifactId>
        <version>1.2.0.RELEASE</version>
    </dependency>
    
    <!-- servlet依赖 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.0.1</version>
    </dependency>
    
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <build>
    <finalName>mavenDemo</finalName>
  </build>
</project>

文件里有一些注释，初学者先大致了解，今后会详细介绍。

配置文件web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
    <display-name>demo</display-name>
    
    <!-- 
        该元素用来声明应用范围(整个WEB项目)内的上下文初始化参数 ，这里是加载spring的配置文件 
        context-param 可以有多个，这里只介绍contextConfigLocation，作用是加载spring的配置文件
        这里我曾经遇到一个坑，这里说出来告诉大家。
            大家先看<servlet>内有个<init-param>里面也有一个<param-name>contextConfigLocation</param-name>配置
            于是我自作聪明把最外层的<context-param>删除，只保留<servlet><init-param>内的配置，结果运行时候报错说找不到classpath:demo-servlet.xml
            文件，此时系统会自动去找/WEB-INI/applicationContext.xml文件，此时文件是不存在的所以也报错。
            切记：如果要用classpath方式去定位配置文件，文件路径在最外层的配置一定要有，仅仅只写servlet内的配置是无法找到的。如果最外层不想写
            只在servlet标签内定位spring配置文件，只能用/WEB-INI/文件名.xml这样的方式。
        
        这里可以看到我们有两个Spring 配置文件，一个是<context-param>里的<param-value>classpath:demo-root-serlvet.xml</param-value>
        一个是<servlet><init-param>内的<param-value>classpath:demo-servlet.xml</param-value>，这样的目的是为了将配置文件分开，不同的配置放到不同的
        文件里，例如：数据库配置可以放到单独文件，AOP配置可以放到单独文件里。demo-root-serlvet.xml里面可能包含了其他配置文件，这里我们仅仅作为演示，暂时为空。
    -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 
            配置路径方式有两种，一种是将文件放到WEB-INF目录下 parm-value的值为/WEB-INF/文件名.xml,另外一种是用classpath:文件名.xml
            文件放到/src/main/resources/下 
        -->
        <param-value>classpath:demo-root-servlet.xml</param-value>
    </context-param>
    
    <context-param>
        <param-name>log4jExposeWebAppRoot</param-name>
        <param-value>false</param-value>
    </context-param>
    <!-- character -->
    <filter>
        <filter-name>characterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    
    <!-- spring mvc -->
    <servlet>
        <servlet-name>gameLiveServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:demo-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>gameLiveServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
</web-app>

注释写的有点多，大家要仔细看，这里重点说下我踩过的坑：

这里我曾经遇到一个坑，这里说出来告诉大家。
大家先看<servlet>内有个<init-param>里面也有一个<param-name>contextConfigLocation</param-name>配置
于是我自作聪明把最外层的<context-param>删除，只保留<servlet><init-param>内的配置，
结果运行时候报错说找不到classpath:demo-servlet.xml文件，此时系统会自动去找/WEB-INI/applicationContext.xml文件，
此时文件是不存在的所以也报错。
切记：如果要用classpath方式去定位配置文件，文件路径在最外层的配置一定要有，仅仅只写servlet内的配置是无法找到的。如果最外层不想写
只在servlet标签内定位spring配置文件，只能用/WEB-INI/文件名.xml这样的方式。

Spring容器加载web.xml的顺序为context-param >> listener >> fileter >> servlet

Spring配置文件

　　在上面的web.xml配置文件中我们有两个Spring的配置文件，分别是/src/man/resources/demo-root-serlvet.xml 和/src/man/resources/demo-servlet.xml

用classpath方式定位文件必须要放到/src/man/resources/下否则要放到/src/main/webapp/WEB-INF/ 路径下。

/src/man/resources/demo-root-servlet.xml 文件的主要用途为包含其他子配置文件，例如数据库配置文件、AOP配置文件。

　　/src/man/resources/demo-servlet.xml 文件主要是声明一些本项目用到的bean。

/src/man/resources/demo-root-servlet.xml 内容：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xmlns:util="http://www.springframework.org/schema/util" xmlns:jdbc="http://www.springframework.org/schema/jdbc" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 
    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd
    http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.2.xsd 
    http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.2.xsd
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.2.xsd" default-autowire="byName">
    <description>Spring公共配置</description>
    
    <!--  <import resource="classpath*:demo-db.xml"/> -->
</beans>

由于本次不涉及数据库内容，所以我将引入数据配置文件内容注释了。

/src/man/resources/demo-servlet.xml内容：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xmlns:util="http://www.springframework.org/schema/util" xmlns:jdbc="http://www.springframework.org/schema/jdbc" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 
    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd
    http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-3.2.xsd 
    http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.2.xsd
    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.2.xsd
    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.2.xsd" default-autowire="byName">
    
    <description>demo</description>
    <!-- 注册Bean -->
    <bean id = "HelloWorld" class="com.demo.game.HelloWorld"> </bean>
</beans>

Hello world

接下来我们就要写hello world 了，先在/src/main/java里建立一个包，再包内建立一个文件HelloWorld

HelloWorld.java内容如下：

package com.demo.game;

import java.io.IOException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorld {
    @RequestMapping("/hello")
    public void index(HttpServletRequest request, HttpServletResponse response) throws IOException {
        
        response.setHeader("content-type", "text/html;charset=UTF-8");
        response.getWriter().append("hello World");

    }
}

大家看到没有demo-servlet.xml配置文件里有一句：

<bean id = "HelloWorld" class="com.demo.game.HelloWorld"> </bean>

将HelloWorld注册为一个bean ，这样就让他由一个普通类变成控制器了，接下来我们启动tomcat server ，再浏览器里输入http://localhost:8080/demo/hello

忙活了半天，hello world终于出来了，终于有点小小成就感！！！

posted @ 2016-09-27 19:41 scofi 阅读(8597) 评论(5) 编辑收藏举报

刷新页面返回顶部

汪爷的博客

欢迎沟通交流QQ：357774123 暗号（博客园）