Maven Getting Started - 配置Jboss仓库

由于工作需要，准备下载hibernate的新版本，项目构建工具用的是Maven，Hibernate官方发布的一些新版本都是存放在jboss仓库中，Maven中央仓库一般都没有很新的版本，所以要配置下远程仓库，一时间想不起配置的方法，用搜索引擎没找到比较好的文章，博客之类的，问题解决后还是记录下，方便以后查阅。

这个页面提供信息为JBoss社区用户开始使用JBoss.org Maven存储库。

如果你是刚使用Maven,你可以先去Apache Maven网站(http://maven.apache.org/)学习基础知识。如果你已经熟悉Maven,想学习如何在项目中使用JBoss Maven存储库和下载JBoss工件,那么你是在正确的地方。

 

1.使用Jboss工件

“public-jboss”存储库提供了一个组合视图的JBoss社区项目工件(除了少数例外)。

http://repository.jboss.org/nexus/content/groups/public-jboss/

这个仓库地址可以添加到你的Maven settings.xml文件,或者你的POM中让你的项目允许使用JBoss工件。如果你需要更多的细粒度访问JBoss的工件,例如只需要releases版本，不需要snapshots版本，你可以在版本库中直接使用这个URL。

https://repository.jboss.org/nexus/content/repositories/releases/

在这个wiki页面中Maven Repository提供了关于repository.jboss.org 中每个有效的仓库详细信息。

 

2.使用仓库的网站界面

web界面的地址是https://repository.jboss.org/nexus,提供给所有用户。web界面显示所有可用的存储库及其相关的url。这个界面还可以在存储库中搜索和定位工件。

 

3.配置Maven使用JBoss库

这个库有一个仓库组的URL,可以用于从多个存储库下载工件。

http://repository.jboss.org/nexus/content/groups/public-jboss/

要想从jboss.org库使用依赖，需要把这个URL添加到你的Maven settings配置中。Maven包含一个默认settings.xml文件，一个位于$ MAVEN_HOME / conf /settings.xml另一个位于$HOME/.m2/settings.xml(more about Maven settings)。建议你不要修改默认的Maven设置文件。相反,你应该复制默认settings.xml文件到你的.m2目录，来修改这个新的文件。一个完整的示例(Maven Settings Example - Users)。以下代码片段(或类似的)应该被包括在用户settings.xml中去使用JBoss库。

<settings>  
  ...  
  <profiles>  
    ...  
    <profile>  
      <id>jboss-public-repository</id>  
      <repositories>  
        <repository>  
          <id>jboss-public-repository-group</id>  
          <name>JBoss Public Maven Repository Group</name>  
          <url>https://repository.jboss.org/nexus/content/groups/public-jboss/</url>  
          <layout>default</layout>  
          <releases>  
            <enabled>true</enabled>  
            <updatePolicy>never</updatePolicy>  
          </releases>  
          <snapshots>  
            <enabled>true</enabled>  
            <updatePolicy>never</updatePolicy>  
          </snapshots>  
        </repository>  
      </repositories>  
      <pluginRepositories>  
        <pluginRepository>  
          <id>jboss-public-repository-group</id>  
          <name>JBoss Public Maven Repository Group</name>  
          <url>https://repository.jboss.org/nexus/content/groups/public-jboss/</url>  
          <layout>default</layout>  
          <releases>  
            <enabled>true</enabled>  
            <updatePolicy>never</updatePolicy>  
          </releases>  
          <snapshots>  
            <enabled>true</enabled>  
            <updatePolicy>never</updatePolicy>  
          </snapshots>  
        </pluginRepository>  
      </pluginRepositories>  
    </profile>  
  
  </profiles>  
  
  <activeProfiles>  
    <activeProfile>jboss-public-repository</activeProfile>  
  </activeProfiles>  
  ...  
</settings>  

将JBoss库添加到默认profiles他们将活跃在你的工程中。只要这个profile被激活时,你的Maven工程可以从JBoss下载依赖库。如果你想关闭这个profile为一个特定的工程(避免使用JBoss存储库),可以使用标准的Maven命令行语法profile才会安静下来。

mvn -Pjboss-public-repository install

详细描述Maven中的可用选项设置,看这Maven settings reference。

 

4.Using Deprecated Dependencies使用不赞成的依赖

JBoss Maven存储库在2010年4月重组提供一个更清洁更有组织存储库。因此,许多工件已经转移到一个弃用Maven存储库并且再也不应该被使用。如果您的工程需要这些依赖,只能在弃用存储库中找到,你应该通知项目团队。要使用废弃的构件,只需添加一个额外的配置文件设置。

   <profile>  
      <id>jboss-deprecated-repository</id>  
      <repositories>  
        <repository>  
          <id>jboss-deprecated-repository</id>  
          <name>JBoss Deprecated Maven Repository</name>  
          <url>https://repository.jboss.org/nexus/content/repositories/deprecated/</url>  
          <layout>default</layout>  
          <releases>  
            <enabled>true</enabled>  
            <updatePolicy>never</updatePolicy>  
          </releases>  
          <snapshots>  
            <enabled>false</enabled>  
            <updatePolicy>never</updatePolicy>  
          </snapshots>  
        </repository>  
      </repositories>  
    </profile>

5.使用JBoss Maven插件

一些JBoss项目包括Maven插件。可选地,你可以在settings.xml添加配置，允许Maven使用jboss插件。

  <pluginGroups>  
    <!-- pluginGroup  
     | Specifies a further group identifier to use for plugin lookup.  
     | -->  
    <pluginGroup>org.jboss.maven.plugins</pluginGroup>  
  </pluginGroups>

6.例子

 一个完整并且有效的关于settings.xml 的例子 ( Maven Settings Example - Users )。