Author: desruisseaux
Date: Thu Apr 4 09:34:41 2013
New Revision: 1464395
URL: http://svn.apache.org/r1464395
Log:
Documentation clarification: gco:id and gco:uuid XML attributes are declared
unqualified.
Modified:
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java
sis/branches/JDK7/src/main/docbook/fr/XML.xml
sis/branches/JDK7/src/main/docbook/fr/geoapi.xml
Modified:
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html?rev=1464395&r1=1464394&r2=1464395&view=diff
==============================================================================
---
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html
(original)
+++
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html
Thu Apr 4 09:34:41 2013
@@ -21,7 +21,7 @@
which defines the <code>xlink</code> and <code>uuidref</code>
attributes to be supported by all metadata
wrappers in the private
<code>org.apache.sis.internal.jaxb.metadata</code> package and sub-packages.</p>
- <h2>Difference between <code>gml:id</code> and <code>gmd:uuid</code></h2>
+ <h2>Difference between <code>gml:id</code> and <code>gco:uuid</code></h2>
<p>The <a
href="https://www.seegrid.csiro.au/wiki/bin/view/AppSchemas/GmlIdentifiers";>GML
identifiers</a> page said:</p>
<ul>
<li><code>id</code> is a standard <strong>GML</strong> attribute
available on every object-with-identity.
Modified:
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java?rev=1464395&r1=1464394&r2=1464395&view=diff
==============================================================================
---
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java
[UTF-8] (original)
+++
sis/branches/JDK7/sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java
[UTF-8] Thu Apr 4 09:34:41 2013
@@ -59,8 +59,11 @@ public interface IdentifierSpace<T> exte
* Its type is {@code "xs:ID"} - i.e. it is a fragment identifier, unique
within document scope only,
* for internal cross-references. It is not useful by itself as a
persistent unique identifier.
*
- * <p>The XML {@linkplain #getName() attribute name} is {@code "gml:id"}.
- * The XML attribute name of the reference to an identified object is
{@code "xlink:href"}.</p>
+ * <p>The XML {@linkplain #getName() attribute name} is {@code "gml:id"},
but is also used
+ * for {@code "gco:id"} in metadata documents. However the {@code "gco:"}
prefix is omitted
+ * in XML documents (i.e. the {@code gco:id} attribute is
<cite>unqualified</cite>).</p>
+ *
+ * <p>The XML attribute name of the reference to such identified object is
{@code "xlink:href"}.</p>
*
* @see javax.xml.bind.annotation.XmlID
*/
@@ -71,8 +74,11 @@ public interface IdentifierSpace<T> exte
* that implement ISO 19115 in XML. May be used as a persistent unique
identifier, but only
* available within GMD context.
*
- * <p>The XML {@linkplain #getName() attribute name} is {@code "gco:uuid"}.
- * The XML attribute name of the reference to an identified object is
{@code "gco:uuidref"}.</p>
+ * <p>The XML {@linkplain #getName() attribute name} is {@code
"gco:uuid"}. However the
+ * {@code "gco:"} prefix is omitted in XML documents (i.e. the {@code
gco:uuid} attribute
+ * is <cite>unqualified</cite>).</p>
+ *
+ * <p>The XML attribute name of the reference to such identified object is
{@code "gco:uuidref"}.
*
* @see UUID
*/
Modified: sis/branches/JDK7/src/main/docbook/fr/XML.xml
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/src/main/docbook/fr/XML.xml?rev=1464395&r1=1464394&r2=1464395&view=diff
==============================================================================
--- sis/branches/JDK7/src/main/docbook/fr/XML.xml (original)
+++ sis/branches/JDK7/src/main/docbook/fr/XML.xml Thu Apr 4 09:34:41 2013
@@ -28,7 +28,7 @@
qui ne font pas partie des spécifications abstraites dâorigines.
Ces attributs supplémentaires sont habituellement propres au
<acronym>XML</acronym>
et peuvent ne pas apparaître directement dans lâ<acronym>API</acronym>
de Apache <acronym>SIS</acronym>.
- Certains de ces attributs, notamment <literal role="OGC">gmd:id</literal>,
<literal role="OGC">gco:uuid</literal>
+ Certains de ces attributs, notamment <literal role="OGC">id</literal>,
<literal role="OGC">uuid</literal>
et <literal>xlink:href</literal>, restent toutefois accessibles sous forme
de paires clé-valeurs.
</para>
<para>
@@ -181,7 +181,7 @@
Le type de la valeur est un élément <acronym>XML</acronym> dont le nom
commence toujours par une lettre majuscule, en ignorant les préfixes.
Dans lâexemple ci-haut nous avions <classname
role="OGC">MD_DataIdentification</classname>, qui correspond à lâinterface
Java <classname role="GeoAPI">DataIdentification</classname>.
Câest cet élément <acronym>XML</acronym> qui contient les
propriétés filles. Cet élément accepte aussi un groupe dâattributs
- (notamment <literal role="OGC">gmd:id</literal> et <literal
role="OGC">gco:uuid</literal>)
+ (notamment <literal role="OGC">id</literal> et <literal
role="OGC">uuid</literal>)
que les schémas <acronym>XSD</acronym> de lâ<acronym>OGC</acronym>
nomment collectivement <classname
role="OGC">gco:ObjectIdentification</classname>.
Ces attributs nâont pas de méthodes Java dédiées, mais sont
accessibles indirectement via lâinterface <classname
role="SIS">IdentifiedObject</classname>
décrite dans la sous-section suivante.
@@ -219,8 +219,8 @@
<section>
<title>Identification dâinstances déjà définies</title>
<para>
- Lâélément englobant peut contenir un attribut <literal
role="OGC">gmd:id</literal>,
- <literal role="OGC">gco:uuid</literal> ou
<literal>xlink:href</literal>.
+ Lâélément englobant peut contenir un attribut <literal
role="OGC">id</literal>,
+ <literal role="OGC">uuid</literal> ou <literal>xlink:href</literal>.
Si un de ces attributs est présent, lâélément englobé peut être
complètement omis;
il sera remplacé au moment de la lecture par lâélément
référencé par lâattribut.
Dans lâexemple suivant, la partie gauche définie un élément
associé à lâidentifiant â<literal>mon_id</literal>â,
@@ -258,11 +258,11 @@
</para>
<itemizedlist>
<listitem>
- <literal role="OGC">gmd:id</literal> nâest valide quâÃ
lâintérieur du document <acronym>XML</acronym>
+ <literal role="OGC">id</literal> nâest valide quâÃ
lâintérieur du document <acronym>XML</acronym>
qui définit lâobjet ainsi référencé.
</listitem>
<listitem>
- <literal role="OGC">gco:uuid</literal> peut être valide Ã
lâextérieur du document <acronym>XML</acronym>,
+ <literal role="OGC">uuid</literal> peut être valide Ã
lâextérieur du document <acronym>XML</acronym>,
mais quelquâun doit maintenir une base de données fournissant les
objets pour chaque <acronym>UUID</acronym> donnés.
</listitem>
<listitem>
@@ -278,10 +278,10 @@
notamment <constant role="SIS">ID</constant>, <constant
role="SIS">UUID</constant> et <constant role="SIS">HREF</constant>.
Chacune de ces clés peut être associée à une valeur dâun type
différent (habituellement <classname>String</classname>,
<classname>UUID</classname> ou <classname>URI</classname>) selon la
clé.
- Par exemple le code suivant définit une valeur pour lâattribut
<literal role="OGC">gco:uuid</literal>:
+ Par exemple le code suivant définit une valeur pour lâattribut
<literal role="OGC">uuid</literal>:
</para>
<example>
- <title>Associer un identifiant <literal role="OGC">gco:uuid</literal>
à une méta-donnée</title>
+ <title>Associer un identifiant <literal role="OGC">uuid</literal> Ã
une méta-donnée</title>
<programlisting language="java">import
org.apache.sis.metadata.iso.DefaultMetadata;
import org.apache.sis.xml.IdentifierSpace;
import java.util.UUID;
Modified: sis/branches/JDK7/src/main/docbook/fr/geoapi.xml
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/src/main/docbook/fr/geoapi.xml?rev=1464395&r1=1464394&r2=1464395&view=diff
==============================================================================
--- sis/branches/JDK7/src/main/docbook/fr/geoapi.xml (original)
+++ sis/branches/JDK7/src/main/docbook/fr/geoapi.xml Thu Apr 4 09:34:41 2013
@@ -108,7 +108,7 @@
Une conversion à partir des schémas <acronym>XSD</acronym>
introduit, au moins dans le cas des méta-données, près du
double du nombre dâinterfaces réellement définies par le
standard, sans que cela nâapporte de nouvelles fonctionnalités.
Les schémas <acronym>XSD</acronym> définissent aussi des attributs
propres aux documents <acronym>XML</acronym>
- (<literal role="OGC">gmd:id</literal>, <literal
role="OGC">gco:uuid</literal>, <literal>xlink:href</literal>,
<foreignphrase>etc.</foreignphrase>),
+ (<literal role="OGC">id</literal>, <literal
role="OGC">uuid</literal>, <literal>xlink:href</literal>,
<foreignphrase>etc.</foreignphrase>),
qui nâexistent pas dans les diagrammes <acronym>UML</acronym>
originaux et que lâon ne souhaite pas forcément exposer dans un API Java.
Une conversion à partir des schémas <acronym>UML</acronym> évite
ce problème, mais les outils capable dâeffectuer cette
opération sont plus rares.
