net.juniper.smgt.gateway.gal
Interface SaeLocator

All Superinterfaces:

NIC

public interface SaeLocator

extends NIC

The SaeLocator interface provides the ability to lookup SAE information given different types of keys.

Method Summary

net.juniper.smgt.gateway.gal.SaeId	lookupSae(net.juniper.smgt.gateway.gal.NicKey key) Returns the SaeId associated with the passed-in key object.
net.juniper.smgt.gateway.gal.SaeId[]	lookupSaes(net.juniper.smgt.gateway.gal.NicKey key) Returns the set of SAEs associated with the passed-in key object.

Methods inherited from interface net.juniper.smgt.gateway.gal.NIC

destroy, getManagement, invalidateLookup, lookup, lookup, lookupSingle

Method Detail

lookupSae

public net.juniper.smgt.gateway.gal.SaeId lookupSae(net.juniper.smgt.gateway.gal.NicKey key)
                                             throws java.lang.IllegalArgumentException,
                                                    AmbiguousKeyException,
                                                    NicInternalException

Returns the SaeId associated with the passed-in key object.

If no associated Sae was found, the method returns null. If multiple Saes are found, the SaeLocator chooses one value to return to the caller.

Returns:

the Sae id associated with the passed-in key

Throws:

java.lang.IllegalArgumentException - if the key object is not of the expected type

AmbiguousKeyException - if the key object does not uniquely identify one value and the NIC implmenetation expects it to.

NicInternalException - for any other exceptions

lookupSaes

public net.juniper.smgt.gateway.gal.SaeId[] lookupSaes(net.juniper.smgt.gateway.gal.NicKey key)
                                                throws java.lang.IllegalArgumentException,
                                                       NicInternalException

Returns the set of SAEs associated with the passed-in key object. If no associated SAEs were found, the method returns an empty array.

Parameters:

key - NicKey - the key object

Returns:

the array of SspIds associated with the passed-in key

Throws:

java.lang.IllegalArgumentException - if the key object is not of the expected type

NicInternalException - for any other exceptions