net.ontopia.topicmaps.utils.jtm
Class JTMTopicMapWriter

java.lang.Object
  net.ontopia.topicmaps.utils.jtm.JTMTopicMapWriter

All Implemented Interfaces:

TopicMapWriterIF

public class JTMTopicMapWriter
extends java.lang.Object
implements TopicMapWriterIF

PUBLIC: Exports topic maps to the JTM 1.0 interchange format. See the JTM homepage for a specification of the JTM 1.0 exchange format for topic map fragments.

Since:

5.1.0

Constructor Summary

JTMTopicMapWriter(java.io.OutputStream stream)
PUBLIC: Create an JTMTopicMapWriter that writes to a given OutputStream in UTF-8.

JTMTopicMapWriter(java.io.OutputStream stream, java.lang.String encoding)
PUBLIC: Create an JTMTopicMapWriter that writes to a given OutputStream in the given encoding.

JTMTopicMapWriter(java.io.Writer out)
PUBLIC: Create an JTMTopicMapWriter that writes to a given Writer.

Method Summary

void	write(java.util.Collection<TopicIF> topics, java.util.Collection<AssociationIF> assocs) EXPERIMENTAL: Write out a collection of topics and associations as a JTM fragment, represented as a complete topic map.
void	write(TMObjectIF object) PUBLIC: Write the given topic map construct as a JTM fragment.
void	write(TopicMapIF tm) PUBLIC: Writes out the given topic map.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JTMTopicMapWriter

public JTMTopicMapWriter(java.io.OutputStream stream)
                  throws java.io.IOException

PUBLIC: Create an JTMTopicMapWriter that writes to a given OutputStream in UTF-8. Warning: Use of this method is discouraged, as it is very easy to get character encoding errors with this method.

Parameters:

stream - Where the output should be written.

Throws:

java.io.IOException

JTMTopicMapWriter

public JTMTopicMapWriter(java.io.OutputStream stream,
                         java.lang.String encoding)
                  throws java.io.IOException

PUBLIC: Create an JTMTopicMapWriter that writes to a given OutputStream in the given encoding.

Parameters:

stream - Where the output should be written.

encoding - The desired character encoding.

Throws:

java.io.IOException

JTMTopicMapWriter

public JTMTopicMapWriter(java.io.Writer out)

PUBLIC: Create an JTMTopicMapWriter that writes to a given Writer.

Parameters:

out - Where the output should be written.

Method Detail

write

public void write(TopicMapIF tm)
           throws java.io.IOException

PUBLIC: Writes out the given topic map.

Specified by:

write in interface TopicMapWriterIF

Parameters:

tm - The topic map to be serialized as JTM.

Throws:

java.io.IOException - Thrown if writing the topic map fails.

write

public void write(TMObjectIF object)
           throws java.io.IOException

PUBLIC: Write the given topic map construct as a JTM fragment.

Parameters:

object - The topic map construct to be serialized as JTM fragment.

Throws:

java.io.IOException

write

public void write(java.util.Collection<TopicIF> topics,
                  java.util.Collection<AssociationIF> assocs)
           throws java.io.IOException

EXPERIMENTAL: Write out a collection of topics and associations as a JTM fragment, represented as a complete topic map. The identities, names, variants, occurrences, and types of the topics are output, as are the complete associations. Note that the associations of topics in the topics collection are not output, unless they are contained in the assocs collection.

Throws:

java.io.IOException