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
| |
| |
| |
| |