好记性不如烂笔头之Maven使用小记

一、前言

　　说起Maven，是在我上上东家接触的，掌握的还不错，因为种种原因，上家公司没有使用太多大众技术，我也没有太多施展的机会，对于以前掌握的技术，很多都荒废了，最近使用起来发现有点儿吃力了，为了加深自己对Maven的理解，以及杜绝下次再浪费时间到处查资料，特此开篇博客记录在使用Maven时一些小技巧~

二、正文

　　首先，需要说明一点，Maven可以控制和作用整个项目的生命周期，它是通过在每个生命周期中使用对应的插件来达到上面的目的的，所以很多时候，我们要改变默认插件的行为，就需要自己指定在对应阶段执行什么插件，并且指定插件需要执行的行为！理解和记住这句话，在使用maven过程中可以解决很多问题~

　　1、安装jar包到本地仓库命令（蓝色加粗部分自己根据实际情况修改）

  mvn install:install-file -DgroupId=oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=D:\jars\ojdbc14-10.2.0.4.0.jar

   <dependency>
        <groupId>oracle</groupId>
        <artifactId>ojdbc14</artifactId>
        <version>10.2.0.4.0</version>
    </dependency>

　　2、安装jar到私服nexus中（蓝色加粗部分自己根据实际情况修改）

mvn deploy:deploy-file -DgroupId=oracle -DartifactId=ojdbc14 -Dversion=10.2.0.4.0 -Dpackaging=jar -Dfile=D:\jars\ojdbc14-10.2.0.4.0.jar
-Durl=http://localhost:8081/repository/thirdparty/ -DrepositoryId=thirdparty

    <dependency>
        <groupId>oracle</groupId>
        <artifactId>ojdbc14</artifactId>
        <version>10.2.0.4.0</version>
    </dependency>

　　3、指出源代码开发时所用的jdk版本，设定编译成.class文件时编译使用的jdk版本

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

　　4、使用maven生成可运行的jar包（蓝色加粗部分自己根据实际情况修改）

<build>
      <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId><!--将这个项目依赖的jar包放置在lib目录下-->
            <executions>
                <execution>
                    <id>copy</id>
                    <phase>package</phase>
                    <goals>
                        <goal>copy-dependencies</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>
                            ${project.build.directory}/lib
                        </outputDirectory>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>com.yywlw.main.Entrance</mainClass  <!--指定项目Main函数入口-->
                        <addClasspath>true</addClasspath>
                        <classpathPrefix>lib/</classpathPrefix>
                    </manifest>
                </archive>
                <classesDirectory>
                </classesDirectory>
            </configuration>
        </plugin>
      </plugins>
<build>

　　以上配置的最终效果就是在target下多出一个lib目录，里面包含项目使用到的一些第三方的jar，或者自己的其他工程的jar，然后主jar包的MF文件中多了Main-Class和Class-Path的配置信息，这是保证该jar包可执行的条件：

　　

     5、当编译项目的时候，控制台报“错误: 编码GBK的不可映射字符”出现原因，以及解决办法

　　出现错误的原因：在maven的编译插件中声明正确的字符集编码编码——编译使用的字符集编码与代码文件使用的字符集编码一致！！

安装系统之后，一般中文系统默认字符集是GBK。我们安装的软件一般都继承使用操作系统的默认字符集。所以当在中文XP或者win7系统开发，在使用maven（mvn compile）编译项目的时候，就会出现“编码 gbk 的不可映射字符”： 这个是由于代码使用的UTF-8，而maven编译的时候使用的GBK的缘故。 可以通过修改项目的pom文件，可以告诉maven这个项目使用UTF-8编码来编译。

解决办法：

1） 在pom.xml文件中增加“project.build.sourceEncoding”配置

<!-- 指明编译源代码时使用的字符编码，maven编译的时候默认使用的GBK编码， 通过project.build.sourceEncoding属性设置字符编码，告诉maven这个项目使用UTF-8来编译 -->
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>  

　　2）pom.xml的/project/build/plugins/下的编译插件声明 中加入下面的配置：

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.6</source>
        <target>1.6</target>
        <!-- 指明编译源代码时使用的字符编码，
        maven编译的时候默认使用的GBK编码，
          通过encoding属性设置字符编码，
          告诉maven这个项目使用UTF-8来编译 -->
        <encoding>utf8</encoding>
    </configuration>
</plugin>  

三、链接

1、http://blog.csdn.net/alanzyy/article/details/47400591

四、联系本人

　　为方便没有博客园账号的读者交流，特意建立一个企鹅群（纯公益，非利益相关），读者如果有对博文不明之处，欢迎加群交流：261746360，小杜比亚-博客园