项目变迁之二--关于maven相关配置

关于maven私服

慢慢的团队人多了起来，每个新人加入时都需要从maven中心仓库下载一堆东西，而且项目拆分后互相依赖的包也需要有个统一存储的地方，所以搭建maven私服也就顺理成章了。

在这里使用免费的nexus OSS作为maven仓库，具体的搭建教程参考这里：http://www.cnblogs.com/dqqiu/p/5654195.html

maven 配置

搭建私服后，可以选择在maven settings文件中加入私服相关配置，也可以选择在项目的pom.xml中配置。为了减少团队内新同学的配置，选择在pom.xml文件中配置，有什么改动只需要一人改动，其他人pull即可。不过settings.xml中需要配置私服的url、用户名密码，以及本地仓库的存储路径。

• 项目根pom.xml中关于私服的配置：
  <distributionManagement>
  
  <snapshotRepository>
  <id>snapshots</id>
  <url>http://ip:8081/nexus/content/repositories/snapshots/</url>
  </snapshotRepository>
  <repository>
  <id>releases</id>
  <url>http://ip:8081/nexus/content/repositories/releases</url>
  </repository>
  </distributionManagement>

  <repositories>    
      <repository>        
          <snapshots>            
              <enabled>true</enabled>        
          </snapshots>        
      <id>public</id>        
      <name>Public Repositories</name>        
      <url>http://ip:8081/nexus/content/groups/public/</url>    
  </repository>
  </repositories>
  <pluginRepositories>    
       <pluginRepository>        
          <id>public</id>        
          <name>Public Repositories</name>         
          <url>http://ip:8081/nexus/content/groups/public/</url>    
  </pluginRepository>
  </pluginRepositories>
  

• 子bundle中pom.xml文件的部分配置
  有些bundle设计为多个系统公用，这种情况下就需要将对应的jar包及sources源码包上传到私服中，而有些bundle则不需要上传，比如war包。

  • 需要上传jar及sources包的配置：
    <build>
    <finalName>yx-common</finalName> -- 打出的包名
    <plugins>
    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId> --使用此插件打包，并设置同时上传源码
    <executions>
    <execution>
    <id>attach-sources</id>
    <phase>verify</phase>
    <goals>
    <goal>jar</goal>
    </goals>
    </execution>
    </executions>
    </plugin>
    </plugins>
    这样在执行 mvn deploy命令时，就会把jar及sources.jar上传到maven私服中。
  • 而对于不需要上传到maven私服中的bundle，则需要增加以下配置
    
    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-deploy-plugin</artifactId>
    <version>2.8.2</version>
    <configuration>
    <skip>true</skip>
    </configuration>
    </plugin>

• 一些其它的maven配置

  • 如果不想在本地安装tomcat，则可以使用maven的tomcat插件来运行web工程，配置如下：
    <plugin>
    <groupId>org.apache.tomcat.maven</groupId>
    <artifactId>tomcat7-maven-plugin</artifactId>
    <version>2.1</version>
    <configuration>
    <port>8081</port>
    <path>/</path>
    <uriEncoding>UTF-8</uriEncoding>
    <server>tomcat7</server>
    </configuration>
    </plugin>
    然后在idea中如下配置,就可以直接运行了（端口可以分项目独立指定，在需要运行多项目的场景下灵活很多）：
    

    QQ图片20160831232902.png

  • 指定项目编译的jdk版本，避免版本问题造成的编译不通过，比如这里统一指定1.7版本的jdk
    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>2.3.2</version>
    <configuration>
    <source>1.7</source>
    <target>1.7</target>
    </configuration>
    </plugin>

  • 加入findbugs及checkstyle插件，用于检查代码问题及代码风格
    <plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>findbugs-maven-plugin</artifactId>
    <version>2.3.1</version>
    <configuration>
    <xmlOutput>true</xmlOutput>
    <xmlOutputDirectory>target/site</xmlOutputDirectory>
    </configuration>
    </plugin>
    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-checkstyle-plugin</artifactId>
    <version>2.5</version>
    </plugin>

  • 分环境设定参数
    由于存在测试及生产环境，每次打包发布都需要手动修改DB连接\缓存服务器地址\zookeeper服务器等信息，很容易出问题（出现过两次打出的线下包连接的却是线上环境服务器的情况，如果反之。。。蛋疼呦），所以加入了打包时指定参数来从不同的配置文件中获取对应参数的配置。在子bundle中加入如下：
    <profiles>
    <profile>
    <id>test</id>
    <properties>
    <env>test</env>
    </properties>
    <activation>
    <activeByDefault>true</activeByDefault> --默认为test环境
    </activation>
    </profile>
    <profile>
    <id>prod</id>
    <properties>
    <env>prod</env> --生产环境
    </properties>
    </profile>
    </profiles>

  在build配置模块指定对应的文件
  <build>
  <filters>
  <filter>src/main/resources/${env}.properties</filter>
  </filters>
  ......

  对应的properties可以自定义参数名称，举例如下：

  • test.properties
    dataSourceUrl=jdbc:mysql:replication://testmasterdbserver:3306,testslavedbserver:3306/yxdb?useUnicode=true&characterEncoding=UTF-8
    dbusername=testname
    dbpassword=testpassword
    quartzurl=jdbc:mysql:replication://testmasterdbserver:3306,testslavedbserver:3306/qrtz?useUnicode=true&characterEncoding=UTF-8
    zookeeperUrl=testzserver1:2181,testzserver2:2181,testzserver3:2190
  • prod.properties
    dataSourceUrl=jdbc:mysql:replication://prodmasterdbserver:3306,prodslavedbserver:3306/yxdb?useUnicode=true&characterEncoding=UTF-8
    dbusername=prodtname
    dbpassword=prodpassword
    quartzurl=jdbc:mysql:replication://prodmasterdbserver:3306,prodslavedbserver:3306/qrtz?useUnicode=true&characterEncoding=UTF-8
    zookeeperUrl=zserver1:2181,zserver2:2181,zserver3:2190

  而对应的xml配置文件就可以这样指定变量：
  <bean id="dataSource" class="*DataSource" init-method="init" destroy-method="close">
  <property name="url" value="${dataSourceUrl}"/>
  <property name="username" value="${dbusername}"/>
  <property name="password" value="${dbpassword}"/>
  ......
  在打包的时候，比如执行
  mvn package -Dmaven.test.skip=true （或mvn install -Dmaven.test.skip=true ）
  默认即可打出test环境的包。而如果需要打生产环境的包，直接指定执行prod profile即可，如下：
  mvn package -Dmaven.test.skip=true -Pprod

更多的配置，就不赘述了，可以根据自己的需要设定不同的插件，maven很强大，慢慢挖掘喽！