DiscoveryPermission on each of the groups in the new set, otherwise a SecurityException will be propagated through this method.
@param groups String array consisting of the group namesto add to the managed set.
@throws java.io.IOException because an invocation of this method mayresult in the re-initiation of the discovery process, which can throw an IOException when socket allocation occurs.
@throws java.lang.UnsupportedOperationException this exception occurs when there is no managed set of groups to augment. That is, the current managed set of groups is null. If the managed set of groups is null, all groups are being discovered; thus, requesting that a set of groups be added to the set of all groups makes no sense.
@throws java.lang.NullPointerException this exception occurs wheneither null is input to the groups parameter, or one or more of the elements of the groups parameter is null. If a null is input, then the entity is effectively requesting that "all groups" be added to the current managed set of groups; which is not allowed. (Note that if the entity wishes to change the managed set of groups from a finite set of names to "all groups", the setGroups method should be invoked with null input.)
@see #removeGroups
terminate method has been called.
@throws java.lang.UnsupportedOperationException there is no set ofgroups to add to
@see DiscoveryPermission
If any element of this parameter duplicates any other element of this parameter, the duplicate will be ignored. If any element of this parameter duplicates any element of the registration's current managed set of groups, the duplicate will be ignored.
If the empty set (equivalent to net.jini.discovery.LookupDiscovery.NO_GROUPS) is input, then this registration's managed set of groups will not change.
If null (equivalent to net.jini.discovery.LookupDiscovery.ALL_GROUPS) is input, this method will throw a NullPointerException. @throws java.lang.UnsupportedOperationException this exception occurswhen the lookup discovery service has no managed set of groups associated with this registration. @throws java.lang.NullPointerException this exception occurs wheneither null (net.jini.discovery.LookupDiscovery.ALL_GROUPS) is input to the groups parameter, or one or more of the elements of the groups parameter is null. @throws java.rmi.RemoteException typically, this exception occurs whenthere is a communication failure between the client and the lookup discovery service. When this exception does occur, this registration's managed set of groups may or may not have been successfully augmented. @see #removeGroups
| |
| |
| |
| |