This page describes guidelines for using the jboss repository located at:
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.
Comments