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