com.sun.jini.reggie

Class GigaRegistrar

java.lang.Object

com.sun.jini.reggie.GigaRegistrar

All Implemented Interfaces:

JVMInfoProvider, InternalLogProvider, OSInfoProvider, NIOInfoProvider, DestroyAdmin, Registrar, ServiceProxyAccessor, Remote, Administrable, JoinAdmin, ProxyAccessor, DiscoveryAdmin, ServerProxyTrust

public class GigaRegistrar
extends Object
implements Registrar, ProxyAccessor, ServerProxyTrust, NIOInfoProvider, OSInfoProvider, JVMInfoProvider, InternalLogProvider

Base server-side implementation of a lookup service, subclassed by TransientRegistrarImpl and PersistentRegistrarImpl. Multiple client-side proxy classes are used, for the ServiceRegistrar interface as well as for leases and administration; their methods transform the parameters and then make corresponding calls on the Registrar interface implemented on the server side.

Author:

Sun Microsystems, Inc.

Constructor Summary

Constructors

Constructor and Description
GigaRegistrar(String[] configArgs, LifeCycle lifeCycle) Constructs RegistrarImpl based on a configuration obtained using the provided string arguments.

Method Summary

Modifier and Type	Method and Description
void	addAttributes(ServiceID serviceID, Uuid leaseID, EntryRep[] attrSets) Adds the specified attribute sets (those that aren't duplicates of existing attribute sets) to the registered service item.
void	addLookupAttributes(Entry[] attrSets) Add attribute sets for the service.
void	addLookupGroups(String[] groups) Add new groups to the set to join.
void	addLookupLocators(LookupLocator[] locators) Add locators for specific new lookup services to join.
void	addMemberGroups(String[] groups) Adds the given set of names to the set whose elements are the names of the groups in which the lookup service is currently a member.
void	cancelEventLease(long eventID, Uuid leaseID) Cancels an event lease.
Exception[]	cancelLeases(Object[] regIDs, Uuid[] leaseIDs) Cancels service and event leases from a LeaseMap.
void	cancelServiceLease(ServiceID serviceID, Uuid leaseID) Cancels a service lease.
void	destroy() Destroy the service, if possible, including its persistent storage.
void	disableLRMIMonitoring() Disabled lrmi monitoring (gigaspaces internal remoting layer).
void	dumpEventQueueState(PrintWriter writer) Used to write the internal state to a file.
void	enableLRMIMonitoring() Enables lrmi monitoring (gigaspaces internal remoting layer), this will cause the target to start track lrmi invocations which can later be viewed by calling.
LRMIMonitoringDetails	fetchLRMIMonitoringDetails() Return lrmi (gigaspaces internal remoting layer) services monitoring details.
Object	getAdmin() Returns an object that implements whatever administration interfaces are appropriate for the particular service.
long	getCurrentTimestamp()
EntryClassBase[]	getEntryClasses(Template tmpl) Looks at all service items that match the specified template, finds every entry (among those service items) that either doesn't match any entry templates or is a subclass of at least one matching entry template, and returns the set of the (most specific) classes of those entries.
Object[]	getFieldValues(Template tmpl, int setIndex, int field) Looks at all service items that match the specified template, finds every entry (among those service items) that matches tmpl.attributeSetTemplates[setIndex], and returns the set of values of the specified field of those entries.
JVMDetails	getJVMDetails()
JVMStatistics	getJVMStatistics()
LookupLocator	getLocator() Returns a LookupLocator that can be used if necessary for unicast discovery of the lookup service.
Entry[]	getLookupAttributes() Get the current attribute sets for the service.
String[]	getLookupGroups() Get the list of groups to join.
LookupLocator[]	getLookupLocators() Get the list of locators of specific lookup services to join.
String[]	getMemberGroups() Returns an array consisting of the names of the groups in which the lookup service is a member.
NIODetails	getNIODetails() Returns the transport configuration.
NIOStatistics	getNIOStatistics() Returns the transport statistics.
OSDetails	getOSDetails()
OSStatistics	getOSStatistics()
Object	getProxy() Returns a proxy object for this remote object.
TrustVerifier	getProxyVerifier() Returns a TrustVerifier that can be used to verify that a proxy can be trusted as a proxy for the service; that is, the isTrustedObject method of the returned verifier can be called with a candidate proxy.
Object	getServiceProxy() Returns a proxy object for this object.
ServiceTypeBase[]	getServiceTypes(Template tmpl, String prefix) Looks at all service items that match the specified template, and for every service item finds the most specific type (class or interface) or types the service item is an instance of that are neither equal to, nor a superclass of, any of the service types in the template and that have names that start with the specified prefix, and returns the set of all such types.
int	getUnicastPort() Returns the port number on which the lookup service listens for unicast discovery queries.
static boolean	isActive()
protected List<Entry>	loadInitialLookupAttributes()
LogEntries	logEntriesDirect(LogEntryMatcher matcher)
MarshalledWrapper	lookup(Template tmpl) Returns the service object (i.e., just ServiceItem.service) from an item matching the template, or null if there is no match.
Matches	lookup(Template tmpl, int maxMatches) Returns at most maxMatches items matching the template, plus the total number of items that match the template.
void	modifyAttributes(ServiceID serviceID, Uuid leaseID, EntryRep[] attrSetTmpls, EntryRep[] attrSets) Modifies existing attribute sets of a registered service item.
void	modifyLookupAttributes(Entry[] attrSetTemplates, Entry[] attrSets) Modify the current attribute sets, using the same semantics as ServiceRegistration.modifyAttributes.
RegistrarEventRegistration	notify(Template tmpl, int transitions, RemoteEventListener listener, MarshalledObject handback, long leaseDuration) Registers for event notification.
RegistrarEventRegistration	notify(Template tmpl, int transitions, RemoteEventListener listener, MarshalledObject handback, long leaseDuration, int notifyType) Registers for event notification.
ServiceRegistration	register(Item nitem, long leaseDuration) Register a new service or re-register an existing service.
void	removeLookupGroups(String[] groups) Remove groups from the set to join.
void	removeLookupLocators(LookupLocator[] locators) Remove locators for specific lookup services from the set to join.
void	removeMemberGroups(String[] groups) Deletes the elements of the given set of names from the set whose elements are the names of the groups in which the lookup service is currently a member.
long	renewEventLease(long eventID, Uuid leaseID, long renewDuration) Renews an event lease.
RenewResults	renewLeases(Object[] regIDs, Uuid[] leaseIDs, long[] renewDurations) Renews service and event leases from a LeaseMap.
long	renewServiceLease(ServiceID serviceID, Uuid leaseID, long renewDuration) Renews a service lease.
void	runGc()
ServiceDetails	serviceDetails(ServiceID serviceID) Returns the service details of the service id.
void	setAttributes(ServiceID serviceID, Uuid leaseID, EntryRep[] attrSets) Deletes all of the service item's existing attributes, and replaces them with the specified attribute sets.
void	setLookupGroups(String[] groups) Replace the list of groups to join with a new list.
void	setLookupLocators(LookupLocator[] locators) Replace the list of locators of specific lookup services to join with a new list.
void	setMemberGroups(String[] groups) Replaces the set whose elements are the names of the groups in which the lookup service is currently a member with the given set of group names.
void	setUnicastPort(int port) Changes the number of the port on which the lookup service is currently listening for unicast discovery queries to the given port number.

Methods inherited from class java.lang.Object

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

Constructor Detail

GigaRegistrar

public GigaRegistrar(String[] configArgs,
                     LifeCycle lifeCycle)
              throws Exception

Constructs RegistrarImpl based on a configuration obtained using the provided string arguments. If activationID is non-null, the created RegistrarImpl runs as activatable; if persistent is true, it persists/recovers its state to/from disk. A RegistrarImpl instance cannot be constructed as both activatable and non-persistent. If lifeCycle is non-null, its unregister method is invoked during shutdown.

Throws:

Exception

Method Detail

isActive

public static boolean isActive()

dumpEventQueueState

public void dumpEventQueueState(PrintWriter writer)

Used to write the internal state to a file.

See Also:

InternalDumpProvider, InternalDumpProcessor

getServiceProxy

public Object getServiceProxy()
                       throws NoSuchObjectException

Description copied from interface: ServiceProxyAccessor

Returns a proxy object for this object. This value should not be null.

Specified by:

getServiceProxy in interface ServiceProxyAccessor

Returns:

a proxy object reference

Throws:

NoSuchObjectException

getProxy

public Object getProxy()

Description copied from interface: ProxyAccessor

Returns a proxy object for this remote object. If this remote object is not exported (and hence, no proxy is available), then null is returned.

Specified by:

getProxy in interface ProxyAccessor

Returns:

a proxy, or null

getProxyVerifier

public TrustVerifier getProxyVerifier()
                               throws NoSuchObjectException

Description copied from interface: ServerProxyTrust

Returns a TrustVerifier that can be used to verify that a proxy can be trusted as a proxy for the service; that is, the isTrustedObject method of the returned verifier can be called with a candidate proxy. The verifier should be able to verify all proxies for the service, including proxies for resources (such as leases and registrations).

Specified by:

getProxyVerifier in interface ServerProxyTrust

Returns:

a TrustVerifier that can be used to verify that a proxy can be trusted as a proxy for the service

Throws:

NoSuchObjectException

register

public ServiceRegistration register(Item nitem,
                                    long leaseDuration)
                             throws NoSuchObjectException

Description copied from interface: Registrar

Register a new service or re-register an existing service.

Specified by:

register in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.register(net.jini.core.lookup.ServiceItem, long)

serviceDetails

public ServiceDetails serviceDetails(ServiceID serviceID)
                              throws RemoteException

Description copied from interface: Registrar

Returns the service details of the service id.

Specified by:

serviceDetails in interface Registrar

Throws:

RemoteException

lookup

public MarshalledWrapper lookup(Template tmpl)
                         throws NoSuchObjectException

Description copied from interface: Registrar

Returns the service object (i.e., just ServiceItem.service) from an item matching the template, or null if there is no match.

Specified by:

lookup in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.lookup(net.jini.core.lookup.ServiceTemplate)

lookup

public Matches lookup(Template tmpl,
                      int maxMatches)
               throws NoSuchObjectException

Description copied from interface: Registrar

Returns at most maxMatches items matching the template, plus the total number of items that match the template.

Specified by:

lookup in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.lookup(net.jini.core.lookup.ServiceTemplate)

notify

public RegistrarEventRegistration notify(Template tmpl,
                                         int transitions,
                                         RemoteEventListener listener,
                                         MarshalledObject handback,
                                         long leaseDuration)
                                  throws RemoteException

Description copied from interface: Registrar

Registers for event notification.

Specified by:

notify in interface Registrar

Throws:

RemoteException

See Also:

ServiceRegistrar.notify(net.jini.core.lookup.ServiceTemplate, int, net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject, long)

notify

public RegistrarEventRegistration notify(Template tmpl,
                                         int transitions,
                                         RemoteEventListener listener,
                                         MarshalledObject handback,
                                         long leaseDuration,
                                         int notifyType)
                                  throws RemoteException

Description copied from interface: Registrar

Registers for event notification.

Specified by:

notify in interface Registrar

Throws:

RemoteException

See Also:

ServiceRegistrar.notify(net.jini.core.lookup.ServiceTemplate, int, net.jini.core.event.RemoteEventListener, java.rmi.MarshalledObject, long)

getEntryClasses

public EntryClassBase[] getEntryClasses(Template tmpl)
                                 throws NoSuchObjectException

Description copied from interface: Registrar

Looks at all service items that match the specified template, finds every entry (among those service items) that either doesn't match any entry templates or is a subclass of at least one matching entry template, and returns the set of the (most specific) classes of those entries.

Specified by:

getEntryClasses in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.getEntryClasses(net.jini.core.lookup.ServiceTemplate)

getFieldValues

public Object[] getFieldValues(Template tmpl,
                               int setIndex,
                               int field)
                        throws NoSuchObjectException

Description copied from interface: Registrar

Looks at all service items that match the specified template, finds every entry (among those service items) that matches tmpl.attributeSetTemplates[setIndex], and returns the set of values of the specified field of those entries. The field name has been converted to an index (fields numbered from super to subclass).

Specified by:

getFieldValues in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.getFieldValues(net.jini.core.lookup.ServiceTemplate, int, java.lang.String)

getServiceTypes

public ServiceTypeBase[] getServiceTypes(Template tmpl,
                                         String prefix)
                                  throws NoSuchObjectException

Description copied from interface: Registrar

Looks at all service items that match the specified template, and for every service item finds the most specific type (class or interface) or types the service item is an instance of that are neither equal to, nor a superclass of, any of the service types in the template and that have names that start with the specified prefix, and returns the set of all such types.

Specified by:

getServiceTypes in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.getServiceTypes(net.jini.core.lookup.ServiceTemplate, java.lang.String)

getLocator

public LookupLocator getLocator()
                         throws NoSuchObjectException

Description copied from interface: Registrar

Returns a LookupLocator that can be used if necessary for unicast discovery of the lookup service.

Specified by:

getLocator in interface Registrar

Throws:

NoSuchObjectException

See Also:

ServiceRegistrar.getLocator()

getAdmin

public Object getAdmin()
                throws NoSuchObjectException

Description copied from interface: Administrable

Returns an object that implements whatever administration interfaces are appropriate for the particular service.

Specified by:

getAdmin in interface Administrable

Returns:

an object that implements whatever administration interfaces are appropriate for the particular service.

Throws:

NoSuchObjectException

See Also:

JoinAdmin

addAttributes

public void addAttributes(ServiceID serviceID,
                          Uuid leaseID,
                          EntryRep[] attrSets)
                   throws NoSuchObjectException,
                          UnknownLeaseException

Description copied from interface: Registrar

Adds the specified attribute sets (those that aren't duplicates of existing attribute sets) to the registered service item.

Specified by:

addAttributes in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

ServiceRegistration.addAttributes(net.jini.core.entry.Entry[])

modifyAttributes

public void modifyAttributes(ServiceID serviceID,
                             Uuid leaseID,
                             EntryRep[] attrSetTmpls,
                             EntryRep[] attrSets)
                      throws NoSuchObjectException,
                             UnknownLeaseException

Description copied from interface: Registrar

Modifies existing attribute sets of a registered service item.

Specified by:

modifyAttributes in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

ServiceRegistration.modifyAttributes(net.jini.core.entry.Entry[], net.jini.core.entry.Entry[])

setAttributes

public void setAttributes(ServiceID serviceID,
                          Uuid leaseID,
                          EntryRep[] attrSets)
                   throws NoSuchObjectException,
                          UnknownLeaseException

Description copied from interface: Registrar

Deletes all of the service item's existing attributes, and replaces them with the specified attribute sets.

Specified by:

setAttributes in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

ServiceRegistration.setAttributes(net.jini.core.entry.Entry[])

cancelServiceLease

public void cancelServiceLease(ServiceID serviceID,
                               Uuid leaseID)
                        throws NoSuchObjectException,
                               UnknownLeaseException

Description copied from interface: Registrar

Cancels a service lease.

Specified by:

cancelServiceLease in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

Lease.cancel()

renewServiceLease

public long renewServiceLease(ServiceID serviceID,
                              Uuid leaseID,
                              long renewDuration)
                       throws NoSuchObjectException,
                              UnknownLeaseException

Description copied from interface: Registrar

Renews a service lease.

Specified by:

renewServiceLease in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

Lease.renew(long)

cancelEventLease

public void cancelEventLease(long eventID,
                             Uuid leaseID)
                      throws NoSuchObjectException,
                             UnknownLeaseException

Description copied from interface: Registrar

Cancels an event lease.

Specified by:

cancelEventLease in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

Lease.cancel()

renewEventLease

public long renewEventLease(long eventID,
                            Uuid leaseID,
                            long renewDuration)
                     throws NoSuchObjectException,
                            UnknownLeaseException

Description copied from interface: Registrar

Renews an event lease.

Specified by:

renewEventLease in interface Registrar

Throws:

NoSuchObjectException

UnknownLeaseException

See Also:

Lease.renew(long)

renewLeases

public RenewResults renewLeases(Object[] regIDs,
                                Uuid[] leaseIDs,
                                long[] renewDurations)
                         throws NoSuchObjectException

Description copied from interface: Registrar

Renews service and event leases from a LeaseMap.

Specified by:

renewLeases in interface Registrar

Throws:

NoSuchObjectException

See Also:

LeaseMap.renewAll()

cancelLeases

public Exception[] cancelLeases(Object[] regIDs,
                                Uuid[] leaseIDs)
                         throws NoSuchObjectException

Description copied from interface: Registrar

Cancels service and event leases from a LeaseMap.

Specified by:

cancelLeases in interface Registrar

Throws:

NoSuchObjectException

See Also:

LeaseMap.cancelAll()

getLookupAttributes

public Entry[] getLookupAttributes()
                            throws NoSuchObjectException

Description copied from interface: JoinAdmin

Get the current attribute sets for the service.

Specified by:

getLookupAttributes in interface JoinAdmin

Returns:

the current attribute sets for the service

Throws:

NoSuchObjectException

addLookupAttributes

public void addLookupAttributes(Entry[] attrSets)
                         throws RemoteException

Description copied from interface: JoinAdmin

Add attribute sets for the service. The resulting set will be used for all future joins. The attribute sets are also added to all currently-joined lookup services.

Specified by:

addLookupAttributes in interface JoinAdmin

Parameters:

attrSets - the attribute sets to add

Throws:

RemoteException

modifyLookupAttributes

public void modifyLookupAttributes(Entry[] attrSetTemplates,
                                   Entry[] attrSets)
                            throws RemoteException

Description copied from interface: JoinAdmin

Modify the current attribute sets, using the same semantics as ServiceRegistration.modifyAttributes. The resulting set will be used for all future joins. The same modifications are also made to all currently-joined lookup services.

Specified by:

modifyLookupAttributes in interface JoinAdmin

Parameters:

attrSetTemplates - the templates for matching attribute sets

attrSets - the modifications to make to matching sets

Throws:

RemoteException

See Also:

ServiceRegistration.modifyAttributes(net.jini.core.entry.Entry[], net.jini.core.entry.Entry[])

getLookupGroups

public String[] getLookupGroups()
                         throws NoSuchObjectException

Description copied from interface: JoinAdmin

Get the list of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).

Specified by:

getLookupGroups in interface JoinAdmin

Returns:

an array of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).

Throws:

NoSuchObjectException

See Also:

JoinAdmin.setLookupGroups(java.lang.String[])

addLookupGroups

public void addLookupGroups(String[] groups)
                     throws NoSuchObjectException

Description copied from interface: JoinAdmin

Add new groups to the set to join. Lookup services in the new groups will be discovered and joined.

Specified by:

addLookupGroups in interface JoinAdmin

Parameters:

groups - groups to join

Throws:

NoSuchObjectException

See Also:

JoinAdmin.removeLookupGroups(java.lang.String[])

removeLookupGroups

public void removeLookupGroups(String[] groups)
                        throws NoSuchObjectException

Description copied from interface: JoinAdmin

Remove groups from the set to join. Leases are cancelled at lookup services that are not members of any of the remaining groups.

Specified by:

removeLookupGroups in interface JoinAdmin

Parameters:

groups - groups to leave

Throws:

NoSuchObjectException

See Also:

JoinAdmin.addLookupGroups(java.lang.String[])

setLookupGroups

public void setLookupGroups(String[] groups)
                     throws NoSuchObjectException

Description copied from interface: JoinAdmin

Replace the list of groups to join with a new list. Leases are cancelled at lookup services that are not members of any of the new groups. Lookup services in the new groups will be discovered and joined.

Specified by:

setLookupGroups in interface JoinAdmin

Parameters:

groups - groups to join

Throws:

NoSuchObjectException

See Also:

JoinAdmin.getLookupGroups()

getLookupLocators

public LookupLocator[] getLookupLocators()
                                  throws NoSuchObjectException

Description copied from interface: JoinAdmin

Get the list of locators of specific lookup services to join.

Specified by:

getLookupLocators in interface JoinAdmin

Returns:

the list of locators of specific lookup services to join

Throws:

NoSuchObjectException

See Also:

JoinAdmin.setLookupLocators(net.jini.core.discovery.LookupLocator[])

addLookupLocators

public void addLookupLocators(LookupLocator[] locators)
                       throws RemoteException

Description copied from interface: JoinAdmin

Add locators for specific new lookup services to join. The new lookup services will be discovered and joined.

Specified by:

addLookupLocators in interface JoinAdmin

Parameters:

locators - locators of specific lookup services to join

Throws:

RemoteException

See Also:

JoinAdmin.removeLookupLocators(net.jini.core.discovery.LookupLocator[])

removeLookupLocators

public void removeLookupLocators(LookupLocator[] locators)
                          throws RemoteException

Description copied from interface: JoinAdmin

Remove locators for specific lookup services from the set to join. Any leases held at the lookup services are cancelled.

Specified by:

removeLookupLocators in interface JoinAdmin

Parameters:

locators - locators of specific lookup services to leave

Throws:

RemoteException

See Also:

JoinAdmin.addLookupLocators(net.jini.core.discovery.LookupLocator[])

setLookupLocators

public void setLookupLocators(LookupLocator[] locators)
                       throws RemoteException

Description copied from interface: JoinAdmin

Replace the list of locators of specific lookup services to join with a new list. Leases are cancelled at lookup services that were in the old list but are not in the new list. Any new lookup services will be discovered and joined.

Specified by:

setLookupLocators in interface JoinAdmin

Parameters:

locators - locators of specific lookup services to join

Throws:

RemoteException

See Also:

JoinAdmin.getLookupLocators()

addMemberGroups

public void addMemberGroups(String[] groups)
                     throws NoSuchObjectException

Description copied from interface: DiscoveryAdmin

Adds the given set of names to the set whose elements are the names of the groups in which the lookup service is currently a member. Elements in the input set that duplicate names of groups in which the lookup service is already a member will be ignored. If the empty array (NO_GROUPS) is input, this method takes no action.

Specified by:

addMemberGroups in interface DiscoveryAdmin

Parameters:

groups - String array consisting of the names of the new, additional groups in which the lookup service is to be a member.

Throws:

NoSuchObjectException

removeMemberGroups

public void removeMemberGroups(String[] groups)
                        throws NoSuchObjectException

Description copied from interface: DiscoveryAdmin

Deletes the elements of the given set of names from the set whose elements are the names of the groups in which the lookup service is currently a member. Any element in the input set that is not a name of a group in which the lookup service is currently a member will be ignored. If the empty array (NO_GROUPS) is input, this method takes no action.

Specified by:

removeMemberGroups in interface DiscoveryAdmin

Parameters:

groups - String array consisting of the names to remove from the set whose elements are the names of the groups in which the lookup service is currently a member.

Throws:

NoSuchObjectException

getMemberGroups

public String[] getMemberGroups()
                         throws NoSuchObjectException

Description copied from interface: DiscoveryAdmin

Returns an array consisting of the names of the groups in which the lookup service is a member. If the lookup service currently belongs to no groups, this method will return the empty array.

Specified by:

getMemberGroups in interface DiscoveryAdmin

Returns:

String array consisting of the names of the groups in which the lookup service is a member

Throws:

NoSuchObjectException

setMemberGroups

public void setMemberGroups(String[] groups)
                     throws NoSuchObjectException

Description copied from interface: DiscoveryAdmin

Replaces the set whose elements are the names of the groups in which the lookup service is currently a member with the given set of group names. Elements in the input set that duplicate other elements in the input set will be ignored. If the empty array (NO_GROUPS) is input, then the lookup service will be a member of no groups.

Specified by:

setMemberGroups in interface DiscoveryAdmin

Parameters:

groups - String array consisting of the names of the new groups in which the lookup service is to be a member.

Throws:

NoSuchObjectException

getUnicastPort

public int getUnicastPort()
                   throws NoSuchObjectException

Description copied from interface: DiscoveryAdmin

Returns the port number on which the lookup service listens for unicast discovery queries.

Specified by:

getUnicastPort in interface DiscoveryAdmin

Returns:

an int representing the port number on which the lookup service listens for unicast discovery queries.

Throws:

NoSuchObjectException

setUnicastPort

public void setUnicastPort(int port)
                    throws IOException

Description copied from interface: DiscoveryAdmin

Changes the number of the port on which the lookup service is currently listening for unicast discovery queries to the given port number. If a value of zero is input, then the lookup service will first try to listen on the standard unicast discovery port, but if that fails, the lookup service will listen on an arbitrary port.

Specified by:

setUnicastPort in interface DiscoveryAdmin

Parameters:

port - int representing the new port number on which the lookup service should listen for unicast discovery queries.

Throws:

IOException - because an invocation of this method will result in the re-initiation of the unicast discovery process, which can throw an IOException when socket allocation occurs.

RemoteException - typically, this exception occurs when there is a communication failure between the client and the server.

destroy

public void destroy()
             throws RemoteException

Description copied from interface: DestroyAdmin

Destroy the service, if possible, including its persistent storage. This method should (in effect) spawn a separate thread to do the actual work asynchronously, and make a reasonable attempt to let this remote call return successfully. As such, a successful return from this method does not mean that the service has been destroyed. Although the service should make a reasonable attempt to let this remote call return successfully, the service must not wait indefinitely for other (in-progress and subsequent) remote calls to finish before proceeding to destroy itself. Once this method has been called, the service can, but need not, reject all other (in-progress and subsequent) remote calls to the service.

Specified by:

destroy in interface DestroyAdmin

Throws:

RemoteException

loadInitialLookupAttributes

protected List<Entry> loadInitialLookupAttributes()

getNIODetails

public NIODetails getNIODetails()
                         throws RemoteException

Description copied from interface: NIOInfoProvider

Returns the transport configuration. Note, does not change during application lifecycle, should be cached on the client side.

Specified by:

getNIODetails in interface NIOInfoProvider

Throws:

RemoteException

getNIOStatistics

public NIOStatistics getNIOStatistics()
                               throws RemoteException

Description copied from interface: NIOInfoProvider

Returns the transport statistics.

Specified by:

getNIOStatistics in interface NIOInfoProvider

Throws:

RemoteException

enableLRMIMonitoring

public void enableLRMIMonitoring()
                          throws RemoteException

Description copied from interface: NIOInfoProvider

Enables lrmi monitoring (gigaspaces internal remoting layer), this will cause the target to start track lrmi invocations which can later be viewed by calling. NIOInfoProvider.fetchLRMIMonitoringDetails()

Specified by:

enableLRMIMonitoring in interface NIOInfoProvider

Throws:

RemoteException

disableLRMIMonitoring

public void disableLRMIMonitoring()
                           throws RemoteException

Description copied from interface: NIOInfoProvider

Disabled lrmi monitoring (gigaspaces internal remoting layer). NIOInfoProvider.enableLRMIMonitoring()

Specified by:

disableLRMIMonitoring in interface NIOInfoProvider

Throws:

RemoteException

fetchLRMIMonitoringDetails

public LRMIMonitoringDetails fetchLRMIMonitoringDetails()
                                                 throws RemoteException

Description copied from interface: NIOInfoProvider

Return lrmi (gigaspaces internal remoting layer) services monitoring details. This will only work if lrmi monitoring was previously enabled, either by admin API, Jmx or system property. NIOInfoProvider.enableLRMIMonitoring()

Specified by:

fetchLRMIMonitoringDetails in interface NIOInfoProvider

Throws:

RemoteException

getCurrentTimestamp

public long getCurrentTimestamp()
                         throws RemoteException

Specified by:

getCurrentTimestamp in interface OSInfoProvider

Throws:

RemoteException

getOSDetails

public OSDetails getOSDetails()
                       throws RemoteException

Specified by:

getOSDetails in interface OSInfoProvider

Throws:

RemoteException

getOSStatistics

public OSStatistics getOSStatistics()
                             throws RemoteException

Specified by:

getOSStatistics in interface OSInfoProvider

Throws:

RemoteException

getJVMDetails

public JVMDetails getJVMDetails()
                         throws RemoteException

Specified by:

getJVMDetails in interface JVMInfoProvider

Throws:

RemoteException

getJVMStatistics

public JVMStatistics getJVMStatistics()
                               throws RemoteException

Specified by:

getJVMStatistics in interface JVMInfoProvider

Throws:

RemoteException

runGc

public void runGc()
           throws RemoteException

Specified by:

runGc in interface JVMInfoProvider

Throws:

RemoteException

logEntriesDirect

public LogEntries logEntriesDirect(LogEntryMatcher matcher)
                            throws RemoteException,
                                   IOException

Specified by:

logEntriesDirect in interface InternalLogProvider

Throws:

RemoteException

IOException