pt.lsts.imc

Class IMCAddressResolver

java.lang.Object

pt.lsts.imc.IMCAddressResolver

public class IMCAddressResolver
extends java.lang.Object

This class is used to store known imc names (mapping from their imc ids)

Author:

zp

Constructor Summary

Constructors

Constructor and Description
IMCAddressResolver() Created a new resolver that loads all the static imc addresses from the IMC definitions
IMCAddressResolver(java.io.InputStream is) Creates a new resolver loading initial imc addresses from given stream

Method Summary

Modifier and Type	Method and Description
void	addEntry(int imcid, java.lang.String imcName) Adds or a updates a resolution entry
java.util.Map<java.lang.String,java.lang.Integer>	getAddresses() Retrieve the addresses table
java.lang.String	resolve(int imcId) Tries to name a given imc id
int	resolve(java.lang.String imcName) Given an IMC name retrives its IMC id
java.lang.String	resolveEntity(int src, int src_ent) Resolve the name of an entity Id
java.lang.String	resolveEntity(java.lang.String sourceName, int src_ent) Resolve the name of an entity Id
void	setEntityMap(int imcId, java.util.Map<?,?> namesToIds) Updates entity name resolution given a map from entity ids to names
void	setEntityName(int imcId, int entityId, java.lang.String name) Adds or updates an entity name resolution

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IMCAddressResolver

public IMCAddressResolver()

Created a new resolver that loads all the static imc addresses from the IMC definitions

IMCAddressResolver

public IMCAddressResolver(java.io.InputStream is)

Creates a new resolver loading initial imc addresses from given stream

Parameters:

is - A XML stream with IMC_Addresses.xml forma

Method Detail

resolve

public java.lang.String resolve(int imcId)

Tries to name a given imc id

Parameters:

imcId - The IMC identifier to look for

Returns:

The resolved name. If the system is still unknown it will return "unknown (<imcId>)"

resolve

public int resolve(java.lang.String imcName)

Given an IMC name retrives its IMC id

Parameters:

imcName - The IMC name to look for

Returns:

The found IMC id or -1 if no such system was found

addEntry

public void addEntry(int imcid,
                     java.lang.String imcName)

Adds or a updates a resolution entry

Parameters:

imcid - The IMC identifier of the system

imcName - The IMC name to be used for that ID

setEntityName

public void setEntityName(int imcId,
                          int entityId,
                          java.lang.String name)

Adds or updates an entity name resolution

Parameters:

imcId - The IMC Id of the source system

entityId - The entity Id of the entity

name - The name of this entity id in that system

setEntityMap

public void setEntityMap(int imcId,
                         java.util.Map<?,?> namesToIds)

Updates entity name resolution given a map from entity ids to names

Parameters:

imcId - The IMC Id of the source system

idsToNames - A map from entity names to Ids. The types of the map are fairly flexible: The entries are converted to String and the parsed using Integer.parseInt(). The values are just converted to String.

resolveEntity

public java.lang.String resolveEntity(int src,
                                      int src_ent)

Resolve the name of an entity Id

Parameters:

src - The source system IMC Id

src_ent - The entity Id

Returns:

The found entity name or null in case the entity was not found.

resolveEntity

public java.lang.String resolveEntity(java.lang.String sourceName,
                                      int src_ent)

Resolve the name of an entity Id

Parameters:

sourceName - The source system name

src_ent - The entity Id

Returns:

The found entity name or null in case the entity was not found.

getAddresses

public java.util.Map<java.lang.String,java.lang.Integer> getAddresses()

Retrieve the addresses table

Returns:

The currently found addresses. Bear in mind that if you try to change this map, an Exception will be thrown at run-time.