Issue 140: Document type descriptor for jdoquery

[Craig L Russell <Cr...@Sun.COM>]

Javadogs,

Here's a proposal for 18.21:

<proposal>
The jdoquery Document Type Descriptor
This describes files stored as .jdoquery files.
Note: The document type descriptors are to be descriptive, not  
normative. In the final specification, these will be replaced with  
proper xml schema.
The document type descriptor is referred by the xml, and must be  
identified with a DOCTYPE so that the parser can validate the syntax  
of the metadata file. Either the SYSTEM or PUBLIC form of DOCTYPE can  
be used.
If SYSTEM is used, the URI must be accessible; a jdo implementation  
might optimize access for the URI "file:/javax/jdo/jdoquery.dtd"
If PUBLIC is used, the public id should be "-//Sun Microsystems,  
Inc.//DTD Java Data Objects Query Metadata 2.0//EN"; a jdo  
implementation might optimize access for this id.
<?xml version="1.0" encoding="UTF-8"?>
<!-- The DOCTYPE should be as follows for metadata documents.
<!DOCTYPE jdoquery
     PUBLIC "-//Sun Microsystems, Inc.//DTD Java Data Objects Query  
Metadata 2.0//EN"
     "http://java.sun.com/dtd/jdoquery_2_0.dtd">
-->
<!ELEMENT jdoquery (extension*, (package|query)+, (extension)*)>

<!ELEMENT package (extension*, (interface|class)+, (extension)*)>
<!ATTLIST package name CDATA #REQUIRED>

<!ELEMENT interface (extension*, query+, extension*)>
<!ATTLIST interface name CDATA #REQUIRED>

<!ELEMENT class (extension*, query+, extension*)>
<!ATTLIST class name CDATA #REQUIRED>

<!ELEMENT query (#PCDATA | extension)*>
<!ATTLIST query name CDATA #REQUIRED>
<!ATTLIST query language CDATA #IMPLIED>
<!ATTLIST query result-class CDATA #IMPLIED>
<!ATTLIST query unique CDATA #IMPLIED>
<!ATTLIST query unmodifiable (true|false) 'false'>

<!ELEMENT extension ANY>
<!ATTLIST extension vendor-name CDATA #REQUIRED>
<!ATTLIST extension key CDATA #IMPLIED>
<!ATTLIST extension value CDATA #IMPLIED>
</proposal>

Craig Russell
Architect, Sun Java Enterprise System http://java.sun.com/products/jdo
408 276-5638 mailto:Craig.Russell@sun.com
P.S. A good JDO? O, Gasp!