com.hp.ucmdb.api.topology
Interface TopologyUpdateFactory

public interface TopologyUpdateFactory

Factory for creating arguments for TopologyUpdateService methods. The methods of this factory create client-side representations of CIs and Relations. They do not actually create them in the UCMDB.

Method Summary

CI	createCI(java.lang.String type) Creates the client-side representation of a new CI of the specified type.
CI	createCI(java.lang.String id, java.lang.String type) Returns the client-side object for a CI of the specified ID and type.
CI	createCI(UcmdbId id, java.lang.String type) Returns the client-side object for a CI of the specified ID and type.
ListPropertiesUpdate	createListPropertiesUpdate(TopologyData topologyData)
Relation	createRelation(java.lang.String type, CI end1, CI end2) Creates a client-side Relation of the specified type between the two specified CIs.
Relation	createRelation(java.lang.String type, UcmdbId end1Id, UcmdbId end2Id) Creates a client-side Relation of the specified type between the two CIs specified by their IDs.
Relation	createRelation(UcmdbId id, java.lang.String type, UcmdbId id1, UcmdbId id2)
UcmdbId	createTemporaryCIId(java.lang.String id) Creates a temporary CI ID from the specified string.
UcmdbId	createTemporaryRelationId(java.lang.String id) Creates a temporary Relation ID from the specified string.
TopologyModification	createTopologyModification() Creates an object to be used as an argument to TopologyUpdateService execute method.
TopologyModificationData	createTopologyModificationData() Creates an object to be used as an argument to TopologyUpdateService create, update and delete methods.
TopologyModificationData	createTopologyModificationData(java.lang.String additionalModifierInfo) Creates an object with information about the reporting agent to be used as an argument to TopologyUpdateService create, update and delete methods.
UcmdbId	restoreCIIdFromBytes(byte[] id) Returns the UcmdbId object for the specified bytes array representation of a CI ID.
UcmdbId	restoreCIIdFromString(java.lang.String id) Returns the UcmdbId object for the specified string representation of a CI ID.
UcmdbId	restoreRelationIdFromBytes(byte[] id) Returns the UcmdbId object for the specified bytes array representation of a Relation ID.
UcmdbId	restoreRelationIdFromString(java.lang.String id) Returns the UcmdbId object for the specified string representation of a Relation ID.

Method Detail

restoreCIIdFromString

UcmdbId restoreCIIdFromString(java.lang.String id)
                              throws UcmdbException

Returns the UcmdbId object for the specified string representation of a CI ID.

Parameters:

id - id of the CI as string obtained from UcmdbId.getAsString()

Throws:

UcmdbException - if the string passed cannot be converted to a valid UCMDB ID

restoreCIIdFromBytes

UcmdbId restoreCIIdFromBytes(byte[] id)

Returns the UcmdbId object for the specified bytes array representation of a CI ID.

Parameters:

id - id of the CI as byte array obtained from UcmdbId.getAsBytes()

createTemporaryCIId

UcmdbId createTemporaryCIId(java.lang.String id)

Creates a temporary CI ID from the specified string.

Returns:

a temporary ID

createCI

CI createCI(java.lang.String type)

Creates the client-side representation of a new CI of the specified type. The ID of the CI is a unique, automatically generated, temporary ID.

Parameters:

type - the class name of the new CI

createCI

CI createCI(UcmdbId id,
            java.lang.String type)

Returns the client-side object for a CI of the specified ID and type.

Parameters:

id - ID of the new CI

type - the class name of the new CI

createCI

CI createCI(java.lang.String id,
            java.lang.String type)

Returns the client-side object for a CI of the specified ID and type.

Parameters:

id - ID of the CI as string obtained from UcmdbId.getAsString()

type - the class name of the CI

Since:

8.0

restoreRelationIdFromString

UcmdbId restoreRelationIdFromString(java.lang.String id)

Returns the UcmdbId object for the specified string representation of a Relation ID. The string representation of a Relation ID is obtained with UcmdbId.getAsString()

Parameters:

id - the string representation of a Relation ID

Throws:

UcmdbException - if the string passed cannot be converted to a valid UCMDB ID

restoreRelationIdFromBytes

UcmdbId restoreRelationIdFromBytes(byte[] id)

Returns the UcmdbId object for the specified bytes array representation of a Relation ID. The bytes representation of a Relation ID is obtained with UcmdbId.getAsBytes()

Parameters:

id - the bytes array representation of a Relation ID

createTemporaryRelationId

UcmdbId createTemporaryRelationId(java.lang.String id)

Creates a temporary Relation ID from the specified string.

Returns:

a temporary id

createRelation

Relation createRelation(java.lang.String type,
                        CI end1,
                        CI end2)

Creates a client-side Relation of the specified type between the two specified CIs. This Relation can be used in the TopologyUpdateService.create method. The ID of the Relation is a unique, automatically generated, temporary ID.

Parameters:

type - the class name of the new relation

createRelation

Relation createRelation(java.lang.String type,
                        UcmdbId end1Id,
                        UcmdbId end2Id)

Creates a client-side Relation of the specified type between the two CIs specified by their IDs. This Relation can be used in the TopologyUpdateService.create method. The ID of the Relation is a unique, automatically generated, temporary ID.

Parameters:

type - the class name of the new relation

createRelation

Relation createRelation(UcmdbId id,
                        java.lang.String type,
                        UcmdbId id1,
                        UcmdbId id2)

createTopologyModificationData

TopologyModificationData createTopologyModificationData()

Creates an object to be used as an argument to TopologyUpdateService create, update and delete methods.

createTopologyModificationData

TopologyModificationData createTopologyModificationData(java.lang.String additionalModifierInfo)

Creates an object with information about the reporting agent to be used as an argument to TopologyUpdateService create, update and delete methods. The reporting agent information is stored as the changer in the history database.

Parameters:

additionalModifierInfo - information about the agent that supplies the data. The string is application-dependant and my be used by your agent for any purpose. For example, an agent may use it to identify CIs created by that agent.

createTopologyModification

TopologyModification createTopologyModification()

Creates an object to be used as an argument to TopologyUpdateService execute method.

createListPropertiesUpdate

ListPropertiesUpdate createListPropertiesUpdate(TopologyData topologyData)