Java development (testing really):
==================================
This maven package is set up as the location for DataONE common test resources to be made
available for unit and integration tests.  It will be listed as a dependency of d1_common_java,
for transparent incorporation to java developers using the d1_*_java packages. (d1_common_java is
a dependency of most, if not all so far. See d1_common_java pom.xml dependency section otherwise.)

Java Resources
--------------
It is meant that callers would use this.getClass().getResourceAsStream("relative/path/to/resource") 
to access the resources, and that resources will be appropriately organized in subdirectories
according to usage and perhaps type.

Special rules apply to getResourceAsStream() for accessing files, so for example,
to access the file:
    d1_test_resources/src/main/resources/D1shared/selfTest/simpleDummyResource.txt
 
one would invoke the method thusly:
    this.getClass().getResourceAsStream("D1shared/selfTest/simpleDummyResource.txt");
    
    
Java Classes
------------
Classes may be added in order to supply Resource collections to unit tests or to extend Junit tests
that may be used by all DataONE java components.

PackageFiles
~~~~~~~~~~~~

If a collection of resources must be used instead of a single file, then the PackageFiles.java class
is available for extension.  As background, Introspection can be used to discover classes in a 
java package, but it cannot be used to discover other resources, such as xml files or ldif files.
The PackageFiles.java class is a mechanism to discover resources other than classes in a package.
The PackageFiles.java class to work must have a java class in the same package as the other resources
to discover.
Therefore, when D1 needed a collection of files from the KNB node to be used for unit testing,
The PackageFiles.java class was extended in the maven directory src/main/java in the package::

org.dataone.test.knb.data

with the class::

KnbRecords.java

The xml resources where placed in the maven directory src/main/resources in the same package::

org.dataone.test.knb.data

with the xml files::

Blandy.76.2
Blandy.77.1
etc

The extension of the class also allowed for a collection of systemMetadata files to be found in the
specified package::

org.dataone.test.knb.sysmeta


ApacheDSSuiteRunner
~~~~~~~~~~~~~~~~~~~

ApacheDSSuiteRunner is an extension of Junit's Suite class and is
based on org.apache.directory.server.core.integ.FrameworkRunner.

The ApacheDSSuiteRunner allows for ApacheDS annotations such as @CreateDS, 
@ApplyLdifFiles and @CreateLdapServer to be applied to a Junit suite of tests. 
This allows for ApacheDS to be setup and shutdown and run only once  for multiple junit test 
classes in a java component rather than having to setup and shutdown ApacheDS for
each class executed.