net.jini.admin
Interface JoinAdmin


public abstract interface JoinAdmin

The methods in this interface are used to control a service's participation in the join protocol. The object returned by the Administrable.getAdmin method should implement this interface, in addition to any other service-specific administration interfaces.

See Also:
Administrable.getAdmin()

Method Summary
 void addLookupAttributes(Entry[] attrSets)
          Add attribute sets for the service.
 void addLookupGroups(java.lang.String[] groups)
          Add new groups to the set to join.
 void addLookupLocators(LookupLocator[] locators)
          Add locators for specific new lookup services to join.
 Entry[] getLookupAttributes()
          Get the current attribute sets for the service.
 java.lang.String[] getLookupGroups()
          Get the list of groups to join.
 LookupLocator[] getLookupLocators()
          Get the list of locators of specific lookup services to join.
 void modifyLookupAttributes(Entry[] attrSetTemplates, Entry[] attrSets)
          Modify the current attribute sets, using the same semantics as ServiceRegistration.modifyAttributes.
 void removeLookupGroups(java.lang.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 setLookupGroups(java.lang.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.
 

Method Detail

getLookupAttributes

public Entry[] getLookupAttributes()
                            throws java.rmi.RemoteException
Get the current attribute sets for the service.
Returns:
the current attribute sets for the service
Throws:
java.rmi.RemoteException -  

addLookupAttributes

public void addLookupAttributes(Entry[] attrSets)
                         throws java.rmi.RemoteException
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.
Parameters:
attrSets - the attribute sets to add
Throws:
java.rmi.RemoteException -  

modifyLookupAttributes

public void modifyLookupAttributes(Entry[] attrSetTemplates,
                                   Entry[] attrSets)
                            throws java.rmi.RemoteException
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.
Parameters:
attrSetTemplates - the templates for matching attribute sets
attrSets - the modifications to make to matching sets
Throws:
java.rmi.RemoteException -  
See Also:
ServiceRegistration.modifyAttributes(net.jini.core.entry.Entry[], net.jini.core.entry.Entry[])

getLookupGroups

public java.lang.String[] getLookupGroups()
                                   throws java.rmi.RemoteException
Get the list of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).
Returns:
an array of groups to join. An empty array means the service joins no groups (as opposed to "all" groups).
Throws:
java.rmi.RemoteException -  

addLookupGroups

public void addLookupGroups(java.lang.String[] groups)
                     throws java.rmi.RemoteException
Add new groups to the set to join. Lookup services in the new groups will be discovered and joined.
Parameters:
groups - groups to join
Throws:
java.rmi.RemoteException -  

removeLookupGroups

public void removeLookupGroups(java.lang.String[] groups)
                        throws java.rmi.RemoteException
Remove groups from the set to join. Leases are cancelled at lookup services that are not members of any of the remaining groups.
Parameters:
groups - groups to leave
Throws:
java.rmi.RemoteException -  

setLookupGroups

public void setLookupGroups(java.lang.String[] groups)
                     throws java.rmi.RemoteException
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.
Parameters:
groups - groups to join
Throws:
java.rmi.RemoteException -  

getLookupLocators

public LookupLocator[] getLookupLocators()
                                  throws java.rmi.RemoteException
Get the list of locators of specific lookup services to join.
Returns:
the list of locators of specific lookup services to join
Throws:
java.rmi.RemoteException -  

addLookupLocators

public void addLookupLocators(LookupLocator[] locators)
                       throws java.rmi.RemoteException
Add locators for specific new lookup services to join. The new lookup services will be discovered and joined.
Parameters:
locators - locators of specific lookup services to join
Throws:
java.rmi.RemoteException -  

removeLookupLocators

public void removeLookupLocators(LookupLocator[] locators)
                          throws java.rmi.RemoteException
Remove locators for specific lookup services from the set to join. Any leases held at the lookup services are cancelled.
Parameters:
locators - locators of specific lookup services to leave
Throws:
java.rmi.RemoteException -  

setLookupLocators

public void setLookupLocators(LookupLocator[] locators)
                       throws java.rmi.RemoteException
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.
Parameters:
locators - locators of specific lookup services to join
Throws:
java.rmi.RemoteException -  


Copyright © 1999 Sun Microsystems, Inc. All rights reserved