Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-02

weblogic.management.security.authentication
Interface GroupReaderMBean

All Superinterfaces:
DescriptorBean, ListerMBean, NameListerMBean, SettableBean, StandardInterface
All Known Subinterfaces:
ActiveDirectoryAuthenticatorMBean, DefaultAuthenticatorMBean, GroupEditorMBean, GroupMemberListerMBean, GroupUserListerMBean, IPlanetAuthenticatorMBean, LDAPAuthenticatorMBean, MemberGroupListerMBean, NovellAuthenticatorMBean, OpenLDAPAuthenticatorMBean, OracleInternetDirectoryAuthenticatorMBean, OracleVirtualDirectoryAuthenticatorMBean, ReadOnlySQLAuthenticatorMBean, SQLAuthenticatorMBean, WindowsNTAuthenticatorMBean

public interface GroupReaderMBean
extends NameListerMBean

Provides a set of methods for reading data about groups. An Authentication provider MBean can optionally implement this MBean. The WebLogic Server Administration Console detects when an Authentication provider implements this MBean and automatically provides a tab for using these methods.


Method Summary
 String getGroupDescription(String groupName)
          Gets a group's description.
 boolean groupExists(String groupName)
          Indicates whether the specified group exists.
 boolean isMember(String parentGroupName, String memberUserOrGroupName, boolean recursive)
          Indicates whether a user or group is a member of the group that you specify.
 String listGroups(String groupNameWildcard, int maximumToReturn)
          Searches for a user name that matches a pattern.
 
Methods inherited from interface weblogic.management.utils.NameListerMBean
getCurrentName
 
Methods inherited from interface weblogic.management.utils.ListerMBean
advance, close, haveCurrent
 
Methods inherited from interface weblogic.management.commo.StandardInterface
getName
 
Methods inherited from interface weblogic.descriptor.DescriptorBean
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
 
Methods inherited from interface weblogic.descriptor.SettableBean
isSet, unSet
 

Method Detail

listGroups

String listGroups(String groupNameWildcard,
                  int maximumToReturn)
                  throws InvalidParameterException
Searches for a user name that matches a pattern.

This method returns a cursor that you can pass to the methods from weblogic.management.utils.NameListerMBean (which this MBean extends) to iterate through the returned list.

This method does not sort the results.

Parameters:
groupNameWildcard - -

The pattern for which this method searches. The pattern can end with an * (asterisk) as a wildcard, which matches any string of characters. The search is not case-sensitive.

For example, a pattern of abc matches exactly one group name that contains only abc, a pattern of ab* matches all group names that start with ab, and a pattern of * matches all group names.

maximumToReturn - - The maximum number of group names that this method returns. If there are more matches than this maximum, then the returned results are arbitrary because this method does not sort results. If the parameter is set to 0 there is no maximum and all results are returned.
Throws:
InvalidParameterException

groupExists

boolean groupExists(String groupName)
                    throws InvalidParameterException
Indicates whether the specified group exists.

Parameters:
groupName - - The name that this method evaluates.
Throws:
InvalidParameterException

getGroupDescription

String getGroupDescription(String groupName)
                           throws NotFoundException,
                                  InvalidParameterException
Gets a group's description.

Parameters:
groupName - - The name of an existing group.
Throws:
NotFoundException
InvalidParameterException

isMember

boolean isMember(String parentGroupName,
                 String memberUserOrGroupName,
                 boolean recursive)
                 throws NotFoundException,
                        InvalidParameterException
Indicates whether a user or group is a member of the group that you specify. A recursive search returns true if the member belongs to the group that you specify or to any of the groups contained within that group."

Parameters:
parentGroupName - - The existing group within which this method searches for membership.
memberUserOrGroupName - - The user or group name for which this method searches.
recursive - - If set to true, the criteria for membership extends to any groups within the group that is specified by parentGroupName.

If this argument is set to false, then this method checks only for direct membership within the parentGroupName.

Throws:
NotFoundException
InvalidParameterException

Copyright 1996, 2013, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-02