Predefined business objects include telecommunication network managed objects such as:

The following diagram shows the relationship between these classes.

The following figure shows the inheritance tree of predefined business classes.

Instances of predefined business classes hold two types of data: structural data and states and alarms.

Attributes of Predefined Business Objects

Computed Attributes Based on the Object State

The following example shows how to define a new computed attribute that returns the number of major new alarms.

How to Define a New Computed Attribute

IlpAttribute NewMajorAlarmAttribute =
  new IltComputedAttribute("newMajorAlarmAttribute",
                           String.class) {
    public Object getValue (IlpAttributeValueHolder h) {
      IltObjectState oState =
         (IltObjectState)h.getAttributeValue(IltObject.ObjectStateAttribute);
      IltAlarm.State alarmState = oState == null
        ? null : (IltAlarm.State)oState.getAlarmState();
      if ( alarmState == null ) return null;
        return alarmState.getNewAlarmCount(IltAlarm.Severity.Major);
    }
 
    public boolean isDependentOn (IlpAttribute a) {
      return a.getName().equals(ObjectStateAttribute.getName());
    }
  };

Extending Predefined Business Classes

To extend a predefined business class dynamically, you can:

Creating a Subclass of a Predefined Business Class Dynamically

The following example demonstrates how to create a subclass of a predefined business class in XML.

How to Create a Subclass of a Predefined Business Object in XML

<class>
    <name>Element</name>
    <superClass>ilog.tgo.model.IltNetworkElement</superClass>
    <attribute>
      <name>throughput</name>
      <javaClass>java.lang.Integer</javaClass>
    </attribute>
</class>

This class is an instance of both the IlpClass Element and the Java class ilog.tgo.model.IltNetworkElement.

As shown in the following figure, an instance of Element derives from two class hierarchies: the dynamic class hierarchy and the Java class hierarchy.

For example:

How to Extend Predefined Business Object Classes for Use with the Java API

IlpClass elementClass =
  classManager.getClass("Element");
IlpObject element = elementClass.newInstance("element 1", true);

The method newInstance is available in business classes to create new instances. This method has two arguments:

Creating a Java Subclass of a Predefined Business Class

How to Create a New Business Class from a Predefined Business Class

public class CustomNetworkElement extends IltNetworkElement {
 
  // Create the business class 
  static IltObjectInfo metainfo = new IltObjectInfo(CustomNetworkElement.class,
      "CustomNetworkElement");
 
  // Create the business attribute and register in the class
  public static final IlpAttribute THROUGHPUT = new IltAttribute("throughput",
                                                                 Integer.class, 
                                                                 metainfo,
                                                                 new
                                                                 Integer(0));
  // Register the new attribute in this business class
  static {
    metainfo.addAttribute(THROUGHPUT);
  }
 
  // Implement method GetIlpClass so that this class is automatically
  // recognized as a business class by the Class Manager service
  public static IltObjectInfo GetIlpClass() {
    return metainfo;
  }
 
  // Implement the class constructor
  public CustomNetworkElement (Object identifier) {
    super(identifier);
  }
 
  // Implement the class constructor
  public CustomNetworkElement (IlpClass clazz, Object identifier) {
    super(clazz, identifier);
  }
 
  public int getThroughput() {
    Object v = getAttributeValue(THROUGHPUT);
    if (v == ilog.cpl.model.IlpAttributeValueHolder.VALUE_NOT_SET)
      return 0;
    else
      return ((Integer)v).intValue();
  }
 
  public void setThroughput(int throughput) {
    setAttributeValue(THROUGHPUT, new Integer(throughput));
  }
}