Maven的好处相比做过项目的童鞋都知道。它是用来专门管理项目和代码的工具。能够很好的管理项目,控制jar包的资源。打包,发布都十分的方便,这篇博文主要介绍一下maven的安装和使用。
一:安装和配置环境变量、maven仓库的设置
二:使用CMD创建maven项目,打包并运行操作
三:eclipse中创建maven项目、打包jar、打包war、部署在tomcat
四:maven项目使用常见错误,以及错误处理情况
五:maven项目的导入和打包,以及pom文件的使用
一:安装和配置环境变量、maven仓库的设置
1. 下载:可以从官方最新版下载地址:http://maven.apache.org/download.cgi下载maven压缩包,下载完成后解压到本地磁盘中即可完成安装。
2. 配置环境变量:maven的运行需要设置环境变量,在我的电脑高级设置中添加环境变量:M2_HOME,值为:E:\maven\apach-maven-3.5.0,然后添加到path变量中:(;%M2_HOME%\bin),完成环境变量的设置。
3. 每一个maven都会对应一个仓库,即常见的.m2文件,该文件中存储了一个jar资源包,项目中使用的jar依赖都是来自于这个仓库。那这个仓库在哪里,又是如何生成的呢?在我们下载解压好的maven中,conf文件下有一个settings.xml文件,该文件指明了仓库的存放地址(默认在C盘用户下的.m2文件中),以及仓库的资源地址(改地址会在maven运行加载时自动从改地址下载仓库到本地的.m2文件)。
①仓库位置:大概在该文件的50行左右,可以通过<localRepository>e:/maven/repository</localRepository>,来完成默认仓库存放地址的修改
②仓库的资源下载地址:在settings.xml文件中,找到<mirrors>标签,在该标签中添加资源下载地址,目前比较流行下载alibaba的maven资源。
<mirror>
<id>alimaven</id>
<mirrorOf>central</mirrorOf>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
</mirror>
4. 此时maven已经安装并配置完成了, 在CMD中输入mvn -v,查看Maven的版本信息,出现了版本信息表示maven配置成功。
5. 那还需要下载maven仓库,怎么下载呢?可以使用CMD的命令:mvn help:system,默认下载setting中设置的仓库地址下载到设置的maven仓库路径中。执行完成后,即可看到在配置的路径下有一些jar包资源,则这些jar包资源就可以在maven项目的pom文件中直接引入使用了。
二:使用CMD创建maven项目,打包并运行操作。
正常创建和打包maven项目都不会在命令行中进行,都会在IDE工具中完成。此例通过命令行完成maven项目的创建和打包和执行jar。演示maven的原生运行过程。
1. CMD中,路径切换至新建的项目文件夹中,确保1这个文件夹中是空的。
执行命令:mvn archetype:generate -DgroupId=com.java -DartifactId=j2se -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
意思是创建一个项目,项目包名:com.java,项目名称时:j2se,项目类型:maven-archetype-quickstart
执行,即可发现1文件夹中被搭建好了maven项目。并在java文件夹中自动生成了app.java,main方法中输出"Hello World",
2. 将项目打包,打成jar,并运行出"Hello World"
打包:CMD路径切换到j2se下,运行mvn package,此命令会将该项目编译、测试、打包等一系列操作,然后在target下生成一个jar包。
运行:执行命令:java -cp target/j2se-1.0-SNAPSHOT.jar com.java.App,此时就会在CMD中打印输出了"Hello World"。
3. CDM创建的打包以及运行结束。
三:eclipse中创建maven项目、打包jar、打包war、部署在tomcat。
在eclipse中如何创建maven项目呢?其实很简单
1. 首先需要在eclipse中声明maven版本、仓库位置、JDK的版本信息等
①在eclipse中声明maven版本:菜单->Window->Preferences->Maven->Installations->E:\amven\apache-maven-3.5.0,指定maven的位置
②菜单->Window->Preferences->Maven->User Settings-> Global Settings 和 User Settings都使用:maven下的setting路径,指定仓库的位置信息
2. 创建Maven项目,通过new->maven project
这个按照默认点击next,
然后默认是maven-archetype-quickstart类型,如果要创建WEB类型的maven项目就选择如下所示,然后next:
然后输入项目包名,和项目名,点击finish,完成创建:
3. 创建完成maven项目由于JDK是使用的eclipse中默认的JDK,会导致项目报错,此时右键项目->属性->Java Build Path->Libraries->Edit->Workspace default JRE(jdk8)->Finish,完成设置,如果index.jsp文件报错的话,则双击打开pom.xml文件,选择dependences然后选择ADD,搜索servlet,添加servlet的jar包即可。此时通过启动tomcat,访问index即可启动该项目。
4. 搭建一个maven风格的SSM项目:
在maven中搭建项目,最重要的就是对jar包的依赖,也就是配置pom.xml文件,搭建SSM项目所需要用到的依赖如下:
<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>maven.wht</groupId>
<artifactId>web</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>web Maven Webapp</name>
<url>http://maven.apache.org</url>
<properties>
<spring.version>4.1.3.RELEASE</spring.version>
<pagehelper.version>5.1.2-beta</pagehelper.version>
<mysql.version>5.1.6</mysql.version>
<mybatis.spring.version>1.2.3</mybatis.spring.version>
<mybatis.version>3.1.1</mybatis.version>
<junit.version>4.12</junit.version>
<jstl.version>1.2</jstl.version>
<jsqlparser.version>1.0</jsqlparser.version>
<jackson.version>1.2.7</jackson.version>
<servlet-api.version>3.1.0</servlet-api.version>
<druid.version>1.0.18</druid.version>
<log4j.version>1.2.16</log4j.version>
<commons-logging.version>1.2</commons-logging.version>
<commons-fileupload.version>1.2.1</commons-fileupload.version>
<commons-io.version>1.3.2</commons-io.version>
<commons-lang.version>2.6</commons-lang.version>
<aopalliance.version>1.0</aopalliance.version>
<mybatis-generator.version>1.3.5</mybatis-generator.version>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${mybatis.spring.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- JSP相关 -->
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>${jstl.version}</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>${servlet-api.version}</version>
<scope>provided</scope>
</dependency>
<!-- pageHelper -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>${pagehelper.version}</version>
</dependency>
<!--jsqlparser-->
<dependency>
<groupId>com.github.jsqlparser</groupId>
<artifactId>jsqlparser</artifactId>
<version>${jsqlparser.version}</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>${commons-logging.version}</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>${commons-fileupload.version}</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>${commons-io.version}</version>
</dependency>
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>${commons-lang.version}</version>
</dependency>
<dependency>
<groupId>aopalliance</groupId>
<artifactId>aopalliance</artifactId>
<version>${aopalliance.version}</version>
</dependency>
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>${mybatis-generator.version}</version>
</dependency>
</dependencies>
<build>
<finalName>${project.artifactId}</finalName>
<plugins>
<!-- 资源文件拷贝插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.7</version>
<configuration>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!-- java编译插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.2</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
<pluginManagement>
<plugins>
<!-- 配置Tomcat插件 -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
</plugin>
</plugins>
</pluginManagement>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
<include>**/*.tld</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
</project>
设置完成jar包依赖之后,则按照SSM的创建方式,完成SSM项目的搭建,指的注意的是:在maven项目中,xml配置文件可以放置在resources路径下(该路径其实也是SRC根路径),在webapp中创建相应的jsp或者js等,大概项目结构如下图:
5. 以上SSM项目通过eclipse工具打成war包或者jar包。并发布部署在tomcat中运行访问,无论打什么类型的包,有个原则是现maven clean一下。
①打war包:首先在pom.xml中,<packageing>标签的值为war,右击项目->run as->maven clean->,然后run as->maven install->完成打包,此时打好的包存放在项目的target路径下。然后将该war包修改下简单点的文件名,放在tomcat的webapp路径下,启动Tomcat,即可访问该项目。打好的war包会在WEB-INF目录下生成lib文件夹,从maven导入的相关jar包都会在该路径下。
如果点击clean没有反应,是因为eclipse没有添加maven的参数,解决办法:window-java-installed JREs-选中使用的jdk-在default中加入maven的环境变量值:-Dmaven.multiModuleProjectDirectory=$M2_HOME,点击OK即可。
如果点击install时,building失败,提示信息表示jdk or jre,则该错误原因是:eclipse中默认的添加的是jre编译,我们需要修改成JDK编译,还要对比pom.xml中的jdk版本是否一致。修改方法:window-preferences-java-installed JREs-删除原来的jre,-add-standard VM-选择JDK的安装路径(可以在cmd中 java -verbose查看安装路径)点击OK即可。
②打成jar包,则将pom.xml文件的<packageing>值修改为jar即可,运行jar包项目时,需要在CMD中,文件路径转到jar包所在路径,然后通过命令jave -jar jar包名.jar ,运行该jar包。
四:maven项目使用常见错误,以及错误处理情况。
1. 如果maven项目报错org.springframework.web.context.ContextLoaderListener,提示ClassNotFound异常,查找jar包依赖能找到该jar,原因是工程部署时,没有创建lib文件,导致无法加载资源。所以tomcat启动失败。进入到tomcat的eclipse中部署路径.metadata\.plugins\org.eclipse.wst.server.core\tmp0\wtpwebapps\下检查了一下,发现工程部署后在WEB-INF文件夹下没有生成lib目录,正常情况下,会生成lib目录并把工程的所有依赖jar包都部署到该目录下。
解决方案:
1.右键点击项目--选择Properties
选择Deployment Assembly,在右边点击Add按钮,在弹出的窗口中选择Java Build Path Entries
2.点击Next,选择Maven Dependencies
3.点击Finish,然后可以看到已经把Maven Dependencies添加到Web应用结构中了
重新部署项目,启动tomcat,问题解决。
五:maven项目的导入和打包,以及pom文件的使用