[Index]

oddballs

Create Oddjob job definition descriptors from any number of directories that follow the Oddball format.

The Oddball directory structure is:

 myball
   classes
     com
       acme
         MyStuff.class
   lib
     someutil.jar

You can have either a lib or classes or both but you must have something.

Additionally there can be as many META-INF/arooa.xml resources on that confirm to the arooa:descriptor format for defining element mappings and conversions.

Property Summary

files	The Oddball directory or directories.
oddballFactory	The factory that will create the Oddball from the file specification.

Example Summary

Example 1

Loading two Oddballs.

Property Detail

files

Configured By	ELEMENT
Access	READ_WRITE
Required	Yes.

The Oddball directory or directories.

oddballFactory

Configured By	ELEMENT
Access	READ_WRITE
Required	No. Defaults to a directory loading factory.

The factory that will create the Oddball from the file specification. At the moment this defaults to the only implementation which is to load an Oddball from a directory. In future it is hoped to support loading Oddballs from archives. Following the existing java naming convention for archives they will probably be called .oar files.

Examples

Example 1

Loading two Oddballs.

<oddjob id="this">
    <job>
        <oddjob file="${this.args[0]}/test/launch/oddballs-launch.xml">
            <descriptorFactory>
                <oddballs>
                    <files>
                        <files>
                            <list>
                                <file file="${this.args[0]}/test/oddballs/apple"/>
                                <file file="${this.args[0]}/test/oddballs/orange"/>
                            </list>
                        </files>
                    </files>
                </oddballs>
            </descriptorFactory>
        </oddjob>
    </job>
</oddjob>

This is equivalent to launching Oddjob with the oddball path option set as in:

 java -jar run-oddjob.jar \
      -op test/oddballs/apple:test/oddballs/orange \
      -f test/launch/oddballs-launch.xml

Or if the test/oddballs directory only contains these two directories, then using the oddball directory option:

 java -jar run-oddjob.jar \
      -ob test/oddballs \
      -f test/launch/oddballs-launch.xml

If the apple and orange directories were copied to Oddjob's Oddballs directory they would be loaded by default.