我的书签
添加书签
移除书签6.4 远程仓库的配置
在很多情况下，默认的中央仓库无法满足项目的需求，可能项目需要的构件存在于另外一个远程仓库中，如JBoss Maven仓库。这时，可以在POM中配置该仓库，见代码清单6-2。
代码清单6-2 配置POM使用JBoss Maven仓库
＜project＞
……
＜repositories＞
＜repository＞
＜id＞jboss＜/id＞
＜name＞JBoss Repository＜/name＞
＜url＞http://repository.jboss.com/maven2/＜/url＞
＜releases＞
＜enabled＞true＜/enabled＞
＜/releases＞
＜snapshots＞
＜enabled＞false＜/enabled＞
＜/snapshots＞
＜layout＞default＜/layout＞
＜/repository＞
＜/repositories＞
……
＜/project＞
在repositories元素下，可以使用repository子元素声明一个或者多个远程仓库。该例中声明了一个id为jboss，名称为JBoss Repository的仓库。任何一个仓库声明的id必须是唯一的，尤其需要注意的是，Maven自带的中央仓库使用的id为central，如果其他的仓库声明也使用该id，就会覆盖中央仓库的配置。该配置中的url值指向了仓库的地址，一般来说，该地址都基于http协议，Maven用户都可以在浏览器中打开仓库地址浏览构件。
该例配置中的releases和snapshots元素比较重要，它们用来控制Maven对于发布版构件和快照版构件的下载。关于快照版本，在第6.5节中会详细解释。这里需要注意的是enabled子元素，该例中releases的enabled值为true，表示开启JBoss仓库的发布版本下载支持，而snapshots的enabled值为false，表示关闭JBoss仓库的快照版本的下载支持。因此，根据该配置，Maven只会从JBoss仓库下载发布版的构件，而不会下载快照版的构件。
该例中的layout元素值default表示仓库的布局是Maven 2及Maven 3的默认布局，而不是Maven 1的布局。
对于releases和snapshots来说，除了enabled，它们还包含另外两个子元素updatePolicy和checksumPolicy：
＜snapshots＞
＜enabled＞true＜/enabled＞
＜updatePolicy＞daily＜/updatePolicy＞
＜checksumPolicy＞ignore＜/checksumPolicy＞
＜/snapshots＞
元素updatePolicy用来配置Maven从远程仓库检查更新的频率，默认的值是daily，表示Maven每天检查一次。其他可用的值包括：never—从不检查更新；always—每次构建都检查更新；interval:X—每隔X分钟检查一次更新（X为任意整数）。
元素checksumPolicy用来配置Maven检查检验和文件的策略。当构件被部署到Maven仓库中时，会同时部署对应的校验和文件。在下载构件的时候，Maven会验证校验和文件，如果校验和验证失败，怎么办？当checksumPolicy的值为默认的warn时，Maven会在执行构建时输出警告信息，其他可用的值包括：fail—Maven遇到校验和错误就让构建失败；ignore—使Maven完全忽略校验和错误。
6.4.1 远程仓库的认证
大部分远程仓库无须认证就可以访问，但有时候出于安全方面的考虑，我们需要提供认证信息才能访问一些远程仓库。例如，组织内部有一个Maven仓库服务器，该服务器为每个项目都提供独立的Maven仓库，为了防止非法的仓库访问，管理员为每个仓库提供了一组用户名及密码。这时，为了能让Maven访问仓库内容，就需要配置认证信息。
配置认证信息和配置仓库信息不同，仓库信息可以直接配置在POM文件中，但是认证信息必须配置在settings.xml文件中。这是因为POM往往是被提交到代码仓库中供所有成员访问的，而settings.xml一般只放在本机。因此，在settings.xml中配置认证信息更为安全。
假设需要为一个id为my-proj的仓库配置认证信息，编辑settings.xml文件见代码清单6-3：
代码清单6-3 在settings.xml中配置仓库认证信息
＜settings＞
……
＜servers＞
＜server＞
＜id＞my-proj＜/id＞
＜username＞repo-user＜/username＞
＜password＞repo-pwd＜/password＞
＜/server＞
＜/servers＞
……
＜/settings＞
Maven使用settings.xml文件中并不显而易见的servers元素及其server子元素配置仓库认证信息。代码清单6-3中该仓库的认证用户名为repo-user，认证密码为repo-pwd。这里的关键是id元素，settings.xml中server元素的id必须与POM中需要认证的repository元素的id完全一致。换句话说，正是这个id将认证信息与仓库配置联系在了一起。
