Author: desruisseaux
Date: Sun May 22 03:10:31 2016
New Revision: 1745008
URL: http://svn.apache.org/viewvc?rev=1745008&view=rev
Log:
Review the introduction chapter of developer guide (minor reorganization).
Modified:
sis/site/trunk/book/en/introduction.html
sis/site/trunk/book/fr/introduction.html
sis/site/trunk/content/book/en/developer-guide.html
sis/site/trunk/content/book/fr/developer-guide.html
Modified: sis/site/trunk/book/en/introduction.html
URL:
http://svn.apache.org/viewvc/sis/site/trunk/book/en/introduction.html?rev=1745008&r1=1745007&r2=1745008&view=diff
==============================================================================
--- sis/site/trunk/book/en/introduction.html (original)
+++ sis/site/trunk/book/en/introduction.html Sun May 22 03:10:31 2016
@@ -180,7 +180,7 @@
</article>
- <h3 id="SpecificationTypes">Different Types of Specifications</h3>
+ <h3 id="SpecificationTypes">Types of Specifications</h3>
<p>
<abbr>OGC</abbr> standards are specified in several dozen documents.
Each document outlines a service â for example, the transformation of
coordinates.
@@ -192,37 +192,47 @@
There is always an element of arbitrariness in the method of applying an
abstract specification,
given that adjustments are often necessary to take into account the
constraints or conventions of the target language.
Certain data structures only exist in a few languages â for example,
unions that exist in C/C++ but not in Java.
- </p><p>
- At the turn of the millennium, the abstract specifications were
explicitly concretized in <i>implementation specifications</i>.
- The term âimplementationâ is used here in the sense of all types of
interfaces (Java or others) derived from
- <abbr title="Unified Modeling Language">UML</abbr> diagrams, and not
implementations in the Java sense.
- Such specifications existed for <abbr title="Structured Query
Language">SQL</abbr>,
- <abbr title="Common Object Request Broker Architecture">CORBA</abbr>,
<abbr title="Component Object Model">COM</abbr>, and Java languages.
- As these languages are capable of executing procedures, the
specifications of this period define not only data structures,
- but also operations that apply to these structures.
- </p><p>
- Thereafter, enthusiasm for âWeb 2.0â increased interest for
<abbr>XML</abbr> over other languages.
- Older implementation specifications were deprecated,
- and <abbr title="XML Schema Definition">XSD</abbr> schemas became the
main concretization of abstract specifications.
- Even the way abstract specifications are designed has evolved: they are
less likely to define operations, and so what remains is closer to descriptions
of database schemas.
- Some operations that were defined in older standards now appear, in
another form, in web service specifications.
- Finally, the term âimplementation specificationâ has been
deprecated, to be subsumed under the term â<abbr>OGC</abbr> standard.â
- But despite their depreciation, <a
href="http://www.opengeospatial.org/standards/retired";>old implementation
specifications</a> remain useful to programs in Java, because:
</p>
- <ul>
- <li>Their simpler models, applied to the same concepts, are helpful in
understanding new specifications.</li>
- <li>They sometimes define easy ways to perform common tasks, where the
newer specifications limit themselves to general cases.</li>
- <li>As operations are more often omitted from the newer specifications,
the old ones remain a useful supplement when defining <abbr>API</abbr>s.</li>
- </ul>
+
+
+
+ <article id="implementation-standard">
+ <header>
+ <h1>Historical note</h1>
+ </header>
+ <p>
+ At the turn of the millennium, the abstract specifications were
explicitly concretized in <i>implementation specifications</i>.
+ The term âimplementationâ is used here in the sense of all types
of interfaces (Java or others) derived from
+ <abbr title="Unified Modeling Language">UML</abbr> diagrams, and not
implementations in the Java sense.
+ Such specifications existed for <abbr title="Structured Query
Language">SQL</abbr>,
+ <abbr title="Common Object Request Broker Architecture">CORBA</abbr>,
<abbr title="Component Object Model">COM</abbr>, and Java languages.
+ As these languages are capable of executing procedures, the
specifications of this period define not only data structures,
+ but also operations that apply to these structures.
+ </p><p>
+ Thereafter, enthusiasm for âWeb 2.0â increased interest for
<abbr>XML</abbr> over other languages.
+ Older implementation specifications were deprecated,
+ and <abbr title="XML Schema Definition">XSD</abbr> schemas became the
main concretization of abstract specifications.
+ Even the way abstract specifications are designed has evolved: they
are less likely to define operations, and so what remains is closer to
descriptions of database schemas.
+ Some operations that were defined in older standards now appear, in
another form, in web service specifications.
+ Finally, the term âimplementation specificationâ has been
deprecated, to be subsumed under the term â<abbr>OGC</abbr> standard.â
+ But despite their depreciation, <a
href="http://www.opengeospatial.org/standards/retired";>old implementation
specifications</a> remain useful to programs in Java, because:
+ </p>
+ <ul>
+ <li>Their simpler models, applied to the same concepts, are helpful in
understanding new specifications.</li>
+ <li>They sometimes define easy ways to perform common tasks, where the
newer specifications limit themselves to general cases.</li>
+ <li>As operations are more often omitted from the newer
specifications, the old ones remain a useful supplement when defining
<abbr>API</abbr>s.</li>
+ </ul>
+ <p>
+ The Apache <abbr>SIS</abbr> project is based on the most recent
specifications,
+ drawing from the archives of the <abbr>OGC</abbr> to complete certain
abstract standards or make them more usable.
+ Some old definitions are preserved as âconvenience methodsâ, not
always bringing new functionality, but facilitating the practical use of a
library.
+ </p>
+ </article>
<p>
- The Apache <abbr>SIS</abbr> project is based on the most recent
specifications,
- drawing from the archives of the <abbr>OGC</abbr> to complete certain
abstract standards or make them more usable.
- Some old definitions are preserved as âconvenience methodsâ, not
always bringing new functionality, but facilitating the practical use of a
library.
- </p><p>
The following table lists the main norms used by the project.
Many norms are published both as <abbr>ISO</abbr> standards and as
<abbr>OGC</abbr> standards,
and their corresponding names are listed next to one another in the
first two columns.
- Standards that are deprecated but still used appear <s>struck
through</s>.
+ Standards that are deprecated but still partially used appear <s>struck
through</s>.
Finally, GeoAPI packages will be introduced in upcoming chapters.
</p>
<table>
@@ -417,6 +427,27 @@
<h2 id="About">Conventions Used in This Guide</h2>
<p>
+ Standards sometimes favour the application of certain generic terms to
particular contexts,
+ which may differ from the context in which other communities use these
terms.
+ For example, the terms <i>domain</i> and <i>range</i> may apply to
arbitrary functions in order to designate
+ a set of possible values of inputs and outputs respectively.
+ But the functions to which they are applied by certain <abbr>ISO</abbr>
standards are not the same as the functions to which they are applied by other
libraries.
+ For example, <abbr>ISO</abbr> 19123 applies these terms to
<code>CV_Coverage</code> objects,
+ seen as functions in which the <i>domain</i> is the set of
spatio-temporal coordinates encompassed by the data,
+ and the <i>range</i> is the set of values encompassed.
+ But <abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>'s <abbr title="Network Common Data Form">NetCDF</abbr>
library
+ applies these terms instead to the function of converting pixel indices
(its <i>domain</i>) to spatial-temporal coordinates (its <i>range</i>).
+ Thus the <abbr>UCAR</abbr> library's <i>range</i> may be the
<i>domain</i> of <abbr>ISO</abbr> 19123.
+ </p><p>
+ The Apache <abbr>SIS</abbr> library prefers as much as possible to use
terms in the sense of <abbr>OGC</abbr> and <abbr>ISO</abbr> norms.
+ Particular care must be taken, however, with the interfaces between
<abbr>SIS</abbr> and certain other external libraries,
+ in order to reduce the risk of confusion.
+ </p>
+
+
+
+ <h3 id="CodeColors">Code Colors</h3>
+ <p>
The elements defined in a computer language, such as classes and methods
in Java or elements in an <abbr>XML</abbr> document,
appear in monospaced font.
In order to facilitate an understanding of the relationships between
Apache <abbr>SIS</abbr> and the standards, these elements are also represented
using the following colour codes:
@@ -443,26 +474,5 @@
<p>
Text in gray boxes are for information purpose only and can be ignored.
</p>
-
-
-
- <h3 id="DefinitionOfTerms">Definition of Terms</h3>
- <p>
- Standards sometimes favour the application of certain generic terms to
particular contexts,
- which may differ from the context in which other communities use these
terms.
- For example, the terms <i>domain</i> and <i>range</i> may apply to
arbitrary functions in order to designate
- a set of possible values of inputs and outputs respectively.
- But the functions to which they are applied by certain <abbr>ISO</abbr>
standards are not the same as the functions to which they are applied by other
libraries.
- For example, <abbr>ISO</abbr> 19123 applies these terms to
<code>CV_Coverage</code> objects,
- seen as functions in which the <i>domain</i> is the set of
spatio-temporal coordinates encompassed by the data,
- and the <i>range</i> is the set of values encompassed.
- But <abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>'s <abbr title="Network Common Data Form">NetCDF</abbr>
library
- applies these terms instead to the function of converting pixel indices
(its <i>domain</i>) to spatial-temporal coordinates (its <i>range</i>).
- Thus the <abbr>UCAR</abbr> library's <i>range</i> may be the
<i>domain</i> of <abbr>ISO</abbr> 19123.
- </p><p>
- The Apache <abbr>SIS</abbr> library prefers as much as possible to use
terms in the sense of <abbr>OGC</abbr> and <abbr>ISO</abbr> norms.
- Particular care must be taken, however, with the interfaces between
<abbr>SIS</abbr> and certain other external libraries,
- in order to reduce the risk of confusion.
- </p>
</body>
</html>
Modified: sis/site/trunk/book/fr/introduction.html
URL:
http://svn.apache.org/viewvc/sis/site/trunk/book/fr/introduction.html?rev=1745008&r1=1745007&r2=1745008&view=diff
==============================================================================
--- sis/site/trunk/book/fr/introduction.html (original)
+++ sis/site/trunk/book/fr/introduction.html Sun May 22 03:10:31 2016
@@ -196,7 +196,7 @@
- <h3 id="SpecificationTypes">Les différents types de spécifications</h3>
+ <h3 id="SpecificationTypes">Les types de spécifications</h3>
<p>
Les standards <abbr>OGC</abbr> sont spécifiés dans plusieurs dizaines
de documents.
Chaque document élabore un service, par exemple les transformations de
coordonnées.
@@ -209,49 +209,59 @@
Il existe toutefois une part dâarbitraire dans la façon de
concrétiser une spécification abstraite, étant donné que des ajustements
sont souvent nécessaires
pour tenir compte des contraintes ou des conventions du langage ciblé.
Certaines structures de données nâexistent que dans quelques
langages, par exemple les unions qui existent en C/C++ mais pas en Java.
- </p><p>
- Au tournant du millénaire, les spécifications abstraites étaient
explicitement concrétisées dans des <i>spécifications
dâimplémentations</i>.
- Le terme « implémentation » était ici à prendre au sens de tout
type dâinterfaces (Java ou autres) dérivées des diagrammes
- <abbr title="Unified Modeling Language">UML</abbr> â et non pas
dâimplémentations au sens du Java.
- Des telles spécifications existaient pour les langages <abbr
title="Structured Query Language">SQL</abbr>,
- <abbr title="Common Object Request Broker Architecture">CORBA</abbr>,
<abbr title="Component Object Model">COM</abbr> et Java.
- Ces langages étant capables dâexécuter des procédures, les
spécifications de cette époque définissaient
- non seulement des structures de données, mais aussi des opérations
sâappliquant sur ces structures.
- </p><p>
- Par la suite, lâengouement pour le « web 2.0 » a fait grimper
lâintérêt pour le <abbr>XML</abbr> au détriment des autres langages.
- Les anciennes spécifications dâimplémentations ont été
dépréciées, et les schémas <abbr title="XML Schema Definition">XSD</abbr>
- sont devenus la principale concrétisation des spécifications
abstraites.
- Même la façon de concevoir les spécifications abstraites a évoluée:
les opérations y sont plus rarement définies,
- par conséquence ce qui reste ressemble davantage à des descriptions de
schémas de base de données.
- Certaines opérations qui étaient définies dans les anciennes normes
apparaissent maintenant, sous une autre forme, dans les spécifications des
services web.
- Enfin le terme « spécification dâimplémentation » a été
abandonné, pour être englobé dans « standard <abbr title="Open Geospatial
Consortium">OGC</abbr> ».
- Mais malgré leur dépréciation, les <a
href="http://www.opengeospatial.org/standards/retired";>anciennes
spécifications dâimplémentations</a>
- restent utiles aux programmes en langage Java car:
</p>
- <ul>
- <li>
- Leurs modèles plus simples, appliqués aux mêmes concepts, aident Ã
comprendre les nouvelles spécifications.
- </li>
- <li>
- Ils définissent parfois des façons simples dâeffectuer des tâches
courantes
- là où les nouvelles spécifications se limitent au cas général.
- </li>
- <li>
- Les opérations étant plus souvent omises dans les nouvelles
spécifications,
- les anciennes spécifications restent un complément utile pour
définir des <abbr>API</abbr>.
- </li>
- </ul>
+
+
+
+ <article id="implementation-standard">
+ <header>
+ <h1>Note historique</h1>
+ </header>
+ <p>
+ Au tournant du millénaire, les spécifications abstraites étaient
explicitement concrétisées dans des <i>spécifications
dâimplémentations</i>.
+ Le terme « implémentation » était ici à prendre au sens de tout
type dâinterfaces (Java ou autres) dérivées des diagrammes
+ <abbr title="Unified Modeling Language">UML</abbr> â et non pas
dâimplémentations au sens du Java.
+ Des telles spécifications existaient pour les langages <abbr
title="Structured Query Language">SQL</abbr>,
+ <abbr title="Common Object Request Broker Architecture">CORBA</abbr>,
<abbr title="Component Object Model">COM</abbr> et Java.
+ Ces langages étant capables dâexécuter des procédures, les
spécifications de cette époque définissaient
+ non seulement des structures de données, mais aussi des opérations
sâappliquant sur ces structures.
+ </p><p>
+ Par la suite, lâengouement pour le « web 2.0 » a fait grimper
lâintérêt pour le <abbr>XML</abbr> au détriment des autres langages.
+ Les anciennes spécifications dâimplémentations ont été
dépréciées, et les schémas <abbr title="XML Schema Definition">XSD</abbr>
+ sont devenus la principale concrétisation des spécifications
abstraites.
+ Même la façon de concevoir les spécifications abstraites a
évoluée: les opérations y sont plus rarement définies,
+ par conséquence ce qui reste ressemble davantage à des descriptions
de schémas de base de données.
+ Certaines opérations qui étaient définies dans les anciennes normes
apparaissent maintenant, sous une autre forme, dans les spécifications des
services web.
+ Enfin le terme « spécification dâimplémentation » a été
abandonné, pour être englobé dans « standard <abbr title="Open Geospatial
Consortium">OGC</abbr> ».
+ Mais malgré leur dépréciation, les <a
href="http://www.opengeospatial.org/standards/retired";>anciennes
spécifications dâimplémentations</a>
+ restent utiles aux programmes en langage Java car:
+ </p>
+ <ul>
+ <li>
+ Leurs modèles plus simples, appliqués aux mêmes concepts, aident
à comprendre les nouvelles spécifications.
+ </li>
+ <li>
+ Ils définissent parfois des façons simples dâeffectuer des
tâches courantes
+ là où les nouvelles spécifications se limitent au cas général.
+ </li>
+ <li>
+ Les opérations étant plus souvent omises dans les nouvelles
spécifications,
+ les anciennes spécifications restent un complément utile pour
définir des <abbr>API</abbr>.
+ </li>
+ </ul>
+ <p>
+ Le projet Apache <abbr title="Spatial Information System">SIS</abbr>
se base sur les spécifications les plus récentes,
+ tout en puisant dans les archives de lâ<abbr title="Open Geospatial
Consortium">OGC</abbr>
+ pour compléter certains standards abstraits ou les rendre un peu plus
facile dâutilisation.
+ Certaines anciennes définitions sont conservées comme « méthodes
de commodités »,
+ nâapportant pas toujours de nouvelles fonctionnalités mais
facilitant lâusage pratique dâune bibliothèque.
+ </p>
+ </article>
<p>
- Le projet Apache <abbr title="Spatial Information System">SIS</abbr> se
base sur les spécifications les plus récentes,
- tout en puisant dans les archives de lâ<abbr title="Open Geospatial
Consortium">OGC</abbr>
- pour compléter certains standards abstraits ou les rendre un peu plus
facile dâutilisation.
- Certaines anciennes définitions sont conservées comme « méthodes de
commodités »,
- nâapportant pas toujours de nouvelles fonctionnalités mais facilitant
lâusage pratique dâune bibliothèque.
- </p><p>
Le tableau suivant liste les principales normes utilisées par le projet.
Plusieurs normes sont publiées à la fois comme standard
<abbr>ISO</abbr> et comme standard <abbr>OGC</abbr>,
dâoù la disposition côte-à -côte des deux premières colonnes.
- Les normes dépréciées mais malgré tout utilisées apparaissent
<s>barrées</s>.
+ Les normes dépréciées mais malgré tout partiellement utilisées
apparaissent <s>barrées</s>.
Enfin, les paquets GeoAPI seront introduits dans le chapitre suivant.
</p>
<table>
@@ -446,6 +456,27 @@
<h2 id="About">Conventions utilisées dans ce guide</h2>
<p>
+ Les standards privilégient parfois lâapplication de certains termes
génériques à des contextes particuliers,
+ qui peuvent différer du contexte dans lequel dâautres communautés
emploient ces termes.
+ Par exemple les termes <i>domain</i> et <i>range</i> peuvent
sâappliquer à des fonctions arbitraires
+ pour désigner lâensemble des valeurs possibles en entrés et en
sorties respectivement.
+ Mais les fonctions auxquelles certains standards <abbr>ISO</abbr>
+ les appliquent ne sont pas les mêmes que les fonctions auxquelles
dâautres bibliothèques les appliquent.
+ Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets
<code>CV_Coverage</code>,
+ vus comme des fonctions dont le domaine est lâensemble des
coordonnées spatio-temporelles de la couverture de données
+ et le <i>range</i> lâensemble des valeurs de la couverture.
+ Mais la bibliothèque <abbr title="Network Common Data
Form">NetCDF</abbr> de lâ<abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>
+ applique plutôt ces termes à la fonction convertissant les indices de
pixels (son domaine) vers les coordonnées spatio-temporelles (son
<i>range</i>).
+ Ainsi, un <i>range</i> de la bibliothèque de lâ<abbr>UCAR</abbr> peut
être le domaine de <abbr>ISO</abbr> 19123.
+ </p><p>
+ La bibliothèque Apache <abbr>SIS</abbr> privilégie autant que possible
lâutilisation des termes dans le sens des normes <abbr>OGC</abbr> et
<abbr>ISO</abbr>.
+ Mais un soin particulier doit être apporté aux interfaces entre
<abbr>SIS</abbr> et certaines bibliothèques externes, afin de réduire les
risques de confusions.
+ </p>
+
+
+
+ <h3 id="CodeColors">Code de couleurs</h3>
+ <p>
Les éléments définis dans un langage informatique, tels que les
classes ou méthodes en Java
ainsi que les éléments dans un fichier <abbr>XML</abbr>, apparaissent
avec une police de caractères mono-espacée.
Afin de faciliter la compréhension des liens qui existent entre Apache
<abbr>SIS</abbr> et les standards,
@@ -474,26 +505,5 @@
Des compléments dâinformation apparaissent dans des boîtes grises.
Le lecteur peut ignorer ces boîtes grises sans que cela ne nuise à la
compréhension du texte.
</p>
-
-
-
- <h3 id="DefinitionOfTerms">Définitions des termes</h3>
- <p>
- Les standards privilégient parfois lâapplication de certains termes
génériques à des contextes particuliers,
- qui peuvent différer du contexte dans lequel dâautres communautés
emploient ces termes.
- Par exemple les termes <i>domain</i> et <i>range</i> peuvent
sâappliquer à des fonctions arbitraires
- pour désigner lâensemble des valeurs possibles en entrés et en
sorties respectivement.
- Mais les fonctions auxquelles certains standards <abbr>ISO</abbr>
- les appliquent ne sont pas les mêmes que les fonctions auxquelles
dâautres bibliothèques les appliquent.
- Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets
<code>CV_Coverage</code>,
- vus comme des fonctions dont le domaine est lâensemble des
coordonnées spatio-temporelles de la couverture de données
- et le <i>range</i> lâensemble des valeurs de la couverture.
- Mais la bibliothèque <abbr title="Network Common Data
Form">NetCDF</abbr> de lâ<abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>
- applique plutôt ces termes à la fonction convertissant les indices de
pixels (son domaine) vers les coordonnées spatio-temporelles (son
<i>range</i>).
- Ainsi, un <i>range</i> de la bibliothèque de lâ<abbr>UCAR</abbr> peut
être le domaine de <abbr>ISO</abbr> 19123.
- </p><p>
- La bibliothèque Apache <abbr>SIS</abbr> privilégie autant que possible
lâutilisation des termes dans le sens des normes <abbr>OGC</abbr> et
<abbr>ISO</abbr>.
- Mais un soin particulier doit être apporté aux interfaces entre
<abbr>SIS</abbr> et certaines bibliothèques externes, afin de réduire les
risques de confusions.
- </p>
</body>
</html>
Modified: sis/site/trunk/content/book/en/developer-guide.html
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/book/en/developer-guide.html?rev=1745008&r1=1745007&r2=1745008&view=diff
==============================================================================
--- sis/site/trunk/content/book/en/developer-guide.html (original)
+++ sis/site/trunk/content/book/en/developer-guide.html Sun May 22 03:10:31 2016
@@ -28,9 +28,9 @@
<ul class="toc">
<li><a href="#Foreword">Foreward</a><ul>
<li><a href="#Standards">Standards and Norms</a><ul>
-<li><a href="#SpecificationTypes">Different Types of
Specifications</a></li></ul></li>
+<li><a href="#SpecificationTypes">Types of Specifications</a></li></ul></li>
<li><a href="#About">Conventions Used in This Guide</a><ul>
-<li><a href="#DefinitionOfTerms">Definition of
Terms</a></li></ul></li></ul></li>
+<li><a href="#CodeColors">Code Colors</a></li></ul></li></ul></li>
<li><a href="#GeoAPI">GeoAPI</a><ul>
<li><a href="#SpecificationToInterfaces">Interface Specifications</a><ul>
<li><a href="#UML-annotation">Mapping Given by @UML Annotations</a></li>
@@ -72,9 +72,9 @@
</header>
<nav>In this chapter:<ul class="toc">
<li><a href="#Standards">Standards and Norms</a><ul>
-<li><a href="#SpecificationTypes">Different Types of
Specifications</a></li></ul></li>
+<li><a href="#SpecificationTypes">Types of Specifications</a></li></ul></li>
<li><a href="#About">Conventions Used in This Guide</a><ul>
-<li><a href="#DefinitionOfTerms">Definition of
Terms</a></li></ul></li></ul></nav>
+<li><a href="#CodeColors">Code Colors</a></li></ul></li></ul></nav>
<p>
A geospatial information community is a collection of systems or individuals
capable of exchanging their geospatial data
through the use of common standards, allowing them to communicate with one
another.
@@ -226,7 +226,7 @@ Some working groups use other parallel s
</article>
-<h3 id="SpecificationTypes"><span class="section-number">1.1.1.</span>
Different Types of Specifications</h3>
+<h3 id="SpecificationTypes"><span class="section-number">1.1.1.</span> Types
of Specifications</h3>
<p>
<abbr title="Open Geospatial Consortium">OGC</abbr> standards are specified in
several dozen documents.
Each document outlines a service â for example, the transformation of
coordinates.
@@ -238,7 +238,15 @@ Their concepts may be applied more or le
There is always an element of arbitrariness in the method of applying an
abstract specification,
given that adjustments are often necessary to take into account the
constraints or conventions of the target language.
Certain data structures only exist in a few languages â for example, unions
that exist in C/C++ but not in Java.
-</p><p>
+</p>
+
+
+
+<article id="implementation-standard">
+<header>
+<h1>Historical note</h1>
+</header>
+<p>
At the turn of the millennium, the abstract specifications were explicitly
concretized in <i>implementation specifications</i>.
The term âimplementationâ is used here in the sense of all types of
interfaces (Java or others) derived from
<abbr title="Unified Modeling Language">UML</abbr> diagrams, and not
implementations in the Java sense.
@@ -252,7 +260,7 @@ Older implementation specifications were
and <abbr title="XML Schema Definition">XSD</abbr> schemas became the main
concretization of abstract specifications.
Even the way abstract specifications are designed has evolved: they are less
likely to define operations, and so what remains is closer to descriptions of
database schemas.
Some operations that were defined in older standards now appear, in another
form, in web service specifications.
-Finally, the term âimplementation specificationâ has been deprecated, to
be subsumed under the term â<abbr>OGC</abbr> standard.â
+Finally, the term âimplementation specificationâ has been deprecated, to
be subsumed under the term â<abbr title="Open Geospatial
Consortium">OGC</abbr> standard.â
But despite their depreciation, <a
href="http://www.opengeospatial.org/standards/retired";>old implementation
specifications</a> remain useful to programs in Java, because:
</p>
<ul>
@@ -264,11 +272,13 @@ But despite their depreciation, <a href=
The Apache <abbr title="Spatial Information System">SIS</abbr> project is
based on the most recent specifications,
drawing from the archives of the <abbr>OGC</abbr> to complete certain abstract
standards or make them more usable.
Some old definitions are preserved as âconvenience methodsâ, not always
bringing new functionality, but facilitating the practical use of a library.
-</p><p>
+</p>
+</article>
+<p>
The following table lists the main norms used by the project.
Many norms are published both as <abbr>ISO</abbr> standards and as
<abbr>OGC</abbr> standards,
and their corresponding names are listed next to one another in the first two
columns.
-Standards that are deprecated but still used appear <s>struck through</s>.
+Standards that are deprecated but still partially used appear <s>struck
through</s>.
Finally, GeoAPI packages will be introduced in upcoming chapters.
</p>
<table>
@@ -463,6 +473,27 @@ Finally, GeoAPI packages will be introdu
<h2 id="About"><span class="section-number">1.2.</span> Conventions Used in
This Guide</h2>
<p>
+Standards sometimes favour the application of certain generic terms to
particular contexts,
+which may differ from the context in which other communities use these terms.
+For example, the terms <i>domain</i> and <i>range</i> may apply to arbitrary
functions in order to designate
+a set of possible values of inputs and outputs respectively.
+But the functions to which they are applied by certain <abbr>ISO</abbr>
standards are not the same as the functions to which they are applied by other
libraries.
+For example, <abbr>ISO</abbr> 19123 applies these terms to <code
class="OGC">CV_Coverage</code> objects,
+seen as functions in which the <i>domain</i> is the set of spatio-temporal
coordinates encompassed by the data,
+and the <i>range</i> is the set of values encompassed.
+But <abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>'s <abbr title="Network Common Data Form">NetCDF</abbr>
library
+applies these terms instead to the function of converting pixel indices (its
<i>domain</i>) to spatial-temporal coordinates (its <i>range</i>).
+Thus the <abbr>UCAR</abbr> library's <i>range</i> may be the <i>domain</i> of
<abbr>ISO</abbr> 19123.
+</p><p>
+The Apache <abbr title="Spatial Information System">SIS</abbr> library prefers
as much as possible to use terms in the sense of <abbr title="Open Geospatial
Consortium">OGC</abbr> and <abbr>ISO</abbr> norms.
+Particular care must be taken, however, with the interfaces between
<abbr>SIS</abbr> and certain other external libraries,
+in order to reduce the risk of confusion.
+</p>
+
+
+
+<h3 id="CodeColors"><span class="section-number">1.2.1.</span> Code Colors</h3>
+<p>
The elements defined in a computer language, such as classes and methods in
Java or elements in an <abbr>XML</abbr> document,
appear in monospaced font.
In order to facilitate an understanding of the relationships between Apache
<abbr title="Spatial Information System">SIS</abbr> and the standards, these
elements are also represented using the following colour codes:
@@ -489,27 +520,6 @@ Example: <code>String</code>.
<p>
Text in gray boxes are for information purpose only and can be ignored.
</p>
-
-
-
-<h3 id="DefinitionOfTerms"><span class="section-number">1.2.1.</span>
Definition of Terms</h3>
-<p>
-Standards sometimes favour the application of certain generic terms to
particular contexts,
-which may differ from the context in which other communities use these terms.
-For example, the terms <i>domain</i> and <i>range</i> may apply to arbitrary
functions in order to designate
-a set of possible values of inputs and outputs respectively.
-But the functions to which they are applied by certain <abbr
title="International Organization for Standardization">ISO</abbr> standards are
not the same as the functions to which they are applied by other libraries.
-For example, <abbr>ISO</abbr> 19123 applies these terms to <code
class="OGC">CV_Coverage</code> objects,
-seen as functions in which the <i>domain</i> is the set of spatio-temporal
coordinates encompassed by the data,
-and the <i>range</i> is the set of values encompassed.
-But <abbr title="University Corporation for Atmospheric
Research">UCAR</abbr>'s <abbr title="Network Common Data Form">NetCDF</abbr>
library
-applies these terms instead to the function of converting pixel indices (its
<i>domain</i>) to spatial-temporal coordinates (its <i>range</i>).
-Thus the <abbr>UCAR</abbr> library's <i>range</i> may be the <i>domain</i> of
<abbr>ISO</abbr> 19123.
-</p><p>
-The Apache <abbr title="Spatial Information System">SIS</abbr> library prefers
as much as possible to use terms in the sense of <abbr title="Open Geospatial
Consortium">OGC</abbr> and <abbr>ISO</abbr> norms.
-Particular care must be taken, however, with the interfaces between
<abbr>SIS</abbr> and certain other external libraries,
-in order to reduce the risk of confusion.
-</p>
</section>
<section>
<header>
Modified: sis/site/trunk/content/book/fr/developer-guide.html
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/book/fr/developer-guide.html?rev=1745008&r1=1745007&r2=1745008&view=diff
==============================================================================
--- sis/site/trunk/content/book/fr/developer-guide.html [UTF-8] (original)
+++ sis/site/trunk/content/book/fr/developer-guide.html [UTF-8] Sun May 22
03:10:31 2016
@@ -28,9 +28,9 @@
<ul class="toc">
<li><a href="#Foreword">Préface</a><ul>
<li><a href="#Standards">Standards et normes</a><ul>
-<li><a href="#SpecificationTypes">Les différents types de
spécifications</a></li></ul></li>
+<li><a href="#SpecificationTypes">Les types de
spécifications</a></li></ul></li>
<li><a href="#About">Conventions utilisées dans ce guide</a><ul>
-<li><a href="#DefinitionOfTerms">Définitions des
termes</a></li></ul></li></ul></li>
+<li><a href="#CodeColors">Code de couleurs</a></li></ul></li></ul></li>
<li><a href="#GeoAPI">GeoAPI</a><ul>
<li><a href="#SpecificationToInterfaces">Des spécifications aux
interfaces</a><ul>
<li><a href="#UML-annotation">Correspondances explicitées par l’annotation
@UML</a></li>
@@ -95,9 +95,9 @@
</header>
<nav>Dans ce chapitre:<ul class="toc">
<li><a href="#Standards">Standards et normes</a><ul>
-<li><a href="#SpecificationTypes">Les différents types de
spécifications</a></li></ul></li>
+<li><a href="#SpecificationTypes">Les types de
spécifications</a></li></ul></li>
<li><a href="#About">Conventions utilisées dans ce guide</a><ul>
-<li><a href="#DefinitionOfTerms">Définitions des
termes</a></li></ul></li></ul></nav>
+<li><a href="#CodeColors">Code de couleurs</a></li></ul></li></ul></nav>
<p>
Une communauté d’informations géospatiales est un ensemble de systèmes ou
d’individus capables d’échanger
leurs données géospatiales grâce à des définitions et des standards communs
ainsi qu’une reconnaissance réciproque.
@@ -265,7 +265,7 @@ hébergés en dehors des structures de l
-<h3 id="SpecificationTypes"><span class="section-number">1.1.1.</span> Les
différents types de spécifications</h3>
+<h3 id="SpecificationTypes"><span class="section-number">1.1.1.</span> Les
types de spécifications</h3>
<p>
Les standards <abbr title="Open Geospatial Consortium">OGC</abbr> sont
spécifiés dans plusieurs dizaines de documents.
Chaque document élabore un service, par exemple les transformations de
coordonnées.
@@ -278,7 +278,15 @@ Leurs concepts peuvent se concrétiser d
Il existe toutefois une part d’arbitraire dans la façon de concrétiser une
spécification abstraite, étant donné que des ajustements sont souvent
nécessaires
pour tenir compte des contraintes ou des conventions du langage ciblé.
Certaines structures de données n’existent que dans quelques langages, par
exemple les unions qui existent en C/C++ mais pas en Java.
-</p><p>
+</p>
+
+
+
+<article id="implementation-standard">
+<header>
+<h1>Note historique</h1>
+</header>
+<p>
Au tournant du millénaire, les spécifications abstraites étaient explicitement
concrétisées dans des <i>spécifications d’implémentations</i>.
Le terme « implémentation » était ici à prendre au sens de tout type
d’interfaces (Java ou autres) dérivées des diagrammes
<abbr title="Unified Modeling Language">UML</abbr> — et non pas
d’implémentations au sens du Java.
@@ -316,11 +324,13 @@ tout en puisant dans les archives de l�
pour compléter certains standards abstraits ou les rendre un peu plus facile
d’utilisation.
Certaines anciennes définitions sont conservées comme « méthodes de commodités
»,
n’apportant pas toujours de nouvelles fonctionnalités mais facilitant l’usage
pratique d’une bibliothèque.
-</p><p>
+</p>
+</article>
+<p>
Le tableau suivant liste les principales normes utilisées par le projet.
Plusieurs normes sont publiées à la fois comme standard <abbr
title="International Organization for Standardization">ISO</abbr> et comme
standard <abbr>OGC</abbr>,
d’où la disposition côte-à-côte des deux premières colonnes.
-Les normes dépréciées mais malgré tout utilisées apparaissent <s>barrées</s>.
+Les normes dépréciées mais malgré tout partiellement utilisées apparaissent
<s>barrées</s>.
Enfin, les paquets GeoAPI seront introduits dans le chapitre suivant.
</p>
<table>
@@ -515,6 +525,27 @@ Enfin, les paquets GeoAPI seront introdu
<h2 id="About"><span class="section-number">1.2.</span> Conventions utilisées
dans ce guide</h2>
<p>
+Les standards privilégient parfois l’application de certains termes génériques
à des contextes particuliers,
+qui peuvent différer du contexte dans lequel d’autres communautés emploient
ces termes.
+Par exemple les termes <i>domain</i> et <i>range</i> peuvent s’appliquer à des
fonctions arbitraires
+pour désigner l’ensemble des valeurs possibles en entrés et en sorties
respectivement.
+Mais les fonctions auxquelles certains standards <abbr title="International
Organization for Standardization">ISO</abbr>
+les appliquent ne sont pas les mêmes que les fonctions auxquelles d’autres
bibliothèques les appliquent.
+Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets <code
class="OGC">CV_Coverage</code>,
+vus comme des fonctions dont le domaine est l’ensemble des coordonnées
spatio-temporelles de la couverture de données
+et le <i>range</i> l’ensemble des valeurs de la couverture.
+Mais la bibliothèque <abbr title="Network Common Data Form">NetCDF</abbr> de
l’<abbr title="University Corporation for Atmospheric Research">UCAR</abbr>
+applique plutôt ces termes à la fonction convertissant les indices de pixels
(son domaine) vers les coordonnées spatio-temporelles (son <i>range</i>).
+Ainsi, un <i>range</i> de la bibliothèque de l’<abbr>UCAR</abbr> peut être le
domaine de <abbr>ISO</abbr> 19123.
+</p><p>
+La bibliothèque Apache <abbr title="Spatial Information System">SIS</abbr>
privilégie autant que possible l’utilisation des termes dans le sens des normes
<abbr title="Open Geospatial Consortium">OGC</abbr> et <abbr>ISO</abbr>.
+Mais un soin particulier doit être apporté aux interfaces entre
<abbr>SIS</abbr> et certaines bibliothèques externes, afin de réduire les
risques de confusions.
+</p>
+
+
+
+<h3 id="CodeColors"><span class="section-number">1.2.1.</span> Code de
couleurs</h3>
+<p>
Les éléments définis dans un langage informatique, tels que les classes ou
méthodes en Java
ainsi que les éléments dans un fichier <abbr>XML</abbr>, apparaissent avec une
police de caractères mono-espacée.
Afin de faciliter la compréhension des liens qui existent entre Apache <abbr
title="Spatial Information System">SIS</abbr> et les standards,
@@ -543,27 +574,6 @@ Exemple: <code>String</code>.
Des compléments d’information apparaissent dans des boîtes grises.
Le lecteur peut ignorer ces boîtes grises sans que cela ne nuise à la
compréhension du texte.
</p>
-
-
-
-<h3 id="DefinitionOfTerms"><span class="section-number">1.2.1.</span>
Définitions des termes</h3>
-<p>
-Les standards privilégient parfois l’application de certains termes génériques
à des contextes particuliers,
-qui peuvent différer du contexte dans lequel d’autres communautés emploient
ces termes.
-Par exemple les termes <i>domain</i> et <i>range</i> peuvent s’appliquer à des
fonctions arbitraires
-pour désigner l’ensemble des valeurs possibles en entrés et en sorties
respectivement.
-Mais les fonctions auxquelles certains standards <abbr title="International
Organization for Standardization">ISO</abbr>
-les appliquent ne sont pas les mêmes que les fonctions auxquelles d’autres
bibliothèques les appliquent.
-Par exemple <abbr>ISO</abbr> 19123 applique ces termes aux objets <code
class="OGC">CV_Coverage</code>,
-vus comme des fonctions dont le domaine est l’ensemble des coordonnées
spatio-temporelles de la couverture de données
-et le <i>range</i> l’ensemble des valeurs de la couverture.
-Mais la bibliothèque <abbr title="Network Common Data Form">NetCDF</abbr> de
l’<abbr title="University Corporation for Atmospheric Research">UCAR</abbr>
-applique plutôt ces termes à la fonction convertissant les indices de pixels
(son domaine) vers les coordonnées spatio-temporelles (son <i>range</i>).
-Ainsi, un <i>range</i> de la bibliothèque de l’<abbr>UCAR</abbr> peut être le
domaine de <abbr>ISO</abbr> 19123.
-</p><p>
-La bibliothèque Apache <abbr title="Spatial Information System">SIS</abbr>
privilégie autant que possible l’utilisation des termes dans le sens des normes
<abbr title="Open Geospatial Consortium">OGC</abbr> et <abbr>ISO</abbr>.
-Mais un soin particulier doit être apporté aux interfaces entre
<abbr>SIS</abbr> et certaines bibliothèques externes, afin de réduire les
risques de confusions.
-</p>
</section>
<section>
<header>
