Links

TGO > Programmers documentation > Business objects and data sources > Links > Links

Links

Link class

Links are used to display the transmission elements making up the network lines. They feature the same dynamic display as network elements.

Links are predefined business objects of the class IltLink used to represent connections between network resources.

The IltLink class defines the following attributes:

Media —Indicates the physical medium connecting two network elements ( fiber, for example).

Name: media

Value class: IltLink.Media

Attribute: IltLink.MediaAttribute

Technology —Indicates the networking technology represented by the link (circuit switching, for example).

Name: technology

Value class: IltLink.LinkTechnology

Attribute: IltLink.TechnologyAttribute

The link technology is very similar to the link media. While the media represents the physical connection (fiber, electrical, for example), the technology represents the various networking technologies that a link can carry. For example, you may have two fiber links, one of them being used for voice and the other one for data.

You can retrieve the class IltLink using its GetIlpClass method. You can handle its instances as simple IlpObject instances and set and get its attributes with the generic methods getAttributeValue and setAttributeValue.

Loading a link defined in XML

This section shows how to load a link from an XML file in a data source. For detailed information about data sources, see Data sources.

All you have to do is create a data source using the data source default implementation defined by IltDefaultDataSource and pass the XML file to the parse method of the data source, as shown below:

dataSource = new IltDefaultDataSource();

dataSource.parse("LinkXMLFile.xml");

How to define a link in XML

The following is an example of a link defined in XML format. For details about the XML elements used in this example, see Elements in an XML data file .

<class>ilog.tgo.model.IltNetworkElement</class>

</attribute>

</addObject>

<class>ilog.tgo.model.IltNetworkElement</class>

</attribute>

</addObject>

<class>ilog.tgo.model.IltLink</class>

<attribute name="media">Fiber</attribute>

<attribute name="objectState"

javaClass="ilog.tgo.model.IltSONETObjectState">

<state>ActiveProtecting</state>

<protection>Exercisor</protection>

</attribute>

</addObject>

</cplData>

The following figure shows the link displayed in a network component:

Link displayed in a network component

Creating a link with the API

This section shows how to create a link through the API and how to add it to a data source.

How to create a link with the API

IltNetworkElement ne1 = new IltNetworkElement("NE1",

IltNetworkElement.Type.MD,

new IltOSIObjectState());

ne1.setAttributeValue(IltObject.PositionAttribute,

new IlpPoint(200, 200));

IltNetworkElement ne2 = new IltNetworkElement("NE2",

IltNetworkElement.Type.MD,

new IltOSIObjectState());

ne2.setAttributeValue(IltObject.PositionAttribute,

new IlpPoint(400, 200));

IltSONETObjectState linkState = new

IltSONETObjectState(IltSONET.State.ActiveProtecting);

linkState.addProtection(IltSONET.End.From, IltSONET.Protection.Exercisor);

linkState.addProtection(IltSONET.End.To, IltSONET.Protection.Exercisor);

IltLink link = new IltLink (linkState, "Link1", IltLink.Media.Fiber);

IltDefaultDataSource dataSource = new IltDefaultDataSource();

dataSource.setLink(link.getIdentifier(), ne1.getIdentifier(),

ne2.getIdentifier());

List objs = new ArrayList();

objs.add(ne1);

objs.add(ne2);

objs.add(link);

dataSource.addObjects(objs);

The result looks like this:

Link displayed in a network component