org.opencms.db.CmsDbContext Maven / Gradle / Ivy
Show all versions of opencms-core Show documentation
/*
* This library is part of OpenCms -
* the Open Source Content Management System
*
* Copyright (c) Alkacon Software GmbH & Co. KG (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 & Co. KG, 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.db;
import org.opencms.file.CmsProject;
import org.opencms.file.CmsRequestContext;
import org.opencms.file.CmsUser;
import org.opencms.file.CmsVfsException;
import org.opencms.flex.CmsFlexRequestContextInfo;
import org.opencms.i18n.CmsMessageContainer;
import org.opencms.main.CmsException;
import org.opencms.main.CmsRuntimeException;
import org.opencms.report.I_CmsReport;
import org.opencms.util.CmsRequestUtil;
import org.opencms.util.CmsUUID;
import java.util.HashMap;
import java.util.Map;
/**
* Wraps context information to access the OpenCms database.
*
* @since 6.0.0
*/
public class CmsDbContext {
/** Context attributes. */
protected Map m_attributes;
/** The current Flex request context info (if available). */
protected CmsFlexRequestContextInfo m_flexRequestContextInfo;
/** The id of the project for the context. */
protected CmsUUID m_projectId;
/** The wrapped user request context. */
protected CmsRequestContext m_requestContext;
/**
* Creates a new, empty database context.
*/
public CmsDbContext() {
this(null);
}
/**
* Creates a new database context initialized with the given user request context.
*
* @param context the current users request context
*/
public CmsDbContext(CmsRequestContext context) {
m_requestContext = context;
m_projectId = CmsUUID.getNullUUID();
if (m_requestContext != null) {
m_flexRequestContextInfo = (CmsFlexRequestContextInfo)m_requestContext.getAttribute(
CmsRequestUtil.HEADER_LAST_MODIFIED);
}
}
/**
* Clears this database context.
*/
public void clear() {
m_requestContext = null;
m_flexRequestContextInfo = null;
}
/**
* Returns the current users project.
*
* @return the current users project
*/
public CmsProject currentProject() {
return m_requestContext.getCurrentProject();
}
/**
* Returns the current user.
*
* @return the current user
*/
public CmsUser currentUser() {
return m_requestContext.getCurrentUser();
}
/**
* Get an attribute from the DB context.
*
* @param key the attribute key
*
* @return the attribute value or null if the attribute does not exist
*/
public Object getAttribute(String key) {
if (m_attributes == null) {
return null;
}
return m_attributes.get(key);
}
/**
* Returns the current Flex request context info.
*
* @return the current Flex request context info
*/
public CmsFlexRequestContextInfo getFlexRequestContextInfo() {
return m_flexRequestContextInfo;
}
/**
* Gets the history driver associated with this database context.
*
* @param projectId the project id for which the history driver should be retrieved
*
* @return the history driver
*/
public I_CmsHistoryDriver getHistoryDriver(CmsUUID projectId) {
return null;
}
/**
* Gets the project driver associated with this database context.
*
* @param projectId the project id for which the project driver should be retrieved
*
* @return the project driver
*/
public I_CmsProjectDriver getProjectDriver(CmsUUID projectId) {
return null;
}
/**
* Returns the project id of the context.
*
* @return the project
*/
public CmsUUID getProjectId() {
return m_projectId;
}
/**
* Returns the request context.
*
* @return the request context
*/
public CmsRequestContext getRequestContext() {
return m_requestContext;
}
/**
* Gets the user driver associated with this database context.
*
* @param projectId the project id for which the user driver should be retrieved
*
* @return the user driver
*/
public I_CmsUserDriver getUserDriver(CmsUUID projectId) {
return null;
}
/**
* Gets the VFS driver associated with this database context.
*
* @param projectId the project id for which the VFS driver should be retrieved
*
* @return the VFS driver
*/
public I_CmsVfsDriver getVfsDriver(CmsUUID projectId) {
return null;
}
/**
* Checks if the database context uses the default implementation.
*
* @return true if the database context uses the default implementation
*/
public boolean isDefaultDbContext() {
return true;
}
/**
* Processes the current database context.
*
* @throws CmsException if something goes wrong
*/
public void pop() throws CmsException {
if (!isDefaultDbContext()) {
throw new CmsException(Messages.get().container(Messages.ERR_PROCESS_DB_CONTEXT_0));
}
}
/**
* Removes the given attribute from the DB context.
*
* @param key the attribute key
*/
public void removeAttribute(String key) {
if (m_attributes == null) {
return;
}
m_attributes.remove(key);
}
/**
* Removes the current site root prefix from the absolute path in the resource name,
* that is adjusts the resource name for the current site root.
*
* If no user request context is available, the given resource name is
* returned unchanged.
*
* @param resourcename the resource name
*
* @return the resource name adjusted for the current site root
*/
public String removeSiteRoot(String resourcename) {
if ((m_requestContext != null) && (resourcename != null)) {
return m_requestContext.removeSiteRoot(resourcename);
}
return resourcename;
}
/**
* Reports an error to the given report (if available) and to the OpenCms log file.
*
* @param report the report to write the error to
* @param message the message to write to the report / log
* @param throwable the exception to write to the report / log
*
* @throws CmsException if the throwable parameter is not null and a {@link CmsException}
* @throws CmsVfsException if the throwable parameter is not null and no {@link CmsException}
*/
public void report(I_CmsReport report, CmsMessageContainer message, Throwable throwable)
throws CmsVfsException, CmsException {
if (report != null) {
if (message != null) {
report.println(message, I_CmsReport.FORMAT_ERROR);
}
if (throwable != null) {
report.println(throwable);
}
}
throwException(message, throwable);
}
/**
* Rolls back current transaction.
*/
public void rollback() {
// This method is only implemented org.opencms.db.jpa.CmsDbContext
}
/**
* Sets an attribute in the DB context.
*
* @param key the attribute key
* @param value the attribute value
*/
public void setAttribute(String key, Object value) {
if (m_attributes == null) {
m_attributes = new HashMap(4);
}
m_attributes.put(key, value);
}
/**
* Sets the project id of the context.
*
* @param projectId the id of the project to set
*/
public void setProjectId(CmsUUID projectId) {
m_projectId = projectId;
}
/**
* Returns an exception of the same type as throwable, if throwable is an OpenCms Exception
* with the message as a {@link CmsMessageContainer} and the throwable as a cause.
*
* @param message the message container for the exception to create
* @param throwable the cause of the exception
*
* @throws CmsException if the throwable parameter is not null and a {@link CmsException}
* @throws CmsVfsException if the throwable parameter is not null and no {@link CmsException}
*/
public void throwException(CmsMessageContainer message, Throwable throwable) throws CmsVfsException, CmsException {
if (throwable instanceof CmsException) {
throw ((CmsException)throwable).createException(message, throwable);
} else if (throwable instanceof CmsRuntimeException) {
throw ((CmsRuntimeException)throwable).createException(message, throwable);
} else {
throw new CmsVfsException(message, throwable);
}
}
}