UserReaderMBean (Abstract)
Overview | Related MBeans | Attributes | Operations
Overview
Provides a set of methods for reading data about users. 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.
Fully Qualified Interface Name If you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.security.authentication.UserReaderMBean
Factory Methods No factory methods. Instances of this MBean are created automatically. Subtypes The following MBeans extend or implement this MBean type:
Operations
This section describes the following operations:
advance
Advances the list to the next element in the list.
Operation Name "advance"Parameters Object [] { cursor }where:
cursor is an object of typejava.lang.String that specifies:
- The cursor returned from a previous list method.
Signature String [] { "java.lang.String" }Returns voidExceptions
weblogic.management.utils.InvalidCursorException
close
Indicates that the caller is finished using the list, and that the resources held on behalf of the list may be released. If the caller traverses through all the elements in the list, the caller need not call this method. In other words, it is used to let the caller close the list without reading each element that is returned.
Operation Name "close"Parameters Object [] { cursor }where:
cursor is an object of typejava.lang.String that specifies:
- The cursor returned from a previous list method.
Signature String [] { "java.lang.String" }Returns voidExceptions
weblogic.management.utils.InvalidCursorException
getCurrentName
The name of the current item in the list. Returns null if there is no current item.
Operation Name "getCurrentName"Parameters Object [] { cursor }where:
cursor is an object of typejava.lang.String that specifies:
- The cursor returned from a previous list method.
Signature String [] { "java.lang.String" }Returns StringExceptions
weblogic.management.utils.InvalidCursorException
getUserDescription
Gets a user's description.
Operation Name "getUserDescription"Parameters Object [] { userName }where:
userName is an object of typejava.lang.String that specifies:
- The name of an existing user.
Signature String [] { "java.lang.String" }Returns StringExceptions
weblogic.management.utils.NotFoundException
weblogic.management.utils.InvalidParameterException
haveCurrent
Returns true if there are more objects in the list, and false otherwise.
Operation Name "haveCurrent"Parameters Object [] { cursor }where:
cursor is an object of typejava.lang.String that specifies:
- The cursor returned from a previous list method.
Signature String [] { "java.lang.String" }Returns booleanExceptions
weblogic.management.utils.InvalidCursorException
isSet
Returns true if the specified attribute has been set explicitly in this MBean instance.
Operation Name "isSet"Parameters Object [] { propertyName }where:
propertyName is an object of typejava.lang.String that specifies:
property to check
Signature String [] { "java.lang.String" }Returns booleanExceptions
java.lang.IllegalArgumentException
listUsers
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.
Operation Name "listUsers"Parameters Object [] { userNameWildcard, maximumToReturn }where:
userNameWildcard is an object of typejava.lang.String that specifies:
- 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 user name that contains onlyabc, a pattern ofab* matches all user names that start withab, and a pattern of* matches all user names.maximumToReturn is an object of typejava.lang.Integer that specifies:
- The maximum number of user 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.
Signature String [] { "java.lang.String", "java.lang.Integer" }Returns StringExceptions
weblogic.management.utils.InvalidParameterException
unSet
Restore the given property to its default value.
Operation Name "unSet"Parameters Object [] { propertyName }where:
propertyName is an object of typejava.lang.String that specifies:
property to restore
Signature String [] { "java.lang.String" }Returns voidExceptions
java.lang.IllegalArgumentException
UnsupportedOperationException if called on a runtime implementation.
userExists
Indicates whether the specified user exists.
Operation Name "userExists"Parameters Object [] { userName }where:
userName is an object of typejava.lang.String that specifies:
- The name that this method evaluates.
Signature String [] { "java.lang.String" }Returns booleanExceptions
weblogic.management.utils.InvalidParameterException
wls_getDisplayName
Operation Name "wls_getDisplayName"Parameters nullSignature nullReturns String