blob: 112fded3d2cf583c265d79c68d131abe36904150 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr">
<head>
<title>GeoAPI</title>
<meta charset="UTF-8"/>
<link rel="stylesheet" type="text/css" href="../../../../content/book/book.css"/>
</head>
<body>
<!--
Content below this point is copied in "(…)/content/book/fr/developer-guide.html"
by the 'org.apache.sis.internal.book.Assembler' class in 'sis-build-helper' module.
-->
<section>
<header>
<h2 id="GeoAPI-modules">Les modules de GeoAPI</h2>
</header>
<p>
Le projet GeoAPI est composé d’une partie standardisée (<code>geoapi</code>) et
d’une partie expérimentale (<code>geoapi-pending</code>). Ces deux parties étant
mutuellement exclusives, les utilisateurs doivent veiller à ne pas les mélanger dans un même projet.
Cette séparation est garantie pour tous les projets qui ne dépendent que du dépôt central de Maven
(incluant les versions finales de Apache <abbr>SIS</abbr>),
car le module <code>geoapi-pending</code> n’est jamais déployé sur ce dépôt central.
En revanche certaines branches de développement de <abbr>SIS</abbr> peuvent dépendre de <code>geoapi-pending</code>.
</p><p>
Les modules de GeoAPI sont:
</p>
<ul>
<li><p>
<b><code>geoapi</code></b> — contient les interfaces couvertes par le
<a href="https://www.ogc.org/standards/geoapi">standard GeoAPI de l’<abbr>OGC</abbr></a>.
Les versions finales de Apache <abbr>SIS</abbr> dépendent de ce module.
</p></li>
<li><p>
<b><code>geoapi-pending</code></b> — contient une
<em>copie</em> de toutes les interfaces du module <code>geoapi</code>
(non pas une dépendance) avec des ajouts qui n’ont pas encore été approuvés comme un standard <abbr>OGC</abbr>.
Certains ajouts apparaissent dans des interfaces normalement définies par le module <code>geoapi</code>,
d’où la nécessité de les copier.
Les branches de développement
<code>JDK8</code> et <code>JDK9</code> de Apache <abbr>SIS</abbr> dépendent de ce module,
mais cette dépendance est transformée en une dépendance vers le module <code>geoapi</code>
standard au moment de fusionner les branches avec le tronc.
</p></li>
<li><p>
<b><code>geoapi-conformance</code></b> — contient
une suite de tests JUnit que les développeurs peuvent utiliser pour tester leurs implémentations.
</p></li>
<li><p>
<b><code>geoapi-examples</code></b> — contient des
exemples d’implémentations relativement simples. Ces exemples sont placés dans le domaine public
afin d’encourager les utilisateurs à les copier et les adapter à leurs besoins si les services
de Apache <abbr>SIS</abbr> ne conviennent pas.
</p></li>
<li><p>
<b><code>geoapi-proj4</code></b> — contient une
implémentation partielle des paquets <code>org.opengis.referencing</code>
sous forme d’adaptateurs basés sur la bibliothèque C/C++ Proj.4.
Ce module peut être utilisé comme alternative au module <code>sis-referencing</code>
pour certaines fonctions.
</p></li>
<li><p>
<b><code>geoapi-netcdf</code></b> — contient une implémentation partielle des paquets
<code>org.opengis.referencing</code> et <code>org.opengis.coverage</code>
sous forme d’adaptateurs basés sur la bibliothèque <abbr>netCDF</abbr> de l’<abbr>UCAR</abbr>.
La suite de tests de ce module a été conçue de manière à être réutilisable par d’autres projets.
Apache <abbr>SIS</abbr> l’utilise pour tester son propre module <code>sis-netcdf</code>.
</p></li>
<li><p>
<b><code>geoapi-openoffice</code></b> — contient
un <i>add-in</i> pour les suites bureautiques Libre/OpenOffice.org.
Note: Apache <abbr>SIS</abbr> offre son propre <i>add-in</i> dans le module <code>sis-openoffice</code>.
</p></li>
</ul>
</section>
</body>
</html>