sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1464395 - in /sis/branches/JDK7: sis-utility/src/main/java/org/apache/sis/internal/jaxb/gco/ObjectIdentification.html sis-utility/src/main/java/org/apache/sis/xml/IdentifierSpace.java src/main/docbook/fr/XML.xml src/main/docbook/fr/geoapi.xml
Date Thu, 04 Apr 2013 09:34:42 GMT
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.



Mime
View raw message