DevTestOpsGuide

开发 测试 上线 的经验与笔记

View project on GitHub

Maven dep 依赖

注意 Windows 不区分大小写，Linux 区分，必须写对

不应使用systemPath引用本地包

会使与他有关的项目难以编译

别人经常需要排除的依赖应设置为可选<optional>true</optional>

比如日志，如果 log4j2 和 logback 都存在就会导致 slf4j 报 Class path contains multiple SLF4J bindings.

maven-compiler-plugin添加jar路径时必须添加${project.basedir}，否则在Linux和Mac下会找不到包

3.1 前(JDK6)，注意这里是compilerArguments，后面有个s

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.0</version>
        <configuration>
          <compilerArguments>
            <bootclasspath>${java.home}/lib/rt.jar</bootclasspath>
            <extdirs>${project.basedir}/src/main/webapp/WEB-INF/lib</extdirs>
          </compilerArguments>
        </configuration>
      </plugin>

3.1 后 (最新 version 可以参考 http://maven.apache.org/plugins/maven-compiler-plugin/usage.html)

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.8.1</version>
        <configuration>
          <compilerArgs>
            <arg>-extdirs</arg>
            <arg>${project.basedir}/src/main/webapp/WEB-INF/lib</arg>
          </compilerArgs>
        </configuration>
      </plugin>

一些老旧的项目引用了com.sun的包，需要配置-bootclasspath， 并且确保 JAVA_HOME 环境变量指向的是有这些类的 Oracle JDK，而不是 openjdk， 可以参考 Maven_sun/pom.xml

${env.JAVA_HOME}/jre/lib/rt.jar 是环境变量，如果没设置会保留原样

${java.home}/lib/rt.jar 是 java.lang.System.getProperties() 中的，同样还有${user.name}

javac 参数参考：https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javac.html

-bootclasspath 引导类路径

根据指定的引导类集交叉编译。与用户类路径一样，引导类路径条目由冒号分隔，并且可以是目录，JAR归档文件或ZIP归档文件。

-extdirs 目录

针对指定的扩展目录进行编译。目录是目录的冒号(Windows 分号)分隔列表。将搜索指定目录中的每个 JAR 存档以搜索类文件。

-verbose

详细输出。这包括有关加载的每个类和编译的每个源文件的信息。

-Xlint:unchecked

为 Java 语言规范规定的未选中转换警告提供更多详细信息。

-deprecation

显示已弃用成员或类的每次使用或重写的说明。
如果没有-deprecation，javac显示使用或重写弃用成员或类的源文件的摘要。
-deprecation是 -Xlint:deprecation 的简写。

区分好“依赖问题”和“编译问题”

依赖问题：

Could not resolve dependencies for project 出现问题的模块:
The following artifacts could not be resolved: 不能解析的依赖列表:
Could not find artifact 【找不到的包】 in 远程仓库ID (远程仓库URL)

编译问题：

[INFO] Changes detected - recompiling the module!
[INFO] Compiling 源文件数 source files to /路径/target/classes
[INFO] -------------------------------------------------------------
[WARNING] COMPILATION WARNING :
[INFO] -------------------------------------------------------------
 
 
...中间省略n行...
 
 
[ERROR] /路径/src/包路径/类名.java:[行,列] cannot find symbol
  symbol:   class 找不到的符号
  location: package 找不到的包

改了配置后因为缓存不下载包，是因为本地仓库有.lastUpdated和_remote文件，可以跑脚本删除目录下这些文件，或者运行时加-U参数。

was cached in the local repository,
resolution will not be reattempted until the update interval of 远程仓库ID has elapsed or updates are forced

delete_lastUpdated_and_remote.sh

仓库 id 不要重复，非中央仓库不应使用 central

镜像配置用于对特定的存储库使用备用镜像，而不更改项目文件，

mirrorOf对应repositoryId，可以设置为*或central。

假设配置repository时使用central作为id，那么就不能不同仓库用不同的 mirror。

经常修改的包应使用区间依赖，如[1.0, 2)

区间依赖官方文档：https://maven.apache.org/pom.html#dependency-version-requirement-specification

仓库只下载稳定版本，需做好配置，建议配置在 pom.xml 文件中

  • 仓库默认只下载稳定版本，如果 Nexus 代理是混合仓库的话需要在pom.xml或settings.xml中设置仓库快照为启用。
  • 由于不同项目对包的要求不一样，建议在 pom.xml 中配置，在某些 DevOps 平台上也更好处理。

  • 如果 settings.xml 配置了 mirror，那么 pom.xml 配置了也无效，需要对这个 mirror ID 配置快照启用。

  • settings 镜像配置官方文档：https://maven.apache.org/settings.html#mirrors
  • settings 仓库配置官方文档：https://maven.apache.org/settings.html#repositories

settings.xml

<settings>
  <mirrors>
    <mirror>
      <mirrorOf>*</mirrorOf>
      <id>ali_mirror</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>

  <profiles>
    <profile>
      <id>ali_repo</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
        <repository>
          <id>ali</id>
          <name>阿里云公共仓库</name>
          <url>https://maven.aliyun.com/repository/public</url>
          <releases>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
            <checksumPolicy>warn</checksumPolicy>
          </releases>
          <snapshots>
            <enabled>true</enabled>
            <updatePolicy>always</updatePolicy>
            <checksumPolicy>warn</checksumPolicy>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

</settings>

pom 仓库配置官方文档：https://maven.apache.org/pom.html#repositories

pom.xml

<project>
  <repositories>
    <repository>
      <id>ali</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <releases>
        <enabled>true</enabled>
        <updatePolicy>always</updatePolicy>
        <checksumPolicy>warn</checksumPolicy>
      </releases>
      <snapshots>
        <enabled>true</enabled>
        <updatePolicy>always</updatePolicy>
        <checksumPolicy>warn</checksumPolicy>
      </snapshots>
    </repository>
  </repositories>

  <pluginRepositories>
    <pluginRepository>
      <id>ali</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </pluginRepository>
  </pluginRepositories>
</project>

为了外网项目方便复制，上面把 id, name, url 都改成阿里的，原文如下

        <repository>
          <id>company_or_app_name</id>
          <name>Nexus</name>
          <url>https://my.repository.com/repository/company_or_app_name/</url>
        </repository>