<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Interface java.security.acl.Group
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.security.acl.html">This Package</a>  <a href="java.security.acl.AclEntry.html#_top_">Previous</a>  <a href="java.security.acl.Owner.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Interface java.security.acl.Group
</h1>
<dl>
  <dt> public interface <b>Group</b>
  <dt> extends <a href="java.security.Principal.html#_top_">Principal</a>
</dl>
This interface is used to represent a group of principals. (A principal
 represents an entity such as an individual user or a company). <p>     
 Note that Group extends Principal. Thus, either a Principal or a Group can 
 be passed as an argument to methods containing a Principal parameter. For 
 example, you can add either a Principal or a Group to a Group object by 
 calling the object's <code>addMember</code> method, passing it the 
 Principal or Group.
<p>
<hr>
<a name="index"></a>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#addMember(java.security.Principal)"><b>addMember</b></a>(Principal)
  <dd>  Adds the specified member to the group.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#isMember(java.security.Principal)"><b>isMember</b></a>(Principal)
  <dd>  Returns true if the passed principal is a member of the group.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#members()"><b>members</b></a>()
  <dd>  Returns an enumeration of the members in the group.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#removeMember(java.security.Principal)"><b>removeMember</b></a>(Principal)
  <dd>  Removes the specified member from the group.
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="addMember(java.security.Principal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="addMember"><b>addMember</b></a>
<pre>
 public abstract boolean addMember(<a href="java.security.Principal.html#_top_">Principal</a> user)
</pre>
<dl>
  <dd> Adds the specified member to the group.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> user - the principal to add to this group.
    <dt> <b>Returns:</b>
    <dd> true if the member was successfully added,
 false if the principal was already a member.
  </dl></dd>
</dl>
<a name="removeMember(java.security.Principal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="removeMember"><b>removeMember</b></a>
<pre>
 public abstract boolean removeMember(<a href="java.security.Principal.html#_top_">Principal</a> user)
</pre>
<dl>
  <dd> Removes the specified member from the group.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> user - the principal to remove from this group.
    <dt> <b>Returns:</b>
    <dd> true if the principal was removed, or
 false if the principal was not a member.
  </dl></dd>
</dl>
<a name="isMember(java.security.Principal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="isMember"><b>isMember</b></a>
<pre>
 public abstract boolean isMember(<a href="java.security.Principal.html#_top_">Principal</a> member)
</pre>
<dl>
  <dd> Returns true if the passed principal is a member of the group. 
 This method does a recursive search, so if a principal belongs to a 
 group which is a member of this group, true is returned.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> member - the principal whose membership is to be checked.
    <dt> <b>Returns:</b>
    <dd> true if the principal is a member of this group,
 false otherwise.
  </dl></dd>
</dl>
<a name="members()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="members"><b>members</b></a>
<pre>
 public abstract <a href="java.util.Enumeration.html#_top_">Enumeration</a> members()
</pre>
<dl>
  <dd> Returns an enumeration of the members in the group.
 The returned objects can be instances of either Principal 
 or Group (which is a subclass of Principal).
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> an enumeration of the group members.
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.security.acl.html">This Package</a>  <a href="java.security.acl.AclEntry.html#_top_">Previous</a>  <a href="java.security.acl.Owner.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
