Network Deployment (Distributed operating systems), v8.0 > Reference > Developer detailed usage information

Management of UDDI node configuration properties

We can use the UDDI registry administrative interface to manage the UDDI node runtime behavior by setting the configuration properties.

UDDI node runtime behavior is affected by the setting of several configuration properties. The UddiNode MBean provides the following operations to inspect and update the configuration properties:

• getProperties
• getProperty
• updateProperty
• updateProperties

In the samples for WAS, the ManagePropertiesSample class in the UDDI registry samples demonstrates these operations.

getProperties

Returns a collection of all configuration properties as ConfigurationProperty objects.

1. Invoke the getProperties operation:

   List properties = uddiNode.getProperties();
   

2. Cast each collection member to the ConfigurationProperty object:

    if (properties != null) {
       for (Iterator iter = properties.iterator(); iter.hasNext();) {
          ConfigurationProperty property = (ConfigurationProperty) iter.next();
          .println(property);
       }
    }
   
   

When we have the ConfigurationProperty objects, you can inspect attributes such as the ID, value, and type. We can determine whether the property is read-only or required for initialization, and get the name and description message keys. For example, if you invoke the toString method, results similar to the following example are returned:

      ConfigurationProperty
      id: operatorNodeIDValue
      nameKey: property.name.operatorNodeIDValue
      descriptionKey: property.desc.operatorNodeIDValue
      type: java.lang.String
      value: uddi:capnscarlet:capnscarlet:server1:default
      unitsKey:
      readOnly: true
      required: true
      usingMessageKeys: false
      validValues: none

We can use the nameKey and descriptionKey values to look up the translated name and description for a given locale, using the messages.properties resource in the sample package.

getProperty

Returns the ConfigurationProperty object with the specified ID. Available property IDs are specified in PropertyConstants with descriptions of the purpose of the corresponding properties.

1. Invoke the getProperty operation:

   ConfigurationProperty property =
   uddiNode.getProperty(PropertyConstants.DATABASE_MAX_RESULT_COUNT);
   
   

2. To retrieve the value of the property, you can use the getValue method, which returns an Object, but in this case, the property is an integer type, so it is easier to retrieve the value by using the convenience method getIntegerValue:

   int maxResults = property.getIntegerValue();
   

updateProperty

Updates the value of the ConfigurationProperty object with the specified ID. Available property IDs are specified in PropertyConstants with descriptions of the purpose of the corresponding properties. Although you can invoke the setter methods in a ConfigurationProperty object, the only value that is updated in the UDDI node is the value. To update a property, typically, use the following steps:

1. Create a ConfigurationProperty object and set its ID:

   ConfigurationProperty defaultLanguage = new ConfigurationProperty();
   defaultLanguage.setId(PropertyConstants.DEFAULT_LANGUAGE);
   
   

2. Set the value:

   defaultLanguage.setStringValue("ja");
   

3. Invoke the updateProperty operation:

   uddiNode.updateProperty(defaultLanguage);
   

updateProperties

Updates several ConfigurationProperty objects in a single request. Set up the ConfigurationProperty objects in the same way as for the updateProperty operation.

1. Add the updated properties to a list:

   List updatedProperties = new ArrayList();
            
   updatedProperties.add(updatedProperty1);
   updatedProperties.add(updatedProperty2);
   
   

2. Invoke the updateProperties operation:

   uddiNode.updateProperties(updatedProperties);
   

Manage the UDDI registry
Use the UDDI registry
Use administrative programs (JMX)

Related

Management of UDDI node states and attributes
Management of UDDI node policies
Management of UDDI node tiers
Management of UDDI publishers
Management of UDDI node value sets
UDDI registry administrative (JMX) interface
Samples for WAS

+

Search Tips   |   Advanced Search