This is an automated email from the ASF dual-hosted git repository.

desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git

commit c75183eab71ccfe38a781ace566448e262d9af19
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Sat Jun 30 11:58:08 2018 +0200

    Add a clarification about why we filter the namespaces.
---
 .../src/main/java/org/apache/sis/xml/TransformingReader.java        | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git 
a/core/sis-metadata/src/main/java/org/apache/sis/xml/TransformingReader.java 
b/core/sis-metadata/src/main/java/org/apache/sis/xml/TransformingReader.java
index dfa270d..34a0a1f 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/xml/TransformingReader.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/xml/TransformingReader.java
@@ -280,7 +280,11 @@ final class TransformingReader extends Transformer 
implements XMLEventReader {
     }
 
     /**
-     * Returns the map loaded by {@link #load(String, int)}.
+     * Returns the map loaded by {@link #load(String, int)} if the given 
namespace is a known legacy namespace.
+     * This method returns a non-empty map only for legacy namespaces for 
which the {@value #FILENAME} file has
+     * been designed. This is necessary for avoiding confusion with classes of 
the same name defined in other
+     * standards. For example the {@code Record} class name is used by other 
standards like Catalog Service for
+     * the Web (OGC CSW), and we don't want to replace the namespace of CSW 
classes.
      *
      * @param  namespace  the namespace URI for which to get the substitution 
map.
      * @return the substitution map for the given namespace, or an empty map 
if none.

Reply via email to