From 7ecc2e898bf244265de11783e9f147ff64d2bf60 Mon Sep 17 00:00:00 2001
From: Aron Roberts <aron@socrates.berkeley.edu>
Date: Tue, 30 Jun 2009 21:09:37 +0000
Subject: [PATCH] CSPACE-245: First successful build through 'package' phase;
 also annotated several Maven POM files.

---
 .../id/3rdparty/nuxeo-platform-cs-id/pom.xml  |  46 +--
 services/id/3rdparty/pom.xml                  |  33 +-
 services/id/jaxb/build.properties             |  15 -
 services/id/jaxb/pom.xml                      | 204 +++++++------
 services/id/jaxb/src/main/resources/id.xsd    | 125 +++++---
 services/id/pom.xml                           | 155 ++++++----
 services/id/service/pom.xml                   | 285 ++++++++++--------
 .../collectionspace/services/IDService.java   |   2 +
 8 files changed, 500 insertions(+), 365 deletions(-)
 delete mode 100644 services/id/jaxb/build.properties

diff --git a/services/id/3rdparty/nuxeo-platform-cs-id/pom.xml b/services/id/3rdparty/nuxeo-platform-cs-id/pom.xml
index 15cfd8db0..ec16e55f4 100644
--- a/services/id/3rdparty/nuxeo-platform-cs-id/pom.xml
+++ b/services/id/3rdparty/nuxeo-platform-cs-id/pom.xml
@@ -1,7 +1,7 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
-    <modelVersion>4.0.0</modelVersion>
+  <modelVersion>4.0.0</modelVersion>
 
   <parent>
     <groupId>org.nuxeo.ecm.platform</groupId>
@@ -9,27 +9,27 @@
     <version>5.2-SNAPSHOT</version>
   </parent>
 
-    <artifactId>nuxeo-platform-cs-id</artifactId>
-    <packaging>jar</packaging>
-    <name>nuxeo-platform-cs-id</name>
-    <description>
-    ID Nuxeo document type
-    </description>
-    <properties>
-        <nuxeo.version.5.2>5.2-SNAPSHOT</nuxeo.version.5.2>
-        <nuxeo.version.1.5>1.5-SNAPSHOT</nuxeo.version.1.5>
-    </properties>
-    <dependencies>
-        <dependency>
-            <groupId>org.nuxeo.ecm.core</groupId>
-            <artifactId>nuxeo-core-schema</artifactId>
-            <version>${nuxeo.version.1.5}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.nuxeo.ecm.platform</groupId>
-            <artifactId>nuxeo-platform-types-core</artifactId>
-            <version>${nuxeo.version.5.2}</version>
-        </dependency>
-    </dependencies>
+  <artifactId>nuxeo-platform-cs-id</artifactId>
+  <packaging>jar</packaging>
+  <name>nuxeo-platform-cs-id</name>
+  <description>ID Nuxeo document type</description>
+  
+  <properties>
+    <nuxeo.version.5.2>5.2-SNAPSHOT</nuxeo.version.5.2>
+    <nuxeo.version.1.5>1.5-SNAPSHOT</nuxeo.version.1.5>
+  </properties>
+  
+  <dependencies>
+    <dependency>
+      <groupId>org.nuxeo.ecm.core</groupId>
+      <artifactId>nuxeo-core-schema</artifactId>
+      <version>${nuxeo.version.1.5}</version>
+    </dependency>
+    <dependency>
+      <groupId>org.nuxeo.ecm.platform</groupId>
+      <artifactId>nuxeo-platform-types-core</artifactId>
+      <version>${nuxeo.version.5.2}</version>
+    </dependency>
+  </dependencies>
 
 </project>
diff --git a/services/id/3rdparty/pom.xml b/services/id/3rdparty/pom.xml
index b4e1485c1..3c0ba46be 100644
--- a/services/id/3rdparty/pom.xml
+++ b/services/id/3rdparty/pom.xml
@@ -1,20 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ pom.xml
+ 
+ A Maven 2 project file for the '3rdparty' module of the ID Service project.
+
+ This document is a part of the source code and related artifacts
+ for CollectionSpace, an open source collections management system
+ for museums and related institutions:
+ 
+ http://www.collectionspace.org
+ http://wiki.collectionspace.org
+
+ Based on work by Sanjay Dalal and Richard Millet.
+ 
+ $LastChangedBy: aron $
+ $LastChangedRevision: 302 $
+ $LastChangedDate: 2009-06-29 15:36:29 -0700 (Mon, 29 Jun 2009) $
+-->
 
 <project xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+  
     <modelVersion>4.0.0</modelVersion>
-
     <parent>
-        <artifactId>org.collectionspace.services.collectionobject</artifactId>
+        <artifactId>org.collectionspace.services.id</artifactId>
         <groupId>org.collectionspace.services</groupId>
         <version>1.0</version>
     </parent>
-
-    <artifactId>org.collectionspace.services.collectionobject.3rdparty</artifactId>
+    <artifactId>org.collectionspace.services.id.3rdparty</artifactId>
     <packaging>pom</packaging>
-    <name>services.collectionobject.3rdparty</name>
-    <description>
-    3rd party build for collectionobject service
-    </description>
+    <name>services.id.3rdparty</name>
+    <description>3rd party build for ID service</description>
 
 </project>
diff --git a/services/id/jaxb/build.properties b/services/id/jaxb/build.properties
deleted file mode 100644
index 908e58f29..000000000
--- a/services/id/jaxb/build.properties
+++ /dev/null
@@ -1,15 +0,0 @@
-# Example for Windows
-# jboss.dir=c:/dev/jboss-4.2.3.GA
-# Example for Unix
-jboss.dir=/usr/local/jboss
-
-# Which JBoss server config to use
-jboss.config=default
-
-# nuxeo deployment
-jboss.nuxeo.ear.dir=${jboss.dir}/server/${jboss.config}/deploy/nuxeo.ear
-
-
-# additional command line parameters for mvn commands
-# e.g. to work offline:
-#mvn.opts=-o
diff --git a/services/id/jaxb/pom.xml b/services/id/jaxb/pom.xml
index 222f54132..ef504fbee 100644
--- a/services/id/jaxb/pom.xml
+++ b/services/id/jaxb/pom.xml
@@ -1,101 +1,129 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ pom.xml
+ 
+ A Maven 2 project file for the 'jaxb' module of the ID Service project.
+
+ This document is a part of the source code and related artifacts
+ for CollectionSpace, an open source collections management system
+ for museums and related institutions:
+ 
+ http://www.collectionspace.org
+ http://wiki.collectionspace.org
+ 
+ Based on work by Sanjay Dalal and Richard Millet.
+
+ $LastChangedBy: aron $
+ $LastChangedRevision: 302 $
+ $LastChangedDate: 2009-06-29 15:36:29 -0700 (Mon, 29 Jun 2009) $
+-->
+
 <project xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 
-    <parent>
-        <artifactId>org.collectionspace.services.id</artifactId>
-        <groupId>org.collectionspace.services</groupId>
-        <version>1.0</version>
-    </parent>
-    
-    <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <artifactId>org.collectionspace.services.id</artifactId>
     <groupId>org.collectionspace.services</groupId>
-    <artifactId>org.collectionspace.services.idpattern.jaxb</artifactId>
     <version>1.0</version>
-    <name>services.id.jaxb</name>
+  </parent>
+  
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>org.collectionspace.services</groupId>
+  <artifactId>org.collectionspace.services.id.jaxb</artifactId>
+  <version>1.0</version>
+  <name>services.id.jaxb</name>
+  
+  <dependencies>
+  
+    <dependency>
+      <groupId>com.sun.xml.bind</groupId>
+      <artifactId>jaxb-impl</artifactId>
+      <version>2.0.2</version>
+    </dependency>
+    
+    <dependency>
+      <groupId>org.jvnet.jaxb2-commons</groupId>
+      <artifactId>property-listener-injector</artifactId>
+      <version>1.0</version>
+    </dependency>
     
-    <dependencies>
-        <dependency>
+    <dependency>
+      <groupId>org.jvnet.jaxb2_commons</groupId>
+      <artifactId>runtime</artifactId>
+      <version>0.4.1.4</version>
+    </dependency>
+    
+  </dependencies>
+  
+  <build>
+    <finalName>collectionspace-services-id-jaxb</finalName>
+    <defaultGoal>install</defaultGoal>
+    <plugins>
+    
+      <plugin>
+        <groupId>org.jvnet.jaxb2.maven2</groupId>
+        <artifactId>maven-jaxb2-plugin</artifactId>
+        <executions>
+          <execution>
+            <goals>
+              <goal>generate</goal>
+            </goals>
+          </execution>
+        </executions>
+        <dependencies>
+         <!-- javax.activation.DataSource provider is required by spec -->
+          <dependency>
+            <groupId>javax.activation</groupId>
+            <artifactId>activation</artifactId>
+            <version>1.1</version>
+          </dependency>
+          <dependency>
             <groupId>com.sun.xml.bind</groupId>
             <artifactId>jaxb-impl</artifactId>
-            <version>2.0.2</version>
-        </dependency>
-        <dependency>
-            <groupId>org.jvnet.jaxb2-commons</groupId>
-            <artifactId>property-listener-injector</artifactId>
-            <version>1.0</version>
-        </dependency>
-        <dependency>
-            <groupId>org.jvnet.jaxb2_commons</groupId>
-            <artifactId>runtime</artifactId>
-            <version>0.4.1.4</version>
-        </dependency>
-    </dependencies>
-    <build>
-        <finalName>collectionspace-services-idpattern-jaxb</finalName>
-        <defaultGoal>install</defaultGoal>
-        <plugins>
-            <plugin>
-                <groupId>org.jvnet.jaxb2.maven2</groupId>
-                <artifactId>maven-jaxb2-plugin</artifactId>
-                <executions>
-                    <execution>
-                        <goals>
-                            <goal>generate</goal>
-                        </goals>
-                    </execution>
-                </executions>
-                <dependencies>
-               <!-- javax.activation.DataSource provider is required by spec -->
-                    <dependency>
-                        <groupId>javax.activation</groupId>
-                        <artifactId>activation</artifactId>
-                        <version>1.1</version>
-                    </dependency>
-                    <dependency>
-                        <groupId>com.sun.xml.bind</groupId>
-                        <artifactId>jaxb-impl</artifactId>
-                        <version>2.1.2</version>
-                    </dependency>
-                </dependencies>
-                <configuration>
-                    <args>
-                        <arg>-XtoString</arg>
-                        <arg>-Xinject-listener-code</arg>
+            <version>2.1.2</version>
+          </dependency>
+        </dependencies>
+        <configuration>
+          <args>
+            <arg>-XtoString</arg>
+            <arg>-Xinject-listener-code</arg>
 
-                     <!-- <arg>-Xcollection-setter-injector</arg>
-                                <arg>-Xfluent-api</arg> -->
-                    </args>
-                    <plugins>
-                        <plugin>
-                            <groupId>
-                           org.jvnet.jaxb2_commons
-                            </groupId>
-                            <artifactId>basic</artifactId>
-                            <version>0.4.1</version>
-                        </plugin>
-                        <plugin>
-                            <groupId>
-                           org.jvnet.jaxb2-commons
-                            </groupId>
-                            <artifactId>
-                           property-listener-injector
-                            </artifactId>
-                            <version>1.0</version>
-                        </plugin>
-
-                    </plugins>
-                </configuration>
+           <!-- <arg>-Xcollection-setter-injector</arg>
+                <arg>-Xfluent-api</arg> -->
+          </args>
+          <plugins>
+            <plugin>
+              <groupId>
+               org.jvnet.jaxb2_commons
+              </groupId>
+              <artifactId>basic</artifactId>
+              <version>0.4.1</version>
             </plugin>
             <plugin>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>2.0.2</version>
-                <configuration>
-                    <source>1.5</source>
-                    <target>1.5</target>
-                </configuration>
+              <groupId>
+               org.jvnet.jaxb2-commons
+              </groupId>
+              <artifactId>
+               property-listener-injector
+              </artifactId>
+              <version>1.0</version>
             </plugin>
-        </plugins>
-    </build>
+          </plugins>
+        </configuration>
+      </plugin>
+      
+      <plugin>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>2.0.2</version>
+        <configuration>
+          <source>1.5</source>
+          <target>1.5</target>
+        </configuration>
+      </plugin>
+      
+    </plugins>
+  </build>
+  
 </project>
diff --git a/services/id/jaxb/src/main/resources/id.xsd b/services/id/jaxb/src/main/resources/id.xsd
index 7c6e1c255..eb194a7a4 100644
--- a/services/id/jaxb/src/main/resources/id.xsd
+++ b/services/id/jaxb/src/main/resources/id.xsd
@@ -1,4 +1,27 @@
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+
+<!--
+ id.xsd
+ 
+ A W3C XML Schema file for the 'jaxb' module of the ID Service project.
+ 
+ Declares schema for identifiers (IDs), ID patterns, and
+ lists of multiple IDs and ID patterns.
+
+ This document is a part of the source code and related artifacts
+ for CollectionSpace, an open source collections management system
+ for museums and related institutions:
+ 
+ http://www.collectionspace.org
+ http://wiki.collectionspace.org
+ 
+ $LastChangedBy: aron $
+ $LastChangedRevision: 302 $
+ $LastChangedDate: 2009-06-29 15:36:29 -0700 (Mon, 29 Jun 2009) $
+-->
+
+<!-- TODO: ** These schemas are currently incomplete placeholders ** -->
+
 <xs:schema 
   xmlns:xs="http://www.w3.org/2001/XMLSchema"
   xmlns:ns="http://collectionspace.org/id"
@@ -7,64 +30,66 @@
   version="0.1"
 >
 
-<!-- avoid XmlRootElement nightnmare, see http://weblogs.java.net/blog/kohsuke/archive/2006/03/why_does_jaxb_p.html-->
-        
-    <!-- id  -->
-    <xs:element name="id">
-      <xs:complexType>
-        <xs:sequence>
-          <xs:element name="id" type="xs:string" />
-        </xs:sequence>
-      </xs:complexType>
-    </xs:element>
+  <!--
+    Avoid XmlRootElement nightmare, see
+    http://weblogs.java.net/blog/kohsuke/archive/2006/03/why_does_jaxb_p.html
+  -->
+    
+  <!-- id  -->
+  <xs:element name="id">
+    <xs:complexType>
+    <xs:sequence>
+      <xs:element name="id" type="xs:string" />
+    </xs:sequence>
+    </xs:complexType>
+  </xs:element>
 
-    <!-- id-list as in nuxeo repository -->
-    <xs:element name="id-list">
+  <!-- id-list as in nuxeo repository -->
+  <xs:element name="id-list">
+    <xs:complexType>
+    <xs:sequence>
+      <xs:element name="id-list-item" maxOccurs="unbounded">
       <xs:complexType>
         <xs:sequence>
-          <xs:element name="id-pattern-list-item" maxOccurs="unbounded">
-            <xs:complexType>
-              <xs:sequence>
-                  <xs:element name="id" type="xs:string"
-                    minOccurs="1" />
-              </xs:sequence>
-            </xs:complexType>
-          </xs:element>
+          <xs:element name="idName" type="xs:string" minOccurs="1" />
+          <!-- URI to retrive details of this list item -->
+          <xs:element name="uri" type="xs:anyURI" minOccurs="1" />
+          <xs:element name="csid" type="xs:string" minOccurs="1" />
         </xs:sequence>
       </xs:complexType>
-    </xs:element>
-                    
-    <!-- id-pattern  -->
-    <xs:element name="id-pattern">
+      </xs:element>
+    </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+          
+  <!-- id-pattern  -->
+  <xs:element name="id-pattern">
+    <xs:complexType>
+    <xs:sequence>
+      <xs:element name="csid" type="xs:string" />
+      <xs:element name="idPatternName" type="xs:string"/>
+      <!-- More elements go here -->
+    </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  
+  <!-- id-pattern-list as in nuxeo repository -->
+  <xs:element name="id-pattern-list">
+    <xs:complexType>
+    <xs:sequence>
+      <xs:element name="id-pattern-list-item" maxOccurs="unbounded">
       <xs:complexType>
         <xs:sequence>
-          <xs:element name="csid" type="xs:string" />
-          <xs:element name="idPatternName" type="xs:string"/>
-          <!-- More elements go here -->
+          <xs:element name="idPatternName" type="xs:string" minOccurs="1" />
+          <!-- URI to retrive details of this list item -->
+          <xs:element name="uri" type="xs:anyURI" minOccurs="1" />
+          <xs:element name="csid" type="xs:string" minOccurs="1" />
         </xs:sequence>
       </xs:complexType>
-    </xs:element>
-    
-    <!-- id-pattern-list as in nuxeo repository -->
-    <xs:element name="id-pattern-list">
-      <xs:complexType>
-        <xs:sequence>
-          <xs:element name="id-pattern-list-item" maxOccurs="unbounded">
-            <xs:complexType>
-              <xs:sequence>
-                  <xs:element name="idPatternName" type="xs:string"
-                    minOccurs="1" />
-                  <!-- uri to retrive IDPattern details -->
-                  <xs:element name="uri" type="xs:anyURI"
-                    minOccurs="1" />
-                  <xs:element name="csid" type="xs:string"
-                    minOccurs="1" />
-              </xs:sequence>
-            </xs:complexType>
-          </xs:element>
-        </xs:sequence>
-      </xs:complexType>
-    </xs:element>
-    
+      </xs:element>
+    </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  
 </xs:schema>
 
diff --git a/services/id/pom.xml b/services/id/pom.xml
index dc4de61f3..197dd5416 100644
--- a/services/id/pom.xml
+++ b/services/id/pom.xml
@@ -1,62 +1,101 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
-    <parent>
-        <artifactId>org.collectionspace.services.main</artifactId>
-        <groupId>org.collectionspace.services</groupId>
-        <version>1.0</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
+
+<!--
+ pom.xml
+ 
+ A Maven 2 project file for the ID Service project.
+
+ This document is a part of the source code and related artifacts
+ for CollectionSpace, an open source collections management system
+ for museums and related institutions:
+ 
+ http://www.collectionspace.org
+ http://wiki.collectionspace.org
+ 
+ Based on work by Sanjay Dalal and Richard Millet.
+
+ $LastChangedBy: aron $
+ $LastChangedRevision: 302 $
+ $LastChangedDate: 2009-06-29 15:36:29 -0700 (Mon, 29 Jun 2009) $
+-->
+
+<project
+  xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+  <parent>
+    <artifactId>org.collectionspace.services.main</artifactId>
     <groupId>org.collectionspace.services</groupId>
     <version>1.0</version>
-    <artifactId>org.collectionspace.services.id</artifactId>
-    <packaging>pom</packaging>
-    <name>services.id</name>
-
-    <properties>
-        <nuxeo.version.5.2>5.2-SNAPSHOT</nuxeo.version.5.2>
-        <nuxeo.version.1.5>1.5-SNAPSHOT</nuxeo.version.1.5>
-    </properties>
-
-    <modules>
-        <!-- <module>jaxb</module> -->
-        <module>service</module>
-        <!-- <module>3rdparty</module> -->
-        <!-- <module>client</module> -->
-    </modules>
-
-    <build>
-        <pluginManagement>
-            <plugins>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-compiler-plugin</artifactId>
-                    <configuration>
-                        <source>1.5</source>
-                        <target>1.5</target>
-                    </configuration>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-site-plugin</artifactId>
-                    <configuration>
-                        <unzipCommand>/usr/bin/unzip -o &gt; err.txt</unzipCommand>
-                    </configuration>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-war-plugin</artifactId>
-                    <version>2.0.1</version>
-                    <configuration>
-                        <warSourceExcludes>WEB-INF/lib/*.jar</warSourceExcludes>
-                        <archive>
-                            <manifest>
-                                <addClasspath>true</addClasspath>
-
-                            </manifest>
-                        </archive>
-                    </configuration>
-                </plugin>
-            </plugins>
-        </pluginManagement>
-    </build>
+  </parent>
+  
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>org.collectionspace.services</groupId>
+  <version>1.0</version>
+  <artifactId>org.collectionspace.services.id</artifactId>
+  <!-- The POM packaging type is required for parent and/or multimodule aggregator projects. -->
+  <packaging>pom</packaging>
+  <name>services.id</name>
+
+  <properties>
+    <nuxeo.version.5.2>5.2-SNAPSHOT</nuxeo.version.5.2>
+    <nuxeo.version.1.5>1.5-SNAPSHOT</nuxeo.version.1.5>
+  </properties>
+
+  
+  <modules>
+    <module>jaxb</module>
+    <module>service</module>
+    <module>3rdparty</module>
+    <!-- Uncomment the following when/if we'll be creating a client library for this service. -->
+    <!-- <module>client</module> -->
+  </modules>
+
+  <build>
+    <pluginManagement>
+      <plugins>
+      
+        <!-- Compiles Java sources, including test sources. -->
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-compiler-plugin</artifactId>
+          <configuration>
+            <source>1.5</source>
+            <target>1.5</target>
+          </configuration>
+        </plugin>
+        
+        <!-- Generates a site for the project, typically a website with project documentation. -->
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-site-plugin</artifactId>
+          <configuration>
+            <unzipCommand>/usr/bin/unzip -o &gt; err.txt</unzipCommand>
+          </configuration>
+        </plugin>
+        
+        <plugin>
+        
+          <!--
+            Collects "all artifact dependencies, classes and resources of the web
+            application," packaging them into a web application archive (WAR file).
+          -->
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-war-plugin</artifactId>
+          <version>2.0.1</version>
+          <configuration>
+            <warSourceExcludes>WEB-INF/lib/*.jar</warSourceExcludes>
+            <archive>
+              <manifest>
+                <addClasspath>true</addClasspath>
+              </manifest>
+            </archive>
+          </configuration>
+        </plugin>
+        
+      </plugins>
+    </pluginManagement>
+  </build>
+  
 </project>
diff --git a/services/id/service/pom.xml b/services/id/service/pom.xml
index 396cb4b61..4a8c1e28a 100644
--- a/services/id/service/pom.xml
+++ b/services/id/service/pom.xml
@@ -1,136 +1,175 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 
-    <parent>
-        <artifactId>org.collectionspace.services.id</artifactId>
-        <groupId>org.collectionspace.services</groupId>
-        <version>1.0</version>
-    </parent>
-    
-    <modelVersion>4.0.0</modelVersion>
-    <groupId>org.collectionspace.services</groupId>
-    <artifactId>org.collectionspace.services.id.service</artifactId>
-    <packaging>jar</packaging>
-    <version>1.0</version>
-    <name>services.id.service</name>
-
-    <dependencies>
-        <dependency>
-            <groupId>org.collectionspace.services</groupId>
-            <artifactId>org.collectionspace.services.common</artifactId>
-            <version>1.0</version>
-        </dependency>
 <!--
-        <dependency>
-            <groupId>org.collectionspace.services</groupId>
-            <artifactId>org.collectionspace.services.id.jaxb</artifactId>
-            <version>1.0</version>
-        </dependency>
--->        
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <version>4.1</version>
-            <scope>test</scope>
-        </dependency>
-        <dependency>
-            <groupId>org.testng</groupId>
-            <artifactId>testng</artifactId>
-            <version>5.6</version>
-        </dependency>
-        
+ pom.xml
+ 
+ A Maven 2 project file for the 'service' module of the ID Service project.
 
-      <!-- javax -->
+ This document is a part of the source code and related artifacts
+ for CollectionSpace, an open source collections management system
+ for museums and related institutions:
+ 
+ http://www.collectionspace.org
+ http://wiki.collectionspace.org
+ 
+ Based on work by Sanjay Dalal and Richard Millet.
 
+ $LastChangedBy: aron $
+ $LastChangedRevision: 302 $
+ $LastChangedDate: 2009-06-29 15:36:29 -0700 (Mon, 29 Jun 2009) $
+-->
 
-        <dependency>
-            <groupId>javax.security</groupId>
-            <artifactId>jaas</artifactId>
-            <version>1.0.01</version>
-            <scope>provided</scope>
-        </dependency>
+<project
+  xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
 
-        <dependency>
-            <groupId>dom4j</groupId>
-            <artifactId>dom4j</artifactId>
-            <version>1.6.1</version>
-            <scope>provided</scope>
-        </dependency>
-        
-        <!-- jboss -->
+  <parent>
+    <artifactId>org.collectionspace.services.id</artifactId>
+    <groupId>org.collectionspace.services</groupId>
+    <version>1.0</version>
+  </parent>
+  
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>org.collectionspace.services</groupId>
+  <artifactId>org.collectionspace.services.id.service</artifactId>
+  <packaging>jar</packaging>
+  <version>1.0</version>
+  <name>services.id.service</name>
 
-        <dependency>
-            <groupId>org.jboss.resteasy</groupId>
-            <artifactId>resteasy-jaxrs</artifactId>
-            <version>1.0.2.GA</version>
-            <exclusions>
-                <exclusion>
-                    <groupId>tjws</groupId>
-                    <artifactId>webserver</artifactId>
-                </exclusion>
-            </exclusions>
-        </dependency>
-        <dependency>
-            <groupId>org.jboss.resteasy</groupId>
-            <artifactId>resteasy-jaxb-provider</artifactId>
-            <version>1.0.2.GA</version>
-        </dependency>
-        <dependency>
-            <groupId>org.jboss.resteasy</groupId>
-            <artifactId>resteasy-multipart-provider</artifactId>
-            <version>1.0.2.GA</version>
-        </dependency>
-        
-        <!-- nuxeo -->
+  <dependencies>
+  
+    <!-- Code common to all CollectionSpace services. -->
+    <dependency>
+      <groupId>org.collectionspace.services</groupId>
+      <artifactId>org.collectionspace.services.common</artifactId>
+      <version>1.0</version>
+    </dependency>
+    
+    <!-- JAXB-generated code, in the jaxb module of this project. -->
+    <dependency>
+      <groupId>org.collectionspace.services</groupId>
+      <artifactId>org.collectionspace.services.id.jaxb</artifactId>
+      <version>1.0</version>
+    </dependency>
 
-        <dependency>
-            <groupId>org.nuxeo.ecm.core</groupId>
-            <artifactId>nuxeo-core-api</artifactId>
-            <version>${nuxeo.version.1.5}</version>
-            <exclusions>
-                <exclusion>
-                    <artifactId>jboss-remoting</artifactId>
-                    <groupId>jboss</groupId>
-                </exclusion>
-            </exclusions>
-        </dependency>
+    <!-- JUnit, a testing framework. -->
+    <!-- NOTE: Versions later than 4.1 - such as 4.5 - are available. -->
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.1</version>
+      <scope>test</scope>
+    </dependency>
+    
+    <!-- TestNG, a testing framework. -->
+    <!-- NOTE: Versions later than 5.6 - such as 5.8 - are available. -->
+    <dependency>
+      <groupId>org.testng</groupId>
+      <artifactId>testng</artifactId>
+      <version>5.6</version>
+    </dependency>
 
-        <dependency>
-            <groupId>org.restlet</groupId>
-            <artifactId>org.restlet</artifactId>
-            <version>1.1.5</version>
-        </dependency>
-        <dependency>
-            <groupId>com.noelios.restlet</groupId>
-            <artifactId>com.noelios.restlet.ext.httpclient</artifactId>
-            <version>1.1.5</version>
-        </dependency>
-        <dependency>
-            <groupId>com.noelios.restlet</groupId>
-            <artifactId>com.noelios.restlet</artifactId>
-            <version>1.1.5</version>
-        </dependency>
+    <!-- javax Security, a Java framework for authentication and authorization. -->
+    <!-- JAAS support: is javax security needed with JAAS's incorporation into JDK 1.4? --> 
+    <dependency>
+      <groupId>javax.security</groupId>
+      <artifactId>jaas</artifactId>
+      <version>1.0.01</version>
+      <scope>provided</scope>
+    </dependency>
 
-    </dependencies>
+    <!-- Dom4j, a framework for processing XML -->
+    <dependency>
+      <groupId>dom4j</groupId>
+      <artifactId>dom4j</artifactId>
+      <version>1.6.1</version>
+      <scope>provided</scope>
+    </dependency>
+    
+    <!-- JBoss RESTEasy, a framework for providing and consuming RESTful services. -->
+    <!-- NOTE: Versions later than 1.0.2.GA - such as 1.1 GA - are available. -->
+    <!-- JAX-RS support, a Java specification for RESTful services. -->
+    <dependency>
+      <groupId>org.jboss.resteasy</groupId>
+      <artifactId>resteasy-jaxrs</artifactId>
+      <version>1.0.2.GA</version>
+      <exclusions>
+        <exclusion>
+          <groupId>tjws</groupId>
+          <artifactId>webserver</artifactId>
+        </exclusion>
+      </exclusions>
+    </dependency>
+    <!-- JAXB support, a Java spec for binding objects to XML (& JSON ...) representations. -->
+    <dependency>
+      <groupId>org.jboss.resteasy</groupId>
+      <artifactId>resteasy-jaxb-provider</artifactId>
+      <version>1.0.2.GA</version>
+    </dependency>
+    <!-- MIME Multipart messaging support. -->
+    <dependency>
+      <groupId>org.jboss.resteasy</groupId>
+      <artifactId>resteasy-multipart-provider</artifactId>
+      <version>1.0.2.GA</version>
+    </dependency>
     
-    <build>
-        <finalName>collectionspace-services-commonobject</finalName>
-        <plugins>
-            <plugin>
-                <groupId>org.codehaus.mojo</groupId>
-                <artifactId>jboss-maven-plugin</artifactId>
-                <configuration>
-                    <jbossHome>${jboss.dir}</jbossHome>
-                </configuration>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <configuration>
-                    <source>1.5</source>
-                    <target>1.5</target>
-                </configuration>
-            </plugin>
-        </plugins>
-    </build>
+    <!-- Nuxeo, a platform offering many enterprise content management (ECM) services. -->
+    <dependency>
+      <groupId>org.nuxeo.ecm.core</groupId>
+      <artifactId>nuxeo-core-api</artifactId>
+      <version>${nuxeo.version.1.5}</version>
+      <exclusions>
+        <exclusion>
+          <artifactId>jboss-remoting</artifactId>
+          <groupId>jboss</groupId>
+        </exclusion>
+      </exclusions>
+    </dependency>
+
+    <!-- Restlet, a framework for providing and consuming RESTful services. -->
+    <dependency>
+      <groupId>org.restlet</groupId>
+      <artifactId>org.restlet</artifactId>
+      <version>1.1.5</version>
+    </dependency>
+    <dependency>
+      <groupId>com.noelios.restlet</groupId>
+      <artifactId>com.noelios.restlet.ext.httpclient</artifactId>
+      <version>1.1.5</version>
+    </dependency>
+    <dependency>
+      <groupId>com.noelios.restlet</groupId>
+      <artifactId>com.noelios.restlet</artifactId>
+      <version>1.1.5</version>
+    </dependency>
+
+  </dependencies>
+  
+  <!-- Build element: declares the project's directory structure and manages plugins. -->
+  <build>
+    <finalName>collectionspace-services-commonobject</finalName>
+    <plugins>
+      <plugin>
+        <!-- The Mojo project manages a collection of plugins for Maven 2. -->
+        <groupId>org.codehaus.mojo</groupId>
+        <!-- Manages the ability to start/stop JBoss and deploy/undeploy applications via JMX. -->
+        <artifactId>jboss-maven-plugin</artifactId>
+        <!-- The jboss.dir property comes from the accompanying build.properties file. -->
+        <configuration>
+          <jbossHome>${jboss.dir}</jbossHome>
+        </configuration>
+      </plugin>
+      <!-- Compiles Java sources, including test sources. -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <configuration>
+          <source>1.5</source>
+          <target>1.5</target>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+  
 </project>
diff --git a/services/id/service/src/main/java/org/collectionspace/services/IDService.java b/services/id/service/src/main/java/org/collectionspace/services/IDService.java
index 4ceea5cba..647a54509 100644
--- a/services/id/service/src/main/java/org/collectionspace/services/IDService.java
+++ b/services/id/service/src/main/java/org/collectionspace/services/IDService.java
@@ -29,6 +29,8 @@ package org.collectionspace.services;
 
 public interface IDService {
 
+	public final static String ID_SCHEMA_NAME = "id";
+
 	// ----------------------------------------
 	// IDs
 	// ----------------------------------------
-- 
2.47.3