org.tm4j.topicmap.TopicMap .createAssociation(java.lang.String id,org.tm4j.net.Locator resourceLocator,org.tm4j.topicmap.Topic type,org.tm4j.topicmap.Topic[] themes)
Description
Creates a new Association in this topic map
Parameters | ||
---|---|---|
java.lang.String | id | the unique identifier to be assigned to the new Association. If this parameter is null, then the Association will be assigned a unique identifier by the back-end implementation. the unique identifier to be assigned to the new Association. If this parameter is null, then the Association will be assigned a unique identifier by the back-end implementation. |
org.tm4j.net.Locator | resourceLocator | the address of the syntactic item which describes this Association (e.g. the address of the XTM association element). This parameter may be NULL for Associations not created from a syntactic item with an address. |
org.tm4j.topicmap.Topic | themes | the topics which define the scope of the new Association. This parameter may be NULL for Associations created in the unconstrained scope. |
org.tm4j.topicmap.Topic | type | the topic which defines the class of associations to which the new Association instance belongs. This parameter may be NULL for untyped associations. |
Throws
- java.beans.PropertyVetoException - if a listener to the TopicMap vetoes the creation of this Association.
-
org.tm4j.topicmap.DuplicateObjectIDException
-
if
id
is already assigned to some other object in this TopicMap. -
org.tm4j.topicmap.DuplicateResourceLocatorException
-
if
resourceLocator
is the address of some other object in this TopicMap.
Returns
the new Association object.
Meta Data (1)