/*
* This library is part of OpenCms -
* the Open Source Content Management System
*
* Copyright (c) Alkacon Software GmbH (http://www.alkacon.com)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* For further information about Alkacon Software GmbH, please see the
* company website: http://www.alkacon.com
*
* For further information about OpenCms, please see the
* project website: http://www.opencms.org
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package org.opencms.flex;
import org.opencms.file.CmsObject;
import org.opencms.file.CmsRequestContext;
import org.opencms.jsp.util.CmsJspStandardContextBean;
import org.opencms.loader.I_CmsResourceLoader;
import org.opencms.main.CmsLog;
import org.opencms.util.CmsCollectionsGenericWrapper;
import org.opencms.util.CmsRequestUtil;
import org.opencms.util.CmsUUID;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
import org.apache.commons.logging.Log;
/**
* Describes the caching behaviour (or caching options) for a Flex request.<p>
*
* @since 6.0.0
*/
public class CmsFlexRequestKey {
/** The log object for this class. */
private static final Log LOG = CmsLog.getLog(CmsFlexRequestKey.class);
/** The current container element. */
private String m_containerElement;
/** The request context this request was made in. */
private CmsRequestContext m_context;
/** Stores the device this request was made with. */
private String m_device;
/** The (Flex) Http request this key was constructed for. */
private HttpServletRequest m_request;
/** The OpenCms resource that this key is used for. */
private String m_resource;
/** The current detail view id. */
private CmsUUID m_detailViewId;
/**
* This constructor is used when building a cache key from a request.<p>
*
* The request contains several data items that are neccessary to construct
* the output. These items are e.g. the Query-String, the requested resource,
* the current time etc. etc.
* All required items are saved in the constructed cache - key.<p>
*
* @param req the request to construct the key for
* @param target the requested resource in the OpenCms VFS
* @param online must be true for an online resource, false for offline resources
*/
public CmsFlexRequestKey(HttpServletRequest req, String target, boolean online) {
// store the request
m_request = req;
// fetch the cms from the request
CmsObject cms = CmsFlexController.getCmsObject(req);
// store the request context
m_context = cms.getRequestContext();
// calculate the resource name
m_resource = CmsFlexCacheKey.getKeyName(m_context.addSiteRoot(target), online);
// calculate the device
m_device = CmsFlexController.getController(req).getCmsCache().getDeviceSelector().getDeviceType(req);
CmsJspStandardContextBean standardContext = CmsJspStandardContextBean.getInstance(req);
// get the current container element
m_containerElement = standardContext.elementCachingHash();
// get the current detail view id
m_detailViewId = standardContext.getDetailContentId();
if (LOG.isDebugEnabled()) {
LOG.debug(Messages.get().getBundle().key(Messages.LOG_FLEXREQUESTKEY_CREATED_NEW_KEY_1, m_resource));
}
}
/**
* Returns the request attributes.<p>
*
* @return the request attributes
*/
public Map<String, Object> getAttributes() {
Map<String, Object> attrs = CmsRequestUtil.getAtrributeMap(m_request);
if (attrs.size() == 0) {
return null;
}
return attrs;
}
/**
* Returns the current container element.<p>
*
* @return the current container element
*/
public String getContainerElement() {
return m_containerElement;
}
/**
* Returns the device.<p>
*
* @return the device
*/
public String getDevice() {
return m_device;
}
/**
* Returns the element.<p>
*
* @return the element
*/
public String getElement() {
return m_request.getParameter(I_CmsResourceLoader.PARAMETER_ELEMENT);
}
/**
* Returns the encoding.<p>
*
* @return the encoding
*/
public String getEncoding() {
return m_context.getEncoding();
}
/**
* Returns the ip.<p>
*
* @return the ip
*/
public String getIp() {
return m_context.getRemoteAddress();
}
/**
* Returns the locale.<p>
*
* @return the locale
*/
public String getLocale() {
return m_context.getLocale().toString();
}
/**
* Returns the parameters.<p>
*
* @return the parameters
*/
public Map<String, String[]> getParams() {
// get the params
Map<String, String[]> params = CmsCollectionsGenericWrapper.map(m_request.getParameterMap());
if (params.size() == 0) {
return null;
}
return params;
}
/**
* Returns the port.<p>
*
* @return the port
*/
public Integer getPort() {
return new Integer(m_request.getServerPort());
}
/**
* Returns the resource.<p>
*
* @return the resource
*/
public String getResource() {
return m_resource;
}
/**
* Returns the schemes.<p>
*
* @return the schemes
*/
public String getScheme() {
return m_request.getScheme().toLowerCase();
}
/**
* Returns the the current users session, or <code>null</code> if the current user
* has no session.<p>
*
* @return the current users session, or <code>null</code> if the current user has no session
*/
public HttpSession getSession() {
return m_request.getSession(false);
}
/**
* Returns the site root.<p>
*
* @return the site root
*/
public String getSite() {
return m_context.getSiteRoot();
}
/**
* Returns the uri.<p>
*
* @return the uri
*/
public String getUri() {
String uri = m_context.addSiteRoot(m_context.getUri());
if (m_detailViewId != null) {
uri += m_detailViewId.toString() + "/";
}
return uri;
}
/**
* Returns the user.<p>
*
* @return the user
*/
public String getUser() {
return m_context.getCurrentUser().getName();
}
}