Building
========

Everything come pre-built.  However, there is an ant and a maven build
file which you can use to rebuild the source code if needed.  To
rebuild the lead-metadata-util jar with ant:
  ant jar
with maven:
  maven jar
  
The latest code is in the rainier.extreme.indiana.edu:/l/extreme/cvs repository
in the codes/lead_metadata/util module.

Using the API
=============

Dependencies - This api requires xmlbeans 2, jsr173, and the lead
metadata xmlbeans jar.  Specifically, the requirements are:
 - jsr173_1.0_api.jar
 - lead-metadata-1.6.jar
 - xbean-2.2.0.jar

To use the API, you need to create a MinimalLEADMetadata object.  The
constructor takes a user ID, a name, and a description.  Then you call
the construct() method on that object to build the LEADResource
document.  Finally, you can get access to the XML by casting the
object to a String, since it implements toString().

    MinimalLEADMetadata test = new MinimalLEADMetadata(userId, name, desc);
    test.construct();
    System.out.println(test);

You can also get direct access to the XMLBeans object created by the
construct method by calling the object's getLeadResourceDoc().  Hence,
you can use MinimalLEADMetadata as a starting point, and then build
out a more complex metadata document.

Javadoc is hosted at http://www.cs.indiana.edu/~machrist/lead-metadata-util

Using the command line client
=============================

The provided commandline client is meant only to demonstrate how you
might invoke the MinimalLEADMetadata utility from a script, or similar
environment.  Simply run "run.sh" with three arguments: a user id, a
name and a description (you'll need to first run "ant" which will
download the required dependencies).  Here's a sample run:

$ ./run.sh "Marcus Christie" exp1 "a new experiment"

<LEADresource xmlns="http://schemas.leadproject.org/2007/01/lms/lead" xmlns:lead="http://schemas.leadproject.org/2007/01/lms/leadelements" xmlns:fgdc="http://schemas.leadproject.org/2007/01/lms/fgdc">
  <lead:resourceID>Unknown</lead:resourceID>
  <data>
    <idinfo>
      <citation>
        <fgdc:origin>Marcus Christie</fgdc:origin>
        <fgdc:pubdate>20070202</fgdc:pubdate>
        <fgdc:pubtime>063957207-0500</fgdc:pubtime>
        <fgdc:title>exp1</fgdc:title>
      </citation>
      <descript>
        <fgdc:abstract>a new experiment</fgdc:abstract>
        <fgdc:purpose>a new experiment</fgdc:purpose>
      </descript>
      <status>
        <fgdc:progress>In work</fgdc:progress>
        <fgdc:update>Unknown</fgdc:update>
      </status>
      <accconst>Managed by MyLEAD</accconst>
      <useconst>Unknown</useconst>
      <keywords>
        <fgdc:theme>
          <fgdc:themekt>leadproject.org</fgdc:themekt>
          <fgdc:themekey>LEAD</fgdc:themekey>
          <fgdc:themekey>edu.indiana.extreme.lead.metadata.util.MinimalLEADMetadata.version.1_6</fgdc:themekey>
        </fgdc:theme>
      </keywords>
    </idinfo>
    <metainfo>
      <fgdc:metd>20070202</fgdc:metd>
      <fgdc:metstdn>LEAD Profile of FGDC Content Standard for Digital Geospatial Metadata</fgdc:metstdn>
      <fgdc:metstdv>FGDC-STD-001.LEAD_1_6-2007</fgdc:metstdv>
    </metainfo>
  </data>
</LEADresource>

The generated document is written to stdout.