使用普通方式创建项目的问题
前几篇文章中,我们使用普通方法在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请看:
Eclipse建立Maven项目
![](https://i-blog.csdnimg.cn/blog_migrate/84452ba000665d8e0bf723af846c70c3.png)
![](https://i-blog.csdnimg.cn/blog_migrate/793a27f755ecb99a2d671796deacd78c.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/b46b42e73736dcd78a21ea33c91b7b10.jpeg)
GroupID是项目组织唯一的标识符,实际对应JAVA的包的结构,是main目录里java的目录结构。
ArtifactID就是项目的唯一的标识符,实际对应项目的名称,就是项目根目录的名称。
Version是版本号,这个自己写了。
![](https://i-blog.csdnimg.cn/blog_migrate/f7e0e503fc8b69e0c6831e53e199395a.png)
![](https://i-blog.csdnimg.cn/blog_migrate/b1e9c5d6f95166060a52b8e5f00bd15f.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/369de76bc826054a43e95193d5470740.png)
![](https://i-blog.csdnimg.cn/blog_migrate/851357e28889afe791787da5dc0375d4.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/61ada4d9de981406b8f50e6dee604ac7.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/135374cd5ac7e5d4e0a828c8ba3d6d7c.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/0feb2dc0b0241c20f4d39028627ffd38.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/7af7491386f3ab7f1351e05ddab5ac63.png)
![](https://i-blog.csdnimg.cn/blog_migrate/0cf7fb16eb58b4593e1fc488ec8802ae.png)
![](https://i-blog.csdnimg.cn/blog_migrate/5e3a0a913eeaacdd4ce69e7a731d411a.png)
此处列表是,部署项目时,文件发布的路径。
我们删除test的两项,因为test是测试使用,并不需要部署。见下图:
![](https://i-blog.csdnimg.cn/blog_migrate/b057c275d5e203f352a9326e60dc2b60.jpeg)
![](https://i-blog.csdnimg.cn/blog_migrate/c0c9163f4c3a96bcfb8907e3f93ea6a7.jpeg)
配置文件pom.xml
<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终于出来了,终于有点小小成就感!!!