Parameter systemId of org.tm4j.topicmap.TopicMapProviderBase.readTopicMap

Parameter systemId of org.tm4j.topicmap.TopicMapProviderBase.readTopicMap

Description

The System ID which identifies the topic map. Note that the following considerations apply when this is null:

  • If srcStream represents an XML document that does not contain a !DOCTYPE declaration, setting systemId to null will not create any additional problems. Remember, however, that there is no way for the parser to validate the document if it can't find that declaration, so you should generally ensure that it's there if you want acceptable results.
  • If srcStream represents an XML document that does contain a !DOCTYPE declaration, you should make sure that its SYSTEM identifier points to an absolute URI if you really want to invoke this method with systemId set to null. Otherwise, the parser will attempt to validate the document, but will fail to find the DTD as it is unable to correctly resolve the !DOCTYPE declaration.
    • : @return A {@link TopicMap} created from the InputStream.

      The System ID which identifies the topic map. This is required.

Meta Data (5)
Text : created from the InputStream.
Text : The System ID which identifies the topic map. Note that the following considerations apply when this is null:
  • If srcStream represents an XML document that does not contain a !DOCTYPE declaration, setting systemId to null will not create any additional problems. Remember, however, that there is no way for the parser to validate the document if it can't find that declaration, so you should generally ensure that it's there if you want acceptable results.
  • If srcStream represents an XML document that does contain a !DOCTYPE declaration, you should make sure that its SYSTEM identifier points to an absolute URI if you really want to invoke this method with systemId set to null. Otherwise, the parser will attempt to validate the document, but will fail to find the DTD as it is unable to correctly resolve the !DOCTYPE declaration.
    • : @return A
Comment : The System ID which identifies the topic map. Note that the following considerations apply when this is null:
  • If srcStream represents an XML document that does not contain a !DOCTYPE declaration, setting systemId to null will not create any additional problems. Remember, however, that there is no way for the parser to validate the document if it can't find that declaration, so you should generally ensure that it's there if you want acceptable results.
  • If srcStream represents an XML document that does contain a !DOCTYPE declaration, you should make sure that its SYSTEM identifier points to an absolute URI if you really want to invoke this method with systemId set to null. Otherwise, the parser will attempt to validate the document, but will fail to find the DTD as it is unable to correctly resolve the !DOCTYPE declaration.
    • : @return A {@link TopicMap} created from the InputStream.
Comment : The System ID which identifies the topic map. This is required.
Text : The System ID which identifies the topic map. This is required.