org.opencms.jsp

类 CmsJspTagEditable

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

javax.servlet.jsp.tagext.BodyTagSupport

org.opencms.jsp.CmsJspTagEditable

所有已实现的接口:

java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class CmsJspTagEditable
extends javax.servlet.jsp.tagext.BodyTagSupport

Implementation of the <cms:editable/> tag.

This class is also used to generate the direct edit buttons for the <cms:include editable="..." /> and <cms:contentload editable="..." /> tags.

Since OpenCms version 6.2.3, the direct edit button HTML generated is controlled by an instance of I_CmsDirectEditProvider. The default direct edit provider used can be configured in opencms-workplace.xml in the <directeditprovider class="..." /> node. The standard provider is CmsDirectEditDefaultProvider. It's possible to override the default provider onm a page-by-page basis by initializing direct edit with <cms:editable provider="...." /> on top of the page.

Since OpenCms version 6.2.3, it is also possible to place the HTML of the direct edit buttons manually. This is intended for pages where the template HTML is not compatible with the direct edit HTML, which usually results in a funny placement of the direct edit buttons in a totally wrong position. To do manual placement of the direct edit buttons, you need to place <cms:editable mode="manual"> and </cms:editable> around your HTML. Both tags (start and end) will insert HTML according to the used I_CmsDirectEditProvider. The direct edit provider used must also support manual placing, or the manual tags will be ignored and the HTML will be inserted at the automatic position. A provider which support manual placing is the CmsDirectEditTextButtonProvider.

从以下版本开始:

6.0.0

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
protected java.lang.String	m_file File with editable elements.
protected CmsDirectEditMode	m_mode Indicates which direct edit mode is active.
protected java.lang.String	m_provider Class name of the direct edit provider.

从类继承的字段 javax.servlet.jsp.tagext.BodyTagSupport

bodyContent

从类继承的字段 javax.servlet.jsp.tagext.TagSupport

id, pageContext

从接口继承的字段 javax.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

从接口继承的字段 javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

从接口继承的字段 javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

构造器概要

构造器

构造器和说明
CmsJspTagEditable()

方法概要

方法

限定符和类型	方法和说明
int	doEndTag() Close the direct edit tag, also prints the direct edit HTML to the current page.
int	doStartTag() Opens the direct edit tag, if manual mode is set then the next start HTML for the direct edit buttons is printed to the page.
static void	editableTagAction(javax.servlet.jsp.PageContext context, java.lang.String provider, CmsDirectEditMode mode, java.lang.String fileName) Editable action method.
static void	endDirectEdit(javax.servlet.jsp.PageContext context) Closes the current direct edit element.
static I_CmsDirectEditProvider	getDirectEditProvider(javax.servlet.jsp.PageContext context) Returns the current initialized instance of the direct edit provider.
protected static CmsDirectEditParams	getDirectEditProviderParams(javax.servlet.jsp.PageContext context) Returns the current initialized instance of the direct edit provider parameters from the given page context.
java.lang.String	getFile() Gets the file with elements for direct editing.
java.lang.String	getMode() Returns the direct edit mode.
java.lang.String	getProvider() Returns the class name of the direct edit provider.
static void	insertEditEmpty(javax.servlet.jsp.PageContext context, I_CmsXmlContentContainer container, CmsDirectEditMode mode) Inserts direct edit for empty collector lists.
static boolean	isDirectEditDisabled(javax.servlet.ServletRequest request) Returns if direct edit is disabled for the current request.
static boolean	isEditableRequest(javax.servlet.ServletRequest req) Checks if the current request should be direct edit enabled.
boolean	isEditEmpty() Returns the edit empty attribute.
void	release() Releases any resources we may have (or inherit).
protected static void	setDirectEditProvider(javax.servlet.jsp.PageContext context, I_CmsDirectEditProvider provider) Sets the current initialized instance of the direct edit provider.
protected static void	setDirectEditProviderParams(javax.servlet.jsp.PageContext context, CmsDirectEditParams params) Sets the current initialized instance of the direct edit provider parameters to the page context.
void	setEditEmpty(boolean editEmpty) Sets the edit empty attribute.
void	setFile(java.lang.String file) Sets the file with elements for direct editing.
void	setMode(java.lang.String mode) Sets the direct edit mode.
void	setProvider(java.lang.String provider) Sets the class name of the direct edit provider.
static boolean	startDirectEdit(javax.servlet.jsp.PageContext context, CmsDirectEditParams params) Includes the "direct edit" start element that adds HTML for the editable area to the output page.

从类继承的方法 javax.servlet.jsp.tagext.BodyTagSupport

doAfterBody, doInitBody, getBodyContent, getPreviousOut, setBodyContent

从类继承的方法 javax.servlet.jsp.tagext.TagSupport

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue

从类继承的方法 java.lang.Object

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

从接口继承的方法 javax.servlet.jsp.tagext.Tag

getParent, setPageContext, setParent

字段详细资料

m_file

protected java.lang.String m_file

File with editable elements.

m_mode

protected transient CmsDirectEditMode m_mode

Indicates which direct edit mode is active.

m_provider

protected java.lang.String m_provider

Class name of the direct edit provider.

构造器详细资料

CmsJspTagEditable

public CmsJspTagEditable()

方法详细资料

editableTagAction

public static void editableTagAction(javax.servlet.jsp.PageContext context,
                     java.lang.String provider,
                     CmsDirectEditMode mode,
                     java.lang.String fileName)
                              throws javax.servlet.jsp.JspException

Editable action method.

参数:

context - the current JSP page context

provider - the class name of the direct edit privider to use (may be null, which means use the default)

mode - the direct edit mode to use (may be null, which means current use mode on page)

fileName - optional filename parameter for the direct edit provider (may be null, which means use the default)

抛出:

javax.servlet.jsp.JspException - in case something goes wrong

endDirectEdit

public static void endDirectEdit(javax.servlet.jsp.PageContext context)
                          throws javax.servlet.jsp.JspException

Closes the current direct edit element.

参数:

context - the current JSP page context

抛出:

javax.servlet.jsp.JspException - in case something goes wrong

getDirectEditProvider

public static I_CmsDirectEditProvider getDirectEditProvider(javax.servlet.jsp.PageContext context)

Returns the current initialized instance of the direct edit provider.

参数:

context - the current JSP page context

返回:

the current initialized instance of the direct edit provider

insertEditEmpty

public static void insertEditEmpty(javax.servlet.jsp.PageContext context,
                   I_CmsXmlContentContainer container,
                   CmsDirectEditMode mode)
                            throws CmsException,
                                   javax.servlet.jsp.JspException

Inserts direct edit for empty collector lists.

参数:

context - the current JSP page context

container - the parent content load container

mode - the direct edit mode to use (may be null, which means current use mode on page)

抛出:

CmsException - in case of invalid collector settings

javax.servlet.jsp.JspException - in case writing to page context fails

isDirectEditDisabled

public static boolean isDirectEditDisabled(javax.servlet.ServletRequest request)

Returns if direct edit is disabled for the current request.

参数:

request - the servlet request

返回:

true if direct edit is disabled for the current request

isEditableRequest

public static boolean isEditableRequest(javax.servlet.ServletRequest req)

Checks if the current request should be direct edit enabled. Online-, history-requests and temporary files will not be editable.

参数:

req - the servlet request

返回:

true if the current request should be direct edit enabled

startDirectEdit

public static boolean startDirectEdit(javax.servlet.jsp.PageContext context,
                      CmsDirectEditParams params)
                               throws javax.servlet.jsp.JspException

Includes the "direct edit" start element that adds HTML for the editable area to the output page.

参数:

context - the current JSP page context

params - the direct edit parameters

返回:

true in case a direct edit element has been opened

抛出:

javax.servlet.jsp.JspException - in case something goes wrong

getDirectEditProviderParams

protected static CmsDirectEditParams getDirectEditProviderParams(javax.servlet.jsp.PageContext context)

Returns the current initialized instance of the direct edit provider parameters from the given page context.

Also removes the parameters from the given page context.

参数:

context - the current JSP page context

返回:

the current initialized instance of the direct edit provider parameters

setDirectEditProvider

protected static void setDirectEditProvider(javax.servlet.jsp.PageContext context,
                         I_CmsDirectEditProvider provider)

Sets the current initialized instance of the direct edit provider.

参数:

context - the current JSP page context

provider - the current initialized instance of the direct edit provider to set

setDirectEditProviderParams

protected static void setDirectEditProviderParams(javax.servlet.jsp.PageContext context,
                               CmsDirectEditParams params)

Sets the current initialized instance of the direct edit provider parameters to the page context.

参数:

context - the current JSP page context

params - the current initialized instance of the direct edit provider parameters to set

doEndTag

public int doEndTag()
             throws javax.servlet.jsp.JspException

Close the direct edit tag, also prints the direct edit HTML to the current page.

指定者:

doEndTag 在接口中 javax.servlet.jsp.tagext.Tag

覆盖:

doEndTag 在类中 javax.servlet.jsp.tagext.BodyTagSupport

返回:

Tag.EVAL_PAGE

抛出:

javax.servlet.jsp.JspException - in case something goes wrong

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException

Opens the direct edit tag, if manual mode is set then the next start HTML for the direct edit buttons is printed to the page.

指定者:

doStartTag 在接口中 javax.servlet.jsp.tagext.Tag

覆盖:

doStartTag 在类中 javax.servlet.jsp.tagext.BodyTagSupport

返回:

Tag.EVAL_BODY_INCLUDE

抛出:

javax.servlet.jsp.JspException - in case something goes wrong

getFile

public java.lang.String getFile()

Gets the file with elements for direct editing.

返回:

the file

getMode

public java.lang.String getMode()

Returns the direct edit mode.

返回:

the direct edit mode

getProvider

public java.lang.String getProvider()

Returns the class name of the direct edit provider.

返回:

the class name of the direct edit provider

isEditEmpty

public boolean isEditEmpty()

Returns the edit empty attribute.

返回:

the edit empty attribute

release

public void release()

Releases any resources we may have (or inherit).

指定者:

release 在接口中 javax.servlet.jsp.tagext.Tag

覆盖:

release 在类中 javax.servlet.jsp.tagext.BodyTagSupport

setEditEmpty

public void setEditEmpty(boolean editEmpty)

Sets the edit empty attribute.

参数:

editEmpty - the edit empty attribute to set

setFile

public void setFile(java.lang.String file)

Sets the file with elements for direct editing.

参数:

file - the file to set

setMode

public void setMode(java.lang.String mode)

Sets the direct edit mode.

参数:

mode - the direct edit mode to set

setProvider

public void setProvider(java.lang.String provider)

Sets the class name of the direct edit provider.

参数:

provider - the class name of the direct edit provider to set