com.jalios.jcms.handler

Class MemberQueryHandler

java.lang.Object

com.jalios.jcms.context.JcmsContext

com.jalios.jcms.context.JcmsJspContext

com.jalios.jcms.handler.JcmsFormHandler

com.jalios.jcms.handler.AbstractQueryHandler<E>

com.jalios.jcms.handler.AbstractMemberQueryHandler<Member>

com.jalios.jcms.handler.MemberQueryHandler

All Implemented Interfaces:

JcmsConstants, JaliosConstants

public class MemberQueryHandler
extends AbstractMemberQueryHandler<Member>

Holder class and form handler of all parameters to be used for a query of members.

Since:

jcms-5.7.4

Version:

$Revision: 109130 $

Nested Class Summary

Nested classes/interfaces inherited from class com.jalios.jcms.handler.AbstractQueryHandler

AbstractQueryHandler.HiddenParamQhPrinter, AbstractQueryHandler.QueryHandlerPrinter, AbstractQueryHandler.QueryStringQhPrinter

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	REVISION

Fields inherited from class com.jalios.jcms.handler.AbstractMemberQueryHandler

groupOffSet, groupSet, isMissingCriteria, pagerAll, pageSize, pageStart, reverse, sort

Fields inherited from class com.jalios.jcms.handler.JcmsFormHandler

contextMap, editFieldSet, formStep, noRedirect, noSendRedirect, popupEdition, redirect, redirectOnClosePopup, workspaceForced

Fields inherited from class com.jalios.jcms.context.JcmsJspContext

AJAX_REQUEST_ATTRIBUTES, BODY_HEADER, CSS_FOOTER, CSS_HEADER, cssboMap, cssfoMap, CUSTOM_HEADER, editIcon, HTTPEQUIV_HEADER, httpequivMap, HTTPNAME_HEADER, httpnameMap, initEditIcon, JAVASCRIPT_CODE_SET_ATTRIBUTE, JAVASCRIPT_SET_ATTRIBUTE, jsboSet, jsfoSet, out, pageContext, SHOW_EDIT_ICON, STYLE_HEADER

Fields inherited from class com.jalios.jcms.context.JcmsContext

browser, caddy, channel, inFO, initDone, initWorkspace, isAdmin, isAjaxRequest, isDBMember, isDebug, isLogged, loggedMember, request, response, userCountry, userLang, userLocale, workspace

Fields inherited from interface com.jalios.jcms.JcmsConstants

ADATE_SEARCH, ADMIN_NOTES_PROP, ADVANCED_TAB, AJAX_MODE_ATTR, ARCHIVES_DIR, ASCII_WIDTH, CATEGORY_TAB, CDATE_SEARCH, COMMON_ALARM, CONTENT_TAB, COOKIE_MAX_AGE, COUNTRY_SPRITE, CTRL_TOPIC_INTERNAL, CTRL_TOPIC_REF, CTRL_TOPIC_VALUE, CTRL_TOPIC_WRITE, CUSTOM_PROP, DOCCHOOSER_HEIGHT, DOCCHOOSER_WIDTH, DOCS_DIR, EDATE_SEARCH, EMAIL_REGEXP, ERROR_MSG, FORBIDDEN_FILE_ACCESS, FORBIDDEN_REDIRECT, FORCE_REDIRECT, GLYPH_ICON_PREFIX, ICON_ARCHIVE, ICON_ICON_PREFIX, ICON_LOCK, ICON_LOCK_STRONG, ICON_PREFIX_PROP, ICON_WARN, ICON_WH_BOOK_CLOSED, ICON_WH_BOOK_OPEN, INFORMATION_MSG, JALIOS_JUNIT_PROP, JCMS_CADDY, JCMS_MSG_LIST, JSYNC_DOWNLOAD_DIR, JSYNC_SYNC_ALARM, LANG_SPRITE, LOG_FILE, LOG_TOPIC_SECURITY, LOGGER_PROP, LOGGER_XMLPROP, MBR_PHOTO_DIR, MDATE_SEARCH, MONITOR_XML, OP_CREATE, OP_CREATE_STR, OP_DEEP_COPY, OP_DEEP_COPY_STR, OP_DEEP_DELETE, OP_DEEP_DELETE_STR, OP_DELETE, OP_DELETE_STR, OP_MERGE, OP_MERGE_STR, OP_UPDATE, OP_UPDATE_STR, PDATE_SEARCH, PHOTO_DIR, PHOTO_ICON, PHOTO_ICON_HEIGHT, PHOTO_ICON_PROP_PREFIX, PHOTO_ICON_WIDTH, PHOTO_LARGE, PHOTO_LARGE_HEIGHT, PHOTO_LARGE_PROP_PREFIX, PHOTO_LARGE_WIDTH, PHOTO_NORMAL, PHOTO_NORMAL_HEIGHT, PHOTO_NORMAL_PROP_PREFIX, PHOTO_NORMAL_WIDTH, PHOTO_SMALL, PHOTO_SMALL_HEIGHT, PHOTO_SMALL_PROP_PREFIX, PHOTO_SMALL_WIDTH, PHOTO_TINY, PHOTO_TINY_HEIGHT, PHOTO_TINY_PROP_PREFIX, PHOTO_TINY_WIDTH, PREVIOUS_TAB, PRINT_VIEW, PRIVATE_FILE_ACCESS, PUBLIC_FILE_ACCESS, READ_RIGHT_TAB, SDATE_SEARCH, SEARCHENGINE_ALARM, SESSION_AUTHORIZED_FILENAMES_SET, SPRITE_ICON_PREFIX, STATS_REPORT_DIR, STATUS_PROP, STORE_XML, SUCCESS_MSG, TEMPLATE_TAB, THUMBNAIL_LARGE_HEIGHT, THUMBNAIL_LARGE_WIDTH, THUMBNAIL_SMALL_HEIGHT, THUMBNAIL_SMALL_WIDTH, TTCARD_MEDIA_HEIGHT, TTCARD_MEDIA_WIDTH, TYPES_ICON_ALT_PROP, TYPES_ICON_SUFFIX_PROP, TYPES_ICON_TITLE_PROP, TYPES_PREFIX_PROP, TYPES_THUMB_SUFFIX_PROP, UDATE_SEARCH, UPDATE_RIGHT_TAB, UPLOAD_DIR, URL_REGEXP, WARNING_MSG, WEBAPP_PROP, WFEXPRESS_ALARM, WFREMINDER_ALARM, WORKFLOW_TAB, WORKFLOW_XML

Fields inherited from interface com.jalios.util.JaliosConstants

CRLF, MILLIS_IN_ONE_DAY, MILLIS_IN_ONE_HOUR, MILLIS_IN_ONE_MINUTE, MILLIS_IN_ONE_MONTH, MILLIS_IN_ONE_SECOND, MILLIS_IN_ONE_WEEK, MILLIS_IN_ONE_YEAR

Constructor Summary

Constructors

Constructor and Description
MemberQueryHandler() Constructs a new empty MemberQueryHandler with default option.
MemberQueryHandler(java.lang.String queryString) Constructs a new MemberQueryHandler by parsing the specified query string.
MemberQueryHandler(java.lang.String queryString, javax.servlet.http.HttpServletRequest request) Constructs a new MemberQueryHandler by parsing the specified query string and using informations available from the specified request (logged member, user language, etc).

Method Summary

Methods

Modifier and Type	Method and Description
boolean	getAdmin() Retrieve the value of the administrator filter.
protected org.apache.log4j.Logger	getLogger()
java.util.Set<Member>	getResultSet() Return results of a query done using this MemberQueryHandler.
java.util.Set<Member>	getResultSet(java.util.Comparator<? super Member> comparator) Return results of a query done using this GroupQueryHandler.
boolean	getWorker() Retrieve the value of the worker filter.
boolean	isAdminFilterEnabled() Retrieve whether the admin filter is used or not for this query
boolean	isWorkerFilterEnabled() Retrieve whether the worker filter is used or not for this query
protected void	parseQueryStringParam(java.lang.String key, java.lang.String[] values) Method to be implemented by subclass to decode parameter from queryString.
protected java.lang.String	printParams(AbstractQueryHandler.QueryHandlerPrinter printer) Print current QueryHandler params using specified QueryHandlerPrinter.
void	setAdmin(boolean admin) Set the administrator filter option.
void	setAdminFilterEnabled(boolean enabled) Set whether the admin filter is used or not for this query
void	setWorker(boolean worker) Set the worker filter option.
void	setWorkerFilterEnabled(boolean enabled) Set whether the worker filter is used or not for this query
java.lang.String	toString()

Methods inherited from class com.jalios.jcms.handler.AbstractMemberQueryHandler

getEnabled, getGid, getGids, getGidsOff, getGroupOffSet, getGroupSet, getPageSize, getRefinedWorkspace, getSort, getStart, getText, getUsage, isMissingCriteria, isPagerAll, isReverse, setEnabled, setGid, setGids, setGidsOff, setGroupOffSet, setGroupSet, setPagerAll, setPageSize, setReverse, setSort, setStart, setText, setUsage, setWorkspace, setWrkspc

Methods inherited from class com.jalios.jcms.handler.AbstractQueryHandler

getAttribute, getAttributeMap, getDataSet, getHiddenParams, getQueryString, init, parseQueryString, removeAttribute, setAttribute, setDataSet

Methods inherited from class com.jalios.jcms.handler.JcmsFormHandler

afterValidation, checkMissingField, getAvailableMainLanguage, getClosePopupUrl, getControllerContext, getEditFieldSet, getFormStep, getFormStepCount, getFormStepFinishLabel, getFormStepHiddenFields, getFormStepLabels, getFormStepPrefixProp, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenField, getHiddenFieldML, getMainLangValue, getMainLangValueArray, getMLMap, getMLMapArray, getModalRedirect, getRedirect, getRedirectOnClosePopup, getWorkspace, init, isFieldEdition, isFieldMissing, isPartialFieldEdition, isPopupEdition, isWorkspaceForced, processAction, processStatus, sendRedirect, sendRedirect, setEditField, setFormStep, setNoRedirect, setNoSendRedirect, setPopupEdition, setRedirect, setRedirectOnClosePopup, setWs, showCancelButton, showFinishButton, showNextButton, showPreviousButton, updateUploadedField, updateUploadedFields, validate

Methods inherited from class com.jalios.jcms.context.JcmsJspContext

addBodyAttributes, addCSSHeader, addCSSHeader, addCSSHeader, addCSSHeader, addCustomHeader, addHttpEquivHeader, addHttpNameHeader, addJavaScript, addJavaScript, addJavaScript, addJavaScriptCode, addPrefetchHeader, addStyleHeader, addStyleHeader, checkAccess, checkAccess, checkCSRF, debugDisplayContext, disablePacker, forceEditIcon, forceUpdate, getAjaxRequestAttribute, getAjaxRequestId, getAllHeadersDiffMap, getAllHeadersMap, getBackOfficeCSSHeader, getBackOfficeJavaScriptSet, getBodyAttributes, getContentForm, getCSSHeaders, getCtxCategories, getCurrentCategory, getCustomHeaders, getDocType, getFinalCSSFooterMap, getFinalCSSMap, getFinalJavaScriptSet, getFormElementCount, getFrontOfficeCSSHeader, getFrontOfficeJavaScriptSet, getHttpEquivHeaders, getHttpNameHeaders, getJavaScriptCodeSet, getJavaScriptSet, getJSONBridge, getPackVersion, getPageContext, getPageTitle, getPageZone, getPortal, getPortalCategory, getPortlet, getPublication, getStyleHeaders, getTemplateUsage, internalSetupEmptyHeader, isEditIcon, isEditIcon, isEditIconForPublish, isEditIconForPublish, isPrintView, registerDisplayContext, removeAjaxRequestAttribute, setAjaxRequestAttribute, setAjaxRequestId, setAllHeadersDiffMap, setDocType, setEditIcon, setFormElementCount, setPageContext, setPageTitle, setPageZone, setShowEditIcon, setTemplateUsage, showEditIcon, showEditIcon, showEditIcon, workaroundBrowserBaseHrefBug

Methods inherited from class com.jalios.jcms.context.JcmsContext

addCookie, addMsg, addMsg, addMsgSession, addMsgSession, applySelector, forceWorkspaceUpdate, getBaseUrl, getBrowser, getCaddy, getContextPath, getErrorMsg, getErrorMsgList, getErrorMsgSession, getErrorMsgSessionList, getInfoMsg, getInfoMsgList, getInfoMsgSession, getInfoMsgSessionList, getLoggedMember, getMsgList, getMsgSessionList, getRequest, getResponse, getSession, getSuccessMsg, getSuccessMsgList, getSuccessMsgSession, getSuccessMsgSessionList, getUploadedFile, getUploadedFileList, getUrlWithCommonUpdatedParams, getUserCountry, getUserLang, getUserLocale, getWarningMsg, getWarningMsgList, getWarningMsgSession, getWarningMsgSessionList, glp, isAdmin, isAjaxRequest, isDBMember, isDebug, isInFrontOffice, isLogged, isWebdavAccess, removeMessage, removeMessage, retrieveUploadedFile, select, sendForbidden, sendForbidden, sendRedirect, sendRedirect, sendRedirect, setErrorMsg, setErrorMsg, setErrorMsgSession, setErrorMsgSession, setInfoMsg, setInfoMsg, setInfoMsgSession, setInfoMsgSession, setLoggedMember, setRequest, setResponse, setSuccessMsg, setSuccessMsg, setSuccessMsgSession, setSuccessMsgSession, setWarningMsg, setWarningMsg, setWarningMsgSession, setWarningMsgSession, validateRegexp, validateSchedule

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

REVISION

public static final java.lang.String REVISION

See Also:

Constant Field Values

Constructor Detail

MemberQueryHandler

public MemberQueryHandler()

Constructs a new empty MemberQueryHandler with default option.

Since:

jcms-5.7.4

MemberQueryHandler

public MemberQueryHandler(java.lang.String queryString)

Constructs a new MemberQueryHandler by parsing the specified query string.

See MemberQueryHandler(String, HttpServletRequest) for a list of the decoded parameters.

Parameters:

queryString - a query String consisting of parameters (key=value) to be set in this handler.

• Parameters must be separated with ampersand (&).
• Values must be encoded in UTF-8.
• Query must not starts with question mark (?)
e.g : "text=welcome&gid=j_42"

Since:

jcms-5.7.4

MemberQueryHandler

public MemberQueryHandler(java.lang.String queryString,
                  javax.servlet.http.HttpServletRequest request)

Constructs a new MemberQueryHandler by parsing the specified query string and using informations available from the specified request (logged member, user language, etc).

The following parameters (and only those listed here) will be automatically decoded from the specified query string. Other parameters should be set using apropriate setters.

• "text" : AbstractMemberQueryHandler.setText(String)
• "gid" : AbstractMemberQueryHandler.setGid(String)
• "gids" : AbstractMemberQueryHandler.setGids(String[])
• "wrkspc" : AbstractMemberQueryHandler.setWrkspc(String)
• "usage" : AbstractMemberQueryHandler.setUsage(int)
• "enabled" : AbstractMemberQueryHandler.setEnabled(Boolean)
• "admin" : setAdmin(boolean)
• "worker" : setWorker(boolean)

Parameters:

queryString - a query String consisting of parameters (key=value) to be set in this handler.

• Parameters must be separated with ampersand (&).
• Values must be encoded in UTF-8.
• Query must not starts with question mark (?)
e.g : "text=welcome&gid=j_42"

request - the HttpServletRequest to use to retrieve loggedMember, userLang, userLocale that will be used by this handler, ignored if null.

Since:

jcms-5.7.4

Method Detail

getLogger

protected org.apache.log4j.Logger getLogger()

Specified by:

getLogger in class AbstractQueryHandler<Member>

parseQueryStringParam

protected void parseQueryStringParam(java.lang.String key,
                         java.lang.String[] values)

Description copied from class: AbstractQueryHandler

Method to be implemented by subclass to decode parameter from queryString.

Overrides:

parseQueryStringParam in class AbstractMemberQueryHandler<Member>

Parameters:

key - the parameter name, never null nor empty.

values - the parameter values, NEVER NULL NOR EMPTY. You can safely invoke paramValues[0]

printParams

protected java.lang.String printParams(AbstractQueryHandler.QueryHandlerPrinter printer)

Print current QueryHandler params using specified QueryHandlerPrinter.

Overrides:

printParams in class AbstractMemberQueryHandler<Member>

Parameters:

printer - a QueryHandlerPrinter to use

Returns:

a string containing all parameters of this handler printed using specified QueryHandlerPrinter.

Since:

jcms-5.7.4

toString

public java.lang.String toString()

Overrides:

toString in class AbstractMemberQueryHandler<Member>

getResultSet

public java.util.Set<Member> getResultSet()

Return results of a query done using this MemberQueryHandler.

Warning: This method process the query each time it is invoked, therefore do not call it multiple times if you don't need it.

Returns:

a new Set containing all Member found by this query.

Since:

jcms-5.7.4

getResultSet

public java.util.Set<Member> getResultSet(java.util.Comparator<? super Member> comparator)

Return results of a query done using this GroupQueryHandler.

Warning: This method process the query each time it is invoked, therefore do not call it multiple times if you don't need it.

Parameters:

comparator - the optionnal Comparator to sort the return collection

Returns:

a new Set containing all Member found by this query, sorted using specified comparator if any.

Since:

jcms-5.7.4

setAdmin

public void setAdmin(boolean admin)

Set the administrator filter option.

Automatically invoke setAdminFilterEnabled(boolean)) to enable filter.

Parameters:

admin - true to retrieve only administrators, false to retrieve all but administrators

Since:

jcms-6.1.0

getAdmin

public boolean getAdmin()

Retrieve the value of the administrator filter.

Important : this value is used only if isAdminFilterEnabled is true !

Returns:

true to retrieve only administrators, false to retrieve all but administrators

Since:

jcms-6.1.0

setAdminFilterEnabled

public void setAdminFilterEnabled(boolean enabled)

Set whether the admin filter is used or not for this query

Parameters:

enabled - true if the value of getAdmin() is used for this query, false otherwise.

Since:

jcms-6.1.0

isAdminFilterEnabled

public boolean isAdminFilterEnabled()

Retrieve whether the admin filter is used or not for this query

Returns:

true if the value of getAdmin() is used for this query, false otherwise.

Since:

jcms-6.1.0

setWorker

public void setWorker(boolean worker)

Set the worker filter option.

Automatically invoke setWorkerFilterEnabled(boolean)) to enable filter.

Parameters:

worker - true to retrieve only workers only, false to retrieve all but workers

Since:

jcms-6.1.0

getWorker

public boolean getWorker()

Retrieve the value of the worker filter.

Important : this value is used only if isWorkerFilterEnabled is true !

Returns:

true to retrieve only workers only, false to retrieve all but workers

Since:

jcms-6.1.0

setWorkerFilterEnabled

public void setWorkerFilterEnabled(boolean enabled)

Set whether the worker filter is used or not for this query

Parameters:

enabled - true if the value of getWorker() is used for this query, false otherwise.

Since:

jcms-6.1.0

isWorkerFilterEnabled

public boolean isWorkerFilterEnabled()

Retrieve whether the worker filter is used or not for this query

Returns:

true if the value of getWorker() is used for this query, false otherwise.

Since:

jcms-6.1.0