GetUserNamesForGroupTag Class

com.bea.p13n.usermgmt.taglib
GetUserNamesForGroupTag Class

public class GetUserNamesForGroupTag

    extends UserManagementTag

Corresponds to <ugm:getUsernamesForGroup>.

The <ugm:getUsernamesForGroup> tag retrieves a String array that contains the usernames matching the provided search expression and correspond to members of the provided group. The search expression supports only the asterisk (*) wildcard character, and is case insensitive. As many asterisks as desired may be used in the search expression. The tag has no enclosed body.

The limit parameter will control how many results are returned; if the number of results returned equals the limit passed in, try refining the search.

Tag Attribute

Required

Type

Description

atnProvider

no

String

The name of the authentication provider containing the group.

The default provider will be used if not specified.

Example: "<%=atnProvider%>"

searchExp

no

String

The search expression to apply to the user name search.
Defaults to "*".

Example: "t*"

groupName

yes

String

The name of the group whose matching members are sought.

Example: "Engineering"

userLimit

no

String (representing an Integer)

The maximum number of users to be returned from the search. (String which has a particular Integer.valueOf)
Defaults to 100.

Example: "500"

id

yes

String

A variable name to which the resultant user names are assigned.

Example: "myUsers"

result

no

String

A variable name to which a constant describing the outcome of the operation will be assigned that can later be evaluated to see if the operation was successful.

Possible Values:
Success:
UserManagerTagConstants.USER_SEARCH_OK

Error encountered:
UserManagerTagConstants.USER_SEARCH_FAILED

Example: "if(result.intValue() == UserManagerTagConstants.USER_SEARCH_OK) // proceed"


Hierarchy
Object
  TagSupport
    UserManagementTag
      GetUserNamesForGroupTag
All Implemented Interfaces

IterationTag, Serializable, Tag, UserManagementTagConstants

Field Summary

   
Fields from  javax.servlet.jsp.tagext.TagSupport
id, pageContext
 
Fields from interface javax.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAIN
 
Fields from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Fields from interface com.bea.p13n.usermgmt.taglib.UserManagementTagConstants
ADD_GROUP_FAILED, ADD_GROUP_OK, ADD_USER_FAILED, ADD_USER_OK, CREATE_GROUP_FAILED, CREATE_GROUP_OK, CREATE_USER_FAILED, CREATE_USER_OK, DEFAULT_SEARCH_EXP, DEFAULT_USER_LIMIT, GET_PROFILE_FAILED, GET_PROFILE_OK, GROUP_CHANGE_FAILED, GROUP_CHANGE_OK, GROUP_EXISTS, LOGIN_ERROR, LOGIN_FAILED, LOGIN_OK, NO_SUCH_PROFILE, NO_SUCH_SUCCESSOR, REMOVE_GROUP_FAILED, REMOVE_GROUP_OK, REMOVE_USER_FAILED, REMOVE_USER_OK, RESERVED_GROUP_NAME, RESERVED_USER_NAME, SET_PASSWORD_FAILED, SET_PASSWORD_OK, SET_PROPERTY_FAILED, SET_PROPERTY_OK, USER_EXISTS, USER_LIMIT_EXCEEDED, USER_SEARCH_FAILED, USER_SEARCH_OK
 

Constructor Summary

GetUserNamesForGroupTag()

 

Method Summary

public int
doStartTag()
Go through the UserManager session bean to retrieve the usernames
public String
getAtnProvider()
Get the name of the authentication provider
public String
getGroupName()
Get the name of the group to query
public String
getResult()
Get the name of the variable to assign the result to
public String
getSearchExp()
Get the search expression
public int
getUserLimit()
Get the limit of users to return
public void
release()
Reset the tag's attributes
public void
setAtnProvider(String atnProvider)
Set the name of the authentication provider
public void
setGroupName(String groupName)
Set the name of the group to query
public void
setResult(String result)
Set the name of the variable to assign the result to
public void
setSearchExp(String searchExp)
Set the search expression
public void
setUserLimit(String userLimit)
Set the limit of users to return
public void
setUserLimit(int userLimit)
Set the limit of users to return
 
Methods from  com.bea.p13n.usermgmt.taglib.UserManagementTag
getAtnManagerProxy,
 
Methods from  javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue
 
Methods from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
   
Methods from interface javax.servlet.jsp.tagext.IterationTag
doAfterBody
 
Methods from interface javax.servlet.jsp.tagext.Tag
doEndTag, doStartTag, getParent, release, setPageContext, setParent
 

Constructor Detail

GetUserNamesForGroupTag

public GetUserNamesForGroupTag()
 

Method Detail

doStartTag() Method

public int doStartTag()
Go through the UserManager session bean to retrieve the usernames

Overrides
TagSupport.doStartTag()

getAtnProvider() Method

public String getAtnProvider()
Get the name of the authentication provider


getGroupName() Method

public String getGroupName()
Get the name of the group to query


getResult() Method

public String getResult()
Get the name of the variable to assign the result to


getSearchExp() Method

public String getSearchExp()
Get the search expression


getUserLimit() Method

public int getUserLimit()
Get the limit of users to return


release() Method

public void release()
Reset the tag's attributes

Overrides
UserManagementTag.release()

setAtnProvider(String) Method

public void setAtnProvider(String atnProvider)
Set the name of the authentication provider


setGroupName(String) Method

public void setGroupName(String groupName)
Set the name of the group to query


setResult(String) Method

public void setResult(String result)
Set the name of the variable to assign the result to


setSearchExp(String) Method

public void setSearchExp(String searchExp)
Set the search expression


setUserLimit(String) Method

public void setUserLimit(String userLimit)
Set the limit of users to return


setUserLimit(int) Method

public void setUserLimit(int userLimit)
Set the limit of users to return