Version 4

    This page describes guidelines for using the jboss repository located at:

    http://repository.jboss.com

     

    Basic Hierarchy

    -


    The repository is structured into directories for each release version of each project that is either a jboss project or a dependency of a jboss project.  The basic structure looks like:

    /[project-group]/<project>/<version>
    

     

    For example, the version 1.0.2 of the jboss microcontainer project is located under

     

    /jboss/microcontainer/1.0.2/

     

    And apache ant version 1.6.5 is located at

     

    /apache-ant/1.6.5/

     

    Each project version folder should contain a file called component-info.xml that contains information about the project.

    Each folder should also contain a "lib" directory which contains two jar files one for the classes, and one for the project source.

     

    So the project folder looks like this

    /component-info.xml
    /lib/project.jar
    /lib/project-src.jar
    /src/project-<version>-src.tar.gz
    

     

     

    Adding third party jars to the repository

    -


    When a jboss project has a dependency on a third party jar file, for example apache-commons, the binary and source jars for the dependency should be added to the jboss repository.  So for apache ant version 1.6.5 the directory structure should look like this:

     

    /component-info.xml
    /lib/apache-ant.jar
    /lib/apache-ant-src.jar
    /src/apache-ant-1.6.5-src.tar.gz
    

     

     

     

     

    Creating patch versions of third party jars

    -


    If third party source needs to be modified before being distributed with the jboss binaries, a new project version folder should be created.  For example a modified version of the apache-log4j version 1.2.14 project would be in a new folder called

     /apache-log4j/1.2.14-patch01 

    The contents of this folder should look like this:

    /component-info.xml
    /lib/apache-log4j.jar
    /lib/apache-log4j-src.jar
    /src/patchfiles.patch
    /src/apache-log4j-1.2.14-src.tar.gz
    

     

    The jar file in the lib directory apache-log4j-src.jar would contain the modified source code of the project.

     

    The file apache-log4j-1.2.14-src.tar.gz contains the original source code, and the patchfiles.patch would be the required patches that could be used to change the original source into the modified source code.