Management of UDDI node states and attributes
You can use the UDDI registry administrative interface to manage the information about a UDDI node and its activation state.
- nodeID
- nodeState
- nodeDescription
- nodeApplicationName
- activateNode
- deactivateNode
- initNode
- nodeID
- The node ID is the unique
identifier for a UDDI node. If the UDDI
application is installed as a default configuration, the node ID is
generated automatically. If the UDDI application is installed manually,
the administrator sets the node ID. The node ID must be a valid UDDI
key.
String nodeID = uddiNode.getNode(); System.out.println("node ID: " + nodeId);
- nodeState
- The nodeState attribute can have one
of the values in the following
table:
Table 1. nodeState attribute values. The table lists different nodeState values along with the English text associated with each one. nodeState value English text associated with state node.state.uninitialized Not initialized node.state.initialized Initialized node.state.initPending Initialization pending node.state.initInProgress Initialization in progress node.state.initMigrationPending Migration pending node.state.initMigration Migration in progress node.state.initValueSetCreationPending Value set creation pending node.state.initValueSetCreation Value set creation in progress node.state.activated Activated node.state.deactivated Deactivated node.state.unknown Unknown After a UDDI application is installed as a default configuration,, the UDDI node is in activated state, that is, ready to receive and process UDDI API requests. The node ID, root key generator, and some other properties are generated and you cannot change them.
After a UDDI application is installed manually, for example, because you want to specify the UDDI node ID and root key generator values, when the UDDI application starts, the UDDI node is in initPending state. In this state, you can update all writable values until you invoke the initNode operation. The initNode operation loads base tModel entities and value set data, and writes all the configuration data to the database for the UDDI node. During initialization, the UDDI node is in initInProgress state. When initialization completes, the state changes momentarily to initialized and settles at activated. At this point, the state can be switched only between the activated and deactivated states, using the deactivateNode and activateNode MBean operations.
Each node state value is a message key that can be looked up in the messages.properties resource bundle. You can retrieve the attribute value by using the getNodeState method of the UddiNodeProxy class.- Invoke the getNodeState method:
String nodeStateKey = uddiNode.getNodeState();
- Look up translated text from the resource bundle and produce it
as output:
String messages = "com.ibm.uddi.v3.management.messages"; ResourceBundle bundle = ResourceBundle.getBundle(messages,Locale.ENGLISH); String nodeStateText = bundle.getString(nodeStateKey); System.out.println("node state: " + nodeStateText);
- Invoke the getNodeState method:
- nodeDescription
- You can get the administrator-assigned description for the UDDI
node by using the getNodeDescription method of the UddiNodeProxy class.
- Invoke the getNodeDescription method and produce output:
String nodeDescription = uddiNode.getNodeDescription(); System.out.println("node description: " + nodeDescription);
- Invoke the getNodeDescription method and produce output:
- nodeApplicationName
- You can use the nodeApplicationName attribute to discover where
the UDDI application that corresponds to the UDDI node is installed.
The value is a concatenation of the cell, node, and server names,
separated by colons. To retrieve the application location, use the
getApplicationId method of the UddiNodeProxy class.
- Invoke
the getApplicationId method and produce output:
String nodeApplicationId = uddiNode.getApplicationId(); System.out.println("node application location: " + nodeApplicationId);
- Invoke
the getApplicationId method and produce output:
- activateNode
- Changes
the state of the UDDI node to activated, if the UDDI node
is currently deactivated.
- Invoke the activateNode operation:
uddiNode.activateNode();
- Invoke the activateNode operation:
- deactivateNode
- Changes the state of
the UDDI node to deactivated, if the UDDI
node is currently activated.
- Invoke the deactivateNode operation:
uddiNode.deactivateNode();
- Invoke the deactivateNode operation:
- initNode
- Initializes the
UDDI node. When initialization completes, the
UDDI node is in the activated state.
- Invoke the initNode operation:
uddiNode.initNode();
- Invoke the initNode operation: