net.jini.lookup

Interface SafeServiceRegistrar

All Superinterfaces:

ServiceRegistrar

public interface SafeServiceRegistrar
extends ServiceRegistrar

ServiceRegistrar that provides safe lookup and notify methods to allow authentication prior to download and delayed un-marshaling.

Since:

4.0

Field Summary

Fields inherited from interface net.jini.core.lookup.ServiceRegistrar

TRANSITION_MATCH_MATCH, TRANSITION_MATCH_NOMATCH, TRANSITION_NOMATCH_MATCH

Method Summary

Modifier and Type	Method and Description
Object[]	lookUp(ServiceTemplate tmpl, int maxProxies) Returns an array with a maximum length of maxProxies, containing bootstrap proxies matching the template with service proxies that are likely to be compatible with the clients constraints.
EventRegistration	notiFy(ServiceTemplate tmpl, int transitions, RemoteEventListener listener, MarshalledInstance handback, long leaseDuration) Registers for event notification.

Methods inherited from interface net.jini.core.lookup.ServiceRegistrar

getEntryClasses, getFieldValues, getGroups, getLocator, getServiceID, getServiceTypes, lookup, lookup, notify, register

Method Detail

lookUp

Object[] lookUp(ServiceTemplate tmpl,
                int maxProxies)
         throws RemoteException

Returns an array with a maximum length of maxProxies, containing bootstrap proxies matching the template with service proxies that are likely to be compatible with the clients constraints. Bootstrap proxies returned are instances of RemoteMethodControl, ServiceProxyAccessor and ServiceAttributesAccessor. The bootstrap proxy is used as a token to authenticate the service, prior to dynamically granting permissions, local attribute filtering and ultimately download of the service proxy codebase and unmarshalling of a service smart proxy. Only in the case of a smart proxy, will the Bootstrap proxy implement CodebaseAccessor, which is an optional interface. For this method to be secure, the client must use AtomicInputValidation, ConfidentialityStrength, ConfidentialityStrength#STRONG} and Integrity

Parameters:

tmpl -

maxProxies -

Returns:

an array of bootstrap proxies, that implement RemoteMethodControl, ServiceProxyAccessor and ServiceAttributesAccessor

Throws:

RemoteException

See Also:

RemoteMethodControl, ServiceProxyAccessor, ServiceAttributesAccessor, CodebaseAccessor

notiFy

EventRegistration notiFy(ServiceTemplate tmpl,
                         int transitions,
                         RemoteEventListener listener,
                         MarshalledInstance handback,
                         long leaseDuration)
                  throws RemoteException

Registers for event notification. The registration is leased; the lease expiration request is not exact. The registration is persistent across restarts (crashes) of the lookup service until the lease expires or is cancelled. The event ID in the returned EventRegistration is unique at least with respect to all other active event registrations in this lookup service with different service templates or transitions.

While the event registration is in effect, a ServiceEvent is sent to the specified listener whenever a register, lease cancellation or expiration, or attribute change operation results in an item changing state in a way that satisfies the template and transition combination.

Parameters:

tmpl - template to match

transitions - bitwise OR of any non-empty set of transition values

listener - listener to send events to

handback - object to include in every ServiceEvent generated

leaseDuration - requested lease duration

Returns:

an EventRegistration object to the entity that registered the specified remote listener

Throws:

RemoteException - if a connection problem occurs.