BOM全称是Bill Of Materials,译作材料清单。BOM本身并不是一种特殊的文件格式,而是一个普通的POM文件。只是在这个POM中,罗列出工程需要的所有依赖和其对应的版本。当其它工程引用BOM中罗列的jar包时,不用显示指定具体的版本,会自动使用BOM对应的jar版本。BOM的维护人员负责版本升级,并保证BOM中定义的jar包版本之间的兼容性。

工程基础父项目

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <parent>
  6. <groupId>org.springframework.boot</groupId>
  7. <artifactId>spring-boot-starter-parent</artifactId>
  8. <version>2.3.6.RELEASE</version>
  9. <relativePath/> <!-- lookup parent from repository -->
  10. </parent>
  11. <groupId>com.jyusun.origin</groupId>
  12. <artifactId>origin-parent</artifactId>
  13. <version>1.0.0-SNAPSHOT</version>
  14. <name>${project.artifactId}</name>
  15. <packaging>pom</packaging>
  16. <description>服务基础父项目</description>
  17. <!-- 许可信息 -->
  18. <licenses>
  19. <license>
  20. <name>The Apache Software License, Version 2.0</name>
  21. <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
  22. <comments>A business-friendly OSS license</comments>
  23. </license>
  24. </licenses>
  25. <!-- 开发者信息 -->
  26. <developers>
  27. <developer>
  28. <id>jyusun</id>
  29. <name>ayu</name>
  30. <email>jyusun@foxmail.com</email>
  31. </developer>
  32. </developers>
  33. <properties>
  34. <!-- JDK版本 -->
  35. <java.version>1.8</java.version>
  36. <maven.compiler.source>${java.version}</maven.compiler.source>
  37. <maven.compiler.target>${java.version}</maven.compiler.target>
  38. <!-- 基础编码字符集 -->
  39. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  40. <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  41. <charset.UTF8>UTF-8</charset.UTF8>
  42. <!-- Projects 版本配置 -->
  43. <origin.release.version>1.0.0.RELEASE</origin.release.version>
  44. <origin.development.version>1.0.0-SNAPSHOT</origin.development.version>
  45. <!-- Maven私服仓库地址 -->
  46. <releases.url>http://nexus.jyusun.com/repository/maven-releases/</releases.url>
  47. <snapshot.url>http://nexus.jyusun.com/repository/maven-snapshots/</snapshot.url>
  48. </properties>
  49. <!-- Nexus私服仓库部署配置 -->
  50. <distributionManagement>
  51. <repository>
  52. <id>nexus-releases</id>
  53. <url>${releases.url}</url>
  54. </repository>
  55. <snapshotRepository>
  56. <id>nexus-snapshots</id>
  57. <url>${snapshot.url}</url>
  58. </snapshotRepository>
  59. </distributionManagement>
  60. </project>

维护一些私服信息,字符集编码等

依赖管理BOM

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <parent>
  6. <groupId>com.jyusun.origin</groupId>
  7. <artifactId>origin-parent</artifactId>
  8. <version>1.0.0-SNAPSHOT</version>
  9. <relativePath/>
  10. </parent>
  11. <groupId>com.jyusun.origin</groupId>
  12. <artifactId>origin-dependencies</artifactId>
  13. <version>1.0.0-SNAPSHOT</version>
  14. <name>${project.artifactId}</name>
  15. <packaging>pom</packaging>
  16. <description>三方依赖管理</description>
  17. <properties>
  18. <!-- 工具版本管理 -->
  19. <lombok.version>1.18.10</lombok.version>
  20. <dubbo-serialization-kryo.version>2.6.8</dubbo-serialization-kryo.version>
  21. <fastjson.version>1.2.75</fastjson.version>
  22. <bitwalker.version>1.21</bitwalker.version>
  23. </properties>
  24. <dependencyManagement>
  25. <dependencies>
  26. <!-- caffeine guava-->
  27. <dependency>
  28. <groupId>com.github.ben-manes.caffeine</groupId>
  29. <artifactId>guava</artifactId>
  30. </dependency>
  31. <!-- lombok -->
  32. <dependency>
  33. <groupId>org.projectlombok</groupId>
  34. <artifactId>lombok</artifactId>
  35. <version>${lombok.version}</version>
  36. <scope>compile</scope>
  37. </dependency>
  38. <!-- Kryo 序列化 -->
  39. <dependency>
  40. <groupId>com.alibaba</groupId>
  41. <artifactId>dubbo-serialization-kryo</artifactId>
  42. <version>${dubbo-serialization-kryo.version}</version>
  43. </dependency>
  44. <!-- 用户代理 -->
  45. <dependency>
  46. <groupId>eu.bitwalker</groupId>
  47. <artifactId>UserAgentUtils</artifactId>
  48. <version>${bitwalker.version}</version>
  49. </dependency>
  50. <!-- 阿里巴巴FastJson-->
  51. <dependency>
  52. <groupId>com.alibaba</groupId>
  53. <artifactId>fastjson</artifactId>
  54. <version>${fastjson.version}</version>
  55. </dependency>
  56. </dependencies>
  57. </dependencyManagement>
  58. </project>

此pom文件只做依赖管理:

  • <packaging>pom</packaging>打包方式是pom文件
  • <dependencyManagement><dependencies>下定义的各种依赖的版本

工程父项目

origin-system-parent pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <parent>
  6. <groupId>com.jyusun.origin</groupId>
  7. <artifactId>origin-parent</artifactId>
  8. <version>1.0.0-SNAPSHOT</version>
  9. </parent>
  10. <artifactId>origin-system-parent</artifactId>
  11. <version>1.0.0-SNAPSHOT</version>
  12. <name>${project.artifactId}</name>
  13. <packaging>pom</packaging>
  14. <description>系统父项目</description>
  15. <properties>
  16. <!-- Spring Projects-->
  17. <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
  18. <spring-cloud-alibaba.version>2.2.3.RELEASE</spring-cloud-alibaba.version>
  19. </properties>
  20. <!-- Origin 依赖管理 -->
  21. <dependencyManagement>
  22. <dependencies>
  23. <!-- 三方依赖管理-->
  24. <dependency>
  25. <groupId>${project.groupId}</groupId>
  26. <artifactId>origin-dependencies</artifactId>
  27. <version>${origin-dependencies.version}</version>
  28. <type>pom</type>
  29. <scope>import</scope>
  30. </dependency>
  31. </dependencies>
  32. </dependencyManagement>
  33. </project>

此pom文件维护引用bom文件、maven插件等

示例工程引用

在工程中直接指向父项目,版本即可传递过来

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <parent>
  6. <groupId>com.jyusun.origin</groupId>
  7. <artifactId>origin-system-parent</artifactId>
  8. <version>1.0.0-SNAPSHOT</version>
  9. </parent>
  10. <artifactId>origin-commons-core</artifactId>
  11. <name>${project.artifactId}</name>
  12. <version>1.0.0-SNAPSHOT</version>
  13. <packaging>jar</packaging>
  14. <description>公共-核心工具</description>
  15. <dependencies>
  16. <!-- Lombok-->
  17. <dependency>
  18. <groupId>org.projectlombok</groupId>
  19. <artifactId>lombok</artifactId>
  20. </dependency>
  21. <!-- slf4j-api -->
  22. <dependency>
  23. <groupId>org.slf4j</groupId>
  24. <artifactId>slf4j-api</artifactId>
  25. </dependency>
  26. <!-- 用户代理信息处理 -->
  27. <dependency>
  28. <groupId>eu.bitwalker</groupId>
  29. <artifactId>UserAgentUtils</artifactId>
  30. </dependency>
  31. <!-- Alibaba fastjson -->
  32. <dependency>
  33. <groupId>com.alibaba</groupId>
  34. <artifactId>fastjson</artifactId>
  35. </dependency>
  36. <!-- caffeine guava-->
  37. <dependency>
  38. <groupId>com.github.ben-manes.caffeine</groupId>
  39. <artifactId>guava</artifactId>
  40. </dependency>
  41. <!-- Apache Lang 处理 -->
  42. <dependency>
  43. <groupId>org.apache.commons</groupId>
  44. <artifactId>commons-lang3</artifactId>
  45. </dependency>
  46. <!-- Apache Collections 处理 -->
  47. <dependency>
  48. <groupId>org.apache.commons</groupId>
  49. <artifactId>commons-collections4</artifactId>
  50. </dependency>
  51. <!-- 格式验证 -->
  52. <dependency>
  53. <groupId>io.swagger</groupId>
  54. <artifactId>swagger-annotations</artifactId>
  55. </dependency>
  56. <dependency>
  57. <groupId>org.hibernate.validator</groupId>
  58. <artifactId>hibernate-validator</artifactId>
  59. <scope>compile</scope>
  60. </dependency>
  61. <dependency>
  62. <groupId>javax.servlet</groupId>
  63. <artifactId>javax.servlet-api</artifactId>
  64. <scope>provided</scope>
  65. </dependency>
  66. </dependencies>
  67. </project>

示例工程引用

指定父项目,直接引用依赖的jar即可