[tinyTiM-commits] SF.net SVN: tinytim:[229] tinytim-mio/trunk/src/main/java/org/tinytim/mio/ LTMTopicMapReader.java

[<lh...@us...>]

Revision: 229
          http://tinytim.svn.sourceforge.net/tinytim/?rev=229&view=rev
Author:   lheuer
Date:     2008-11-22 14:25:14 +0000 (Sat, 22 Nov 2008)

Log Message:
-----------
Docs to describe the differences between the impl. and the official LTM spec

Modified Paths:
--------------
    tinytim-mio/trunk/src/main/java/org/tinytim/mio/LTMTopicMapReader.java

Modified: tinytim-mio/trunk/src/main/java/org/tinytim/mio/LTMTopicMapReader.java
===================================================================
--- tinytim-mio/trunk/src/main/java/org/tinytim/mio/LTMTopicMapReader.java	2008-11-22 11:47:57 UTC (rev 228)
+++ tinytim-mio/trunk/src/main/java/org/tinytim/mio/LTMTopicMapReader.java	2008-11-22 14:25:14 UTC (rev 229)
@@ -27,6 +27,22 @@
 /**
  * {@link TopicMapReader} implementation that is able to deserialize the
  * <a href="http://www.ontopia.net/download/ltm.html">Linear Topic Map Notation (LTM) 1.3</a>.
+ * This deserializer handles LTM instances somewhat different from the official
+ * specification:
+ * <ul>
+ *  <li>Identifiers are not limited to <tt>[A-Za-z0-9_-.]</tt>, but may 
+ *      contain Unicode characters.</li>
+ *  <li>Roles are not postprocessed; if a role does not have a type, the type 
+ *      is set to a default role type.</li>
+ *  <li>Multiple subject locators are allowed: If a topic contains more than
+ *      one subject locator, the subject locator is added to the topic.</li>
+ *  <li>Subject identifiers / locators may occur in any order: The LTM 
+ *      specification seems to mandate, that the subject identifiers must be 
+ *      specified after an subject locator (if given); this implementation 
+ *      does not mandate any order; a subject locator may be followed by an 
+ *      subject identifier etc.</li>
+ * </ul>
+ * </p>
  * 
  * @author Lars Heuer (heuer[at]semagia.com) <a href="http://www.semagia.com/">Semagia</a>
  * @version $Rev$ - $Date$
@@ -104,8 +120,7 @@
 //     * @return <tt>true</tt> if "#MERGEMAP" is ignored, otherwise <tt>false</tt>.
 //     */
 //    public boolean isIgnoringMergeMap() {
-//        Object property = _deserializer.getProperty(Property.IGNORE_MERGEMAP);
-//        return property instanceof Boolean && Boolean.TRUE.equals(property);
+//        return Boolean.TRUE.equals(_deserializer.getProperty(Property.IGNORE_MERGEMAP));
 //    }
 
 //    /**
@@ -128,7 +143,6 @@
 //     * @return <tt>true</tt> if "#INCLUDE" is ignored, otherwise <tt>false</tt>.
 //     */
 //    public boolean isIgnoringInclude() {
-//        Object property = _deserializer.getProperty(Property.IGNORE_INCLUDE);
-//        return property instanceof Boolean && Boolean.TRUE.equals(property);
+//        return Boolean.TRUE.equals(_deserializer.getProperty(Property.IGNORE_INCLUDE));
 //    }
 }


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.