Apache Maven Settings 模型解析从 settings.xml 到不可变 API 与 Settings Builder【免费下载链接】mavenApache Maven core项目地址: https://gitcode.com/GitHub_Trending/ma/maven本文以 Apache Maven 4 仓库中的 Maven Settings Modelorg.apache.maven.settings包为核心讲解 Maven 用户级配置~/.m2/settings.xml的模型定义、生成产物与有效配置构建流程。读者将理解 settings 模型在经典兼容层与 Maven 4 不可变 API 之间的委托关系掌握settings.xml中代理、镜像、服务器、Profile 等核心配置项的字段语义与默认值并了解这些配置从 XML 解析到有效模型构建的完整链路。什么是 Maven Settings 模型Maven 的构建行为除了由项目内的pom.xml驱动外还受用户级配置影响。这些不应随pom.xml分发的配置——例如开发者身份、本地仓库位置、代理信息、远程仓库镜像、服务器认证凭据等——统一放在settings 模型中描述其默认配置文件位置为~/.m2/settings.xml。在 Maven 4 代码库中这一模型被拆分为两层经典兼容模型位于 compat/maven-settings 模块包名org.apache.maven.settings是 Maven 3 时代的可变 Java 模型用于兼容旧代码Maven 4 不可变 API 模型位于 api/maven-api-settings 模块包名org.apache.maven.api.settings是严格不可变的现代 API。正如经典模型文档 compat/maven-settings/src/site/markdown/index.md 所述This is the model for Maven settings inorg.apache.maven.settingspackage, delegating content to Maven 4 API immutable settings。也就是说经典兼容模型本身并不重复持有全部配置语义而是将内容委托delegating给 Maven 4 API 的不可变 settings 模型经典类内部持有一个不可变模型的实例作为delegate。这一委托在 BaseObject.java 中体现得十分直接每个经典对象都通过getDelegate()暴露底层不可变对象并通过update(newDelegate)在子节点变更时向上追踪替换ChildrenTracking回调从而保证父子视图一致。模型的权威定义settings.mdo与 Maven 的其他模型一样Settings 模型的权威定义是一份ModelloMDO模型描述文件api/maven-api-settings/src/main/mdo/settings.mdo。它同时驱动不可变 API 模型与经典兼容模型的代码生成其自述定位是user-specific configuration for Maven即那些不应与pom.xml一起分发、以及诸如代理信息之类的本地化设置。MDO 文件中的defaults指定生成代码的包名org.apache.maven.settings并声明了 XML 命名空间与 schema locationhttp://maven.apache.org/SETTINGS/${version}这意味着模型本身也是 XSDsettings-2.x.xsd的生成来源——原文档中提到的 XSD 即由此模型驱动产出。顶层settings元素字段根元素Settingsxml.tagNamesettings继承自TrackableBase后者为每个实例记录来源级别。从源码片段看TrackableBase定义了三个来源级别常量USER_LEVEL用户级、PROJECT_LEVEL项目级、GLOBAL_LEVEL全局级且setSourceLevel只允许设置一次重复设置会抛出IllegalStateException非法值则抛出IllegalArgumentException见 settings.mdo。这为后续多个 settings 文件合并后知道每一项来自哪里提供了基础。顶层Settings的完整字段如下字段名、语义与默认值均来自 settings.mdo字段类型默认值/必填说明localRepositoryString${user.home}/.m2/repository必填本地仓库路径interactiveModebooleantrueMaven 是否尝试与用户交互以获取输入usePluginRegistrybooleanfalse是否使用plugin-registry.xml管理插件版本offlinebooleanfalse是否全程以离线模式运行proxiesProxy[]—不同代理 Profile 的配置便于移动设备上按 id 切换整套代理serversServer[]—按服务器 id 配置的认证等服务器专属设置mirrorsMirror[]—仓库下载镜像的配置repositoriesRepository[]1.3.0—远程仓库列表pluginRepositoriesRepository[]1.3.0—用于发现插件的远程仓库列表profilesProfile[]—根据环境参数调整构建的 ProfileactiveProfilesString[]—手动激活的 Profile 列表按应用顺序排列pluginGroupsString[]—插件未显式给出 groupId 时按顺序搜索的 groupId 列表此外模型为Settings生成了若干便捷方法见 settings.mdogetActiveProxy()返回第一个active为真的代理缓存于activeProxy字段可用flushActiveProxy()重置getServer(String serverId)按 id 查找服务器getProfilesAsMap()以LinkedHashMap按声明顺序建立 Profile 索引getMirrorOf(String repositoryId)因不支持高级镜像匹配语法已被标记Deprecated官方建议改用 Maven 镜像匹配基础设施。子类型模型IdentifiableBaseMirror、Profile、Proxy、Server的共同基类提供id字段默认值为default必填。Proxy字段含active语义为 boolean技术类型为 String默认true、protocol默认http、username、password、port语义为 int默认8080、host必填、nonProxyHosts用|分隔的免代理主机列表。模型生成的isActive()与getPort()会惰性解析 String 字段并给出上述默认值。Serverusername、password、privateKey私钥位置、passphrase与私钥配合的口令、filePermissions、directoryPermissions文件/目录创建时的权限、configuration传输层额外配置DOM 类型、aliases1.3.0为同一凭据复用到多个服务器提供别名每个别名生成同配置、仅 id 不同的额外 server 条目。MirrormirrorOf必填仓库 id 或匹配表达式如central、*,!repo1*、external:*与自 Maven 3.8.0 起的external:http:*有特殊含义、name可选描述名、url必填镜像仓库 URL、layout默认default、mirrorOfLayouts默认default,legacy限定被镜像仓库的布局、blocked自 Maven 3.8.0 起为true时拒绝所有下载请求并说明原因。Profileactivation自动触发 Profile 的条件逻辑、propertiesproperty.nameproperty.value/property.name形式的扩展配置、repositories、pluginRepositories。ActivationactiveByDefault是否默认激活、jdk检测到匹配 JDK 时激活、os、property、file、packaging1.2.0按项目打包类型激活、condition2.0.0需满足的激活条件。Repository / RepositoryBasename、url、layoutlegacy或default默认default、releases、snapshots均为RepositoryPolicy。其equals以 id 为唯一判定依据源码注释特别说明这是有意防止 Modello 生成错误的 equals 方法。RepositoryPolicyenabled默认true、updatePolicyalways、daily默认、interval:XXX分钟或never、checksumPolicy校验失败处理Maven 4 及以上默认fail、Maven 3 默认warn、可设为ignore。ActivationPropertyname必填、value值为空时仅凭属性存在即激活否则做区分大小写的值匹配。ActivationOSname、family如windows、arch、version。ActivationFilemissing/exists——前者要求文件缺失才激活后者要求文件存在才激活二者不可同时使用。模型生成的 Java 产物原文档指出从该模型生成的内容包括Java sourcesXpp3 XML 解析器的 Reader/Writer即org.apache.maven.settings.io.xpp3包下的 SettingsXpp3Reader.java 与 SettingsXpp3Writer.java。值得一提的是SettingsXpp3Reader虽保留了 Maven 3 的 Xpp3 门面 API含ContentTransformer插值回调接口但其内部实现已经委托给v4包生成的SettingsStaxReader——即基于 StAX 的 v4 Reader——并注明推荐使用org.apache.maven.api.services.xml.SettingsXmlFactory位于 maven-api-core或SettingsStaxReader经典 Xpp3 Reader 被标记为DeprecatedMaven 3 兼容用途。ToApiV3()与ToApiV4()转换器由模型生成的模型转换器负责在经典可变模型与不同 API 版本模型之间互转是兼容层与 API 层协作的桥梁。v4包包含 Merger 以及 v4 的 Xpp3 Reader/Writer用于新的不可变模型上的合并与读写。Descriptor Reference即 api/maven-api-settings 模块对应的模型描述文档其源头同样是 settings.mdo。XSD由模型生成的settings-2.x.xsdschemaschema location 在 MDO 头部声明。不可变 API 一侧的用法可通过测试用例直观验证SettingsTest.java 展示了Settings.newInstance()创建实例、withLocalRepository(...)以with 风格返回新实例不可变、getLocalRepository()读取字段的完整用法包括置空为null的场景。有效 Settings 的构建Maven Settings Builder多个 settings 文件全局级、用户级甚至项目级如何合并成一份有效配置原文档明确说明All the effective model building logic from multiple settings files is done in Maven Settings Builder即 compat/maven-settings-builder 模块。其核心接口 SettingsBuilder.java已标记Deprecated(since 4.0.0)官方建议改用org.apache.maven.api.services.SettingsBuilder定义SettingsBuildingResult build(SettingsBuildingRequest request) throws SettingsBuildingException;从 DefaultSettingsBuilder.java 的实现可以看到构建流程的关键步骤读取全局与用户 settings 源分别从request.getGlobalSettingsFile()或getGlobalSettingsSource()与request.getUserSettingsFile()或getUserSettingsSource()读取问题统一收集到DefaultSettingsProblemCollector合并调用settingsMerger.merge(userSettings, globalSettings, TrackableBase.GLOBAL_LEVEL)将全局设置以GLOBAL_LEVEL来源级别并入用户设置插值使用 PlexusRegexBasedInterpolator结合PropertiesBasedValueSource与EnvarBasedValueSource对合并结果进行${...}属性与环境变量插值路径规整对 Windows 盘符相对路径等特殊情况若本地仓库路径非绝对且以路径分隔符开头则转换为绝对路径避免给插件带来麻烦错误处理若收集到错误级别的问题抛出SettingsBuildingException。该模块还包含一组配套基础设施SettingsReader/SettingsWriter含DefaultSettingsReader/DefaultSettingsWriter与SettingsParseException、MavenSettingsMerger、DefaultSettingsValidator负责校验、以及crypto包下的SettingsDecrypterDefaultSettingsDecrypter、MavenSecDispatcher等——后者对应官方文档中的Security and Deployment Settings与Password Encryption主题即settings.xml中密码等敏感字段的加密与解密处理。此外building包还提供FileSettingsSource、UrlSettingsSource、StringSettingsSource三种设置来源支持从文件、URL 与内存字符串构建。而默认的用户配置文件路径定义在 RuntimeInfo.java已弃用DEFAULT_USER_SETTINGS_FILE ~/.m2/settings.xml即user.home下.m2目录中的settings.xml。实战默认 settings.xml 模板中的典型配置Maven 发行版自带一份带注释的完整 settings 模板apache-maven/src/assembly/maven/conf/settings.xml。它是理解各模型字段落地形式的绝佳参考以下摘取几处典型配置并对照模型字段说明。本地仓库与插件组默认模板中localRepository被注释掉使用模型默认值${user.home}/.m2/repositorypluginGroups给出插件缺省 groupId 的搜索顺序模板示例pluginGroups pluginGrouporg.mortbay.jetty/pluginGroup /pluginGroups镜像Mirror模板注释指出镜像的mirrorOf匹配的是被镜像仓库的 id并给出external:http:*这类高级匹配示例与Mirror.mirrorOf字段语义完全对应mirror idmirrorId/id mirrorOfrepositoryId/mirrorOf nameHuman Readable Name for this Mirror./name urlhttp://my.repository.com/repo/path/url /mirror服务器Server模板提醒远程仓库的认证信息不应写在 pom 中而是放在 settings 的server里按 id 匹配例如deploymentReposerver iddeploymentRepo/id usernamerepouser/username passwordrepopwd/password /serverProfile 与 activeProfiles模板注释说明了 Profile 的多种激活方式JDK、OS、属性、文件存在性等以及用activeProfiles手动激活并指定应用顺序activeProfiles activeProfilealwaysActiveProfile/activeProfile activeProfileanotherAlwaysActiveProfile/activeProfile /activeProfiles代理Proxyproxy元素需设置active模型默认true、protocol默认http、host必填、port默认8080、username/password可选以及用|分隔的nonProxyHosts例如localhost|127.0.0.1。这正是原文档Configuring a proxy主题对应的模型实现。延伸阅读指引围绕 Settings 模型仓库中还提供以下可继续深入的材料不可变 API 模型的自述文档api/maven-api-settings/src/site/markdown/index.md说明其仅承载org.apache.maven.api.settings包中的严格不可变模型并生成了带 Builder 内部类的 Java 源码模型合并与校验实现MavenSettingsMerger.java 与 DefaultSettingsValidator.java密码加密与安全部署支持crypto 包 下的DefaultSettingsDecrypter、MavenSecDispatcher等默认配置模板apache-maven/src/assembly/maven/conf/settings.xml。小结Maven Settings 模型是连接settings.xml与 Maven 运行时的核心数据契约它以 settings.mdo 为单一事实来源生成不可变的 Maven 4 API 模型、经典兼容模型、Xpp3/StAX 读写器、模型转换器与 XSD经典兼容层通过delegate机制委托给不可变模型保证新旧 API 视图一致而多文件的有效配置合并、插值、校验与解密则统一由 Maven Settings Buildercompat/maven-settings-builder完成。掌握这一模型就能准确理解~/.m2/settings.xml中每一个配置项的语义、默认值与生效机制。【免费下载链接】mavenApache Maven core项目地址: https://gitcode.com/GitHub_Trending/ma/maven创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Apache Maven Settings 模型解析：从 settings.xml 到不可变 API 与 Settings Builder
Apache Maven Settings 模型解析从 settings.xml 到不可变 API 与 Settings Builder【免费下载链接】mavenApache Maven core项目地址: https://gitcode.com/GitHub_Trending/ma/maven本文以 Apache Maven 4 仓库中的 Maven Settings Modelorg.apache.maven.settings包为核心讲解 Maven 用户级配置~/.m2/settings.xml的模型定义、生成产物与有效配置构建流程。读者将理解 settings 模型在经典兼容层与 Maven 4 不可变 API 之间的委托关系掌握settings.xml中代理、镜像、服务器、Profile 等核心配置项的字段语义与默认值并了解这些配置从 XML 解析到有效模型构建的完整链路。什么是 Maven Settings 模型Maven 的构建行为除了由项目内的pom.xml驱动外还受用户级配置影响。这些不应随pom.xml分发的配置——例如开发者身份、本地仓库位置、代理信息、远程仓库镜像、服务器认证凭据等——统一放在settings 模型中描述其默认配置文件位置为~/.m2/settings.xml。在 Maven 4 代码库中这一模型被拆分为两层经典兼容模型位于 compat/maven-settings 模块包名org.apache.maven.settings是 Maven 3 时代的可变 Java 模型用于兼容旧代码Maven 4 不可变 API 模型位于 api/maven-api-settings 模块包名org.apache.maven.api.settings是严格不可变的现代 API。正如经典模型文档 compat/maven-settings/src/site/markdown/index.md 所述This is the model for Maven settings inorg.apache.maven.settingspackage, delegating content to Maven 4 API immutable settings。也就是说经典兼容模型本身并不重复持有全部配置语义而是将内容委托delegating给 Maven 4 API 的不可变 settings 模型经典类内部持有一个不可变模型的实例作为delegate。这一委托在 BaseObject.java 中体现得十分直接每个经典对象都通过getDelegate()暴露底层不可变对象并通过update(newDelegate)在子节点变更时向上追踪替换ChildrenTracking回调从而保证父子视图一致。模型的权威定义settings.mdo与 Maven 的其他模型一样Settings 模型的权威定义是一份ModelloMDO模型描述文件api/maven-api-settings/src/main/mdo/settings.mdo。它同时驱动不可变 API 模型与经典兼容模型的代码生成其自述定位是user-specific configuration for Maven即那些不应与pom.xml一起分发、以及诸如代理信息之类的本地化设置。MDO 文件中的defaults指定生成代码的包名org.apache.maven.settings并声明了 XML 命名空间与 schema locationhttp://maven.apache.org/SETTINGS/${version}这意味着模型本身也是 XSDsettings-2.x.xsd的生成来源——原文档中提到的 XSD 即由此模型驱动产出。顶层settings元素字段根元素Settingsxml.tagNamesettings继承自TrackableBase后者为每个实例记录来源级别。从源码片段看TrackableBase定义了三个来源级别常量USER_LEVEL用户级、PROJECT_LEVEL项目级、GLOBAL_LEVEL全局级且setSourceLevel只允许设置一次重复设置会抛出IllegalStateException非法值则抛出IllegalArgumentException见 settings.mdo。这为后续多个 settings 文件合并后知道每一项来自哪里提供了基础。顶层Settings的完整字段如下字段名、语义与默认值均来自 settings.mdo字段类型默认值/必填说明localRepositoryString${user.home}/.m2/repository必填本地仓库路径interactiveModebooleantrueMaven 是否尝试与用户交互以获取输入usePluginRegistrybooleanfalse是否使用plugin-registry.xml管理插件版本offlinebooleanfalse是否全程以离线模式运行proxiesProxy[]—不同代理 Profile 的配置便于移动设备上按 id 切换整套代理serversServer[]—按服务器 id 配置的认证等服务器专属设置mirrorsMirror[]—仓库下载镜像的配置repositoriesRepository[]1.3.0—远程仓库列表pluginRepositoriesRepository[]1.3.0—用于发现插件的远程仓库列表profilesProfile[]—根据环境参数调整构建的 ProfileactiveProfilesString[]—手动激活的 Profile 列表按应用顺序排列pluginGroupsString[]—插件未显式给出 groupId 时按顺序搜索的 groupId 列表此外模型为Settings生成了若干便捷方法见 settings.mdogetActiveProxy()返回第一个active为真的代理缓存于activeProxy字段可用flushActiveProxy()重置getServer(String serverId)按 id 查找服务器getProfilesAsMap()以LinkedHashMap按声明顺序建立 Profile 索引getMirrorOf(String repositoryId)因不支持高级镜像匹配语法已被标记Deprecated官方建议改用 Maven 镜像匹配基础设施。子类型模型IdentifiableBaseMirror、Profile、Proxy、Server的共同基类提供id字段默认值为default必填。Proxy字段含active语义为 boolean技术类型为 String默认true、protocol默认http、username、password、port语义为 int默认8080、host必填、nonProxyHosts用|分隔的免代理主机列表。模型生成的isActive()与getPort()会惰性解析 String 字段并给出上述默认值。Serverusername、password、privateKey私钥位置、passphrase与私钥配合的口令、filePermissions、directoryPermissions文件/目录创建时的权限、configuration传输层额外配置DOM 类型、aliases1.3.0为同一凭据复用到多个服务器提供别名每个别名生成同配置、仅 id 不同的额外 server 条目。MirrormirrorOf必填仓库 id 或匹配表达式如central、*,!repo1*、external:*与自 Maven 3.8.0 起的external:http:*有特殊含义、name可选描述名、url必填镜像仓库 URL、layout默认default、mirrorOfLayouts默认default,legacy限定被镜像仓库的布局、blocked自 Maven 3.8.0 起为true时拒绝所有下载请求并说明原因。Profileactivation自动触发 Profile 的条件逻辑、propertiesproperty.nameproperty.value/property.name形式的扩展配置、repositories、pluginRepositories。ActivationactiveByDefault是否默认激活、jdk检测到匹配 JDK 时激活、os、property、file、packaging1.2.0按项目打包类型激活、condition2.0.0需满足的激活条件。Repository / RepositoryBasename、url、layoutlegacy或default默认default、releases、snapshots均为RepositoryPolicy。其equals以 id 为唯一判定依据源码注释特别说明这是有意防止 Modello 生成错误的 equals 方法。RepositoryPolicyenabled默认true、updatePolicyalways、daily默认、interval:XXX分钟或never、checksumPolicy校验失败处理Maven 4 及以上默认fail、Maven 3 默认warn、可设为ignore。ActivationPropertyname必填、value值为空时仅凭属性存在即激活否则做区分大小写的值匹配。ActivationOSname、family如windows、arch、version。ActivationFilemissing/exists——前者要求文件缺失才激活后者要求文件存在才激活二者不可同时使用。模型生成的 Java 产物原文档指出从该模型生成的内容包括Java sourcesXpp3 XML 解析器的 Reader/Writer即org.apache.maven.settings.io.xpp3包下的 SettingsXpp3Reader.java 与 SettingsXpp3Writer.java。值得一提的是SettingsXpp3Reader虽保留了 Maven 3 的 Xpp3 门面 API含ContentTransformer插值回调接口但其内部实现已经委托给v4包生成的SettingsStaxReader——即基于 StAX 的 v4 Reader——并注明推荐使用org.apache.maven.api.services.xml.SettingsXmlFactory位于 maven-api-core或SettingsStaxReader经典 Xpp3 Reader 被标记为DeprecatedMaven 3 兼容用途。ToApiV3()与ToApiV4()转换器由模型生成的模型转换器负责在经典可变模型与不同 API 版本模型之间互转是兼容层与 API 层协作的桥梁。v4包包含 Merger 以及 v4 的 Xpp3 Reader/Writer用于新的不可变模型上的合并与读写。Descriptor Reference即 api/maven-api-settings 模块对应的模型描述文档其源头同样是 settings.mdo。XSD由模型生成的settings-2.x.xsdschemaschema location 在 MDO 头部声明。不可变 API 一侧的用法可通过测试用例直观验证SettingsTest.java 展示了Settings.newInstance()创建实例、withLocalRepository(...)以with 风格返回新实例不可变、getLocalRepository()读取字段的完整用法包括置空为null的场景。有效 Settings 的构建Maven Settings Builder多个 settings 文件全局级、用户级甚至项目级如何合并成一份有效配置原文档明确说明All the effective model building logic from multiple settings files is done in Maven Settings Builder即 compat/maven-settings-builder 模块。其核心接口 SettingsBuilder.java已标记Deprecated(since 4.0.0)官方建议改用org.apache.maven.api.services.SettingsBuilder定义SettingsBuildingResult build(SettingsBuildingRequest request) throws SettingsBuildingException;从 DefaultSettingsBuilder.java 的实现可以看到构建流程的关键步骤读取全局与用户 settings 源分别从request.getGlobalSettingsFile()或getGlobalSettingsSource()与request.getUserSettingsFile()或getUserSettingsSource()读取问题统一收集到DefaultSettingsProblemCollector合并调用settingsMerger.merge(userSettings, globalSettings, TrackableBase.GLOBAL_LEVEL)将全局设置以GLOBAL_LEVEL来源级别并入用户设置插值使用 PlexusRegexBasedInterpolator结合PropertiesBasedValueSource与EnvarBasedValueSource对合并结果进行${...}属性与环境变量插值路径规整对 Windows 盘符相对路径等特殊情况若本地仓库路径非绝对且以路径分隔符开头则转换为绝对路径避免给插件带来麻烦错误处理若收集到错误级别的问题抛出SettingsBuildingException。该模块还包含一组配套基础设施SettingsReader/SettingsWriter含DefaultSettingsReader/DefaultSettingsWriter与SettingsParseException、MavenSettingsMerger、DefaultSettingsValidator负责校验、以及crypto包下的SettingsDecrypterDefaultSettingsDecrypter、MavenSecDispatcher等——后者对应官方文档中的Security and Deployment Settings与Password Encryption主题即settings.xml中密码等敏感字段的加密与解密处理。此外building包还提供FileSettingsSource、UrlSettingsSource、StringSettingsSource三种设置来源支持从文件、URL 与内存字符串构建。而默认的用户配置文件路径定义在 RuntimeInfo.java已弃用DEFAULT_USER_SETTINGS_FILE ~/.m2/settings.xml即user.home下.m2目录中的settings.xml。实战默认 settings.xml 模板中的典型配置Maven 发行版自带一份带注释的完整 settings 模板apache-maven/src/assembly/maven/conf/settings.xml。它是理解各模型字段落地形式的绝佳参考以下摘取几处典型配置并对照模型字段说明。本地仓库与插件组默认模板中localRepository被注释掉使用模型默认值${user.home}/.m2/repositorypluginGroups给出插件缺省 groupId 的搜索顺序模板示例pluginGroups pluginGrouporg.mortbay.jetty/pluginGroup /pluginGroups镜像Mirror模板注释指出镜像的mirrorOf匹配的是被镜像仓库的 id并给出external:http:*这类高级匹配示例与Mirror.mirrorOf字段语义完全对应mirror idmirrorId/id mirrorOfrepositoryId/mirrorOf nameHuman Readable Name for this Mirror./name urlhttp://my.repository.com/repo/path/url /mirror服务器Server模板提醒远程仓库的认证信息不应写在 pom 中而是放在 settings 的server里按 id 匹配例如deploymentReposerver iddeploymentRepo/id usernamerepouser/username passwordrepopwd/password /serverProfile 与 activeProfiles模板注释说明了 Profile 的多种激活方式JDK、OS、属性、文件存在性等以及用activeProfiles手动激活并指定应用顺序activeProfiles activeProfilealwaysActiveProfile/activeProfile activeProfileanotherAlwaysActiveProfile/activeProfile /activeProfiles代理Proxyproxy元素需设置active模型默认true、protocol默认http、host必填、port默认8080、username/password可选以及用|分隔的nonProxyHosts例如localhost|127.0.0.1。这正是原文档Configuring a proxy主题对应的模型实现。延伸阅读指引围绕 Settings 模型仓库中还提供以下可继续深入的材料不可变 API 模型的自述文档api/maven-api-settings/src/site/markdown/index.md说明其仅承载org.apache.maven.api.settings包中的严格不可变模型并生成了带 Builder 内部类的 Java 源码模型合并与校验实现MavenSettingsMerger.java 与 DefaultSettingsValidator.java密码加密与安全部署支持crypto 包 下的DefaultSettingsDecrypter、MavenSecDispatcher等默认配置模板apache-maven/src/assembly/maven/conf/settings.xml。小结Maven Settings 模型是连接settings.xml与 Maven 运行时的核心数据契约它以 settings.mdo 为单一事实来源生成不可变的 Maven 4 API 模型、经典兼容模型、Xpp3/StAX 读写器、模型转换器与 XSD经典兼容层通过delegate机制委托给不可变模型保证新旧 API 视图一致而多文件的有效配置合并、插值、校验与解密则统一由 Maven Settings Buildercompat/maven-settings-builder完成。掌握这一模型就能准确理解~/.m2/settings.xml中每一个配置项的语义、默认值与生效机制。【免费下载链接】mavenApache Maven core项目地址: https://gitcode.com/GitHub_Trending/ma/maven创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考