Maven入门

最近在写一个通用工具的java版sdk，在构建jar包时接触到了maven。

一、Maven是什么

最初对maven的印象，是觉得它和php的composer很像，因为自己主要用了pom.xml的dependency功能。逐渐了解之后发现maven要比composer强大很多，composer主要用来管理php项目的依赖包，相对于maven来说，管理依赖只是maven提供的其中一项功能。
依照官方说法，Maven是一个软件项目管理和综合工具，基于项目对象模型（pom.xml）的概念，可以完成创建项目、管理依赖、运行测试、生成文档等一系列工作。

二、Maven项目目录结构

maven构建的项目目录结构是固定的：
src
----main
--------java
--------resources
----test
--------java
--------resources
main中java存放源代码，resources存放配置文件；test中java存放测试源码，resources中存放配置文件。

三、Maven核心pom.xml

maven的核心是pom.xml，通过在pom中填写配置来管理依赖、编译等工作，自己在项目中目前只用了一部分功能。
管理项目依赖，是通过在pom.xml中增加dependency配置来完成的，如：

<dependencies>
    <dependency>
        <groupId>com.googlecode.libphonenumber</groupId>
        <artifactId>libphonenumber</artifactId>
        <version>8.8.9</version>
    </dependency>

    <dependency>
        <groupId>net.sf.json-lib</groupId>
        <artifactId>json-lib</artifactId>
        <version>2.3</version>
        <classifier>jdk15</classifier>
    </dependency>
</dependencies>

通过上面的配置，我的项目成功导入了libphonenumber和json-lib。
默认情况下，Maven从Maven中央仓库下载所有依赖关系。但是有些依赖可能是中央仓库没有的，是需要从其他地方下载的，此时需要通过repositories配置。

<repositories>
    <repository>
      <id>java.net</id>
      <url>https://maven.java.net/content/repositories/public/</url>
    </repository>
 </repositories>

四、常用命令

mvn compile在根目录生成target文件
mvn clean将根目录下生成的target文件移除
mvn install将本地工程打包成jar包，放入到本地仓库中。
mvn deploy将最终版本的jar包拷贝到远程的repository

五、开发中遇到的问题

1、用Intellij创建maven项目后，每次更新pom.xml后，jdk自动变为1.5

解决方法：intellij创建maven默认会使用jdk1.5版本，需要在pom中指定build时想用的jdk版本。

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.1</version>
            <configuration>
                <source>1.9</source>
                <target>1.9</target>
            </configuration>
        </plugin>
    </plugins>
</build>

2、依赖中引入了log4j，编译执行时一直报log4j的错误。

解决方法：在src/main/resources下新建log4j.properties配置文件，设置log4j的一些参数。

#定义输出级别
log4j.rootLogger=DEBUG,Console,File
#日志输出方式：控制台输出
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.Target=System.out
log4j.appender.Console.Encoding=GBK
#可以灵活地指定布局模式
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
#log4j.appender.Console.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss.SSS} -%p (%F\:%L)- %m%n
#打印格式栗子：2017-08-11 15:36 -DEBUG (HttpServletBean.java:174)- Servlet 'mvc' configured successfully
log4j.appender.Console.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm} -%p (%F\:%L)- %m%n
### 打印SQL ###
#log4j.logger.com.ibatis=DEBUG
#log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=DEBUG
#log4j.logger.com.ibatis.common.jdbc.ScriptRunner=DEBUG
#log4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate=DEBUG
#log4j.logger.java.sql.Connection=DEBUG
#log4j.logger.java.sql.Statement=DEBUG
#log4j.logger.java.sql.PreparedStatement=DEBUG
#log4j.logger.java.sql.ResultSet=DEBUG
log4j.appender.File = org.apache.log4j.FileAppender
log4j.appender.File.File = log4j.log
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

3、Intellij下编译生成jar包

菜单中选择File->project structure
选择Artifacts，点击+号，选择jar，再选择from modules with dependencies
选择一个Main class
菜单中选择Build->make project
生成的jar包在out目录下