Package de.xima.fc.mdl.placeholder

Class DefaultReplacerParameters

java.lang.Object

de.xima.fc.mdl.placeholder.DefaultReplacerParameters

All Implemented Interfaces:

ILanguageTagProviding, IContextReplacerParams, IFormReplacerParams, II18nValueReplacerParams, IPlaceholderValueParams, IReplacerParams, ISessionReplacerParams, ISystemReplacerParams, ITemplateReplacerParams, Serializable

public class DefaultReplacerParameters
extends Object
implements IPlaceholderValueParams

Author:

XIMA MEDIA GmbH

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface de.xima.fc.interfaces.placeholder.params.IContextReplacerParams

IContextReplacerParams.IValueReplacer

Constructor Summary

Constructors

Constructor	Description
DefaultReplacerParameters()
DefaultReplacerParameters(Mandant client)
DefaultReplacerParameters(Vorgang process)
DefaultReplacerParameters(Vorgang process, String sessionId, String baseUrl)
DefaultReplacerParameters(Vorgang process, String sessionId, String baseUrl, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
DefaultReplacerParameters(IFormDataAdapter formData, FormVersion formVersion, boolean encodeForHTML)
DefaultReplacerParameters(IFormDataAdapter formData, FormVersion formVersion, boolean encodeForHTML, boolean encodeFormValuesForPlaceholder)
DefaultReplacerParameters(IFormDataAdapter formData, Vorgang process)
DefaultReplacerParameters(IReplacerParams params)
DefaultReplacerParameters(IWorkflowProcessingContext wfpctx)	Deprecated. Use DefaultReplacerParameters(IBaseWorkflowExecutionContext)
DefaultReplacerParameters(IWorkflowProcessingContext wfpctx, Vorgang formRecord)	Deprecated. Use DefaultReplacerParameters(IBaseWorkflowExecutionContext, Vorgang)
DefaultReplacerParameters(IBaseWorkflowExecutionContext wfpctx)
DefaultReplacerParameters(IBaseWorkflowExecutionContext wfpctx, Vorgang formRecord)
DefaultReplacerParameters(Map<String,Map<String,String>> contextPlaceholderMap, Map<String,IContextReplacerParams.IValueReplacer> contextReplacerMap)

Method Summary

Modifier and Type	Method	Description
String	getBaseUrl()
Mandant	getClient()
Clock	getClock()
String	getContextPath()
com.alibaba.fastjson.JSONObject	getCreatorDataJSON()
com.alibaba.fastjson.JSONObject	getEditorDataJSON()
IPlaceholderEscaper	getEscaper()	The placeholder escaper, which should applied for the replaced placeholder values before they returned to the document
IFormDataAdapter	getFormData()
FormVersion	getFormVersion()
String	getLanguageTag()
Map<String,Map<String,String>>	getPlaceholderMap()
Vorgang	getProcess()
Projekt	getProject()
IRepetitionContainer	getRepetitionContainer()	When a form element placeholder is replaced and the form element is repeated, all repeated values are joined with a comman by default and used as the replacement value.
Map<String,IContextReplacerParams.IValueReplacer>	getReplacerMap()
javax.servlet.http.HttpServletRequest	getRequest()
javax.servlet.http.HttpServletResponse	getResponse()
String	getSessionId()
com.alibaba.fastjson.JSONObject	getUserDataJSON()
IBaseWorkflowExecutionContext	getWorkflowExecutionContext()
IWorkflowProcessingContext	getWorkflowProcessing()	Deprecated.
boolean	isEncodeForHTML()
boolean	isEncodeFormValuesForPlaceholder()
boolean	isReplaceContextPlaceholders()
boolean	isReplaceFormPlaceholders()
boolean	isReplaceI18nPlaceholders()
boolean	isReplaceSessionPlaceholders()
boolean	isReplaceSystemPlaceholders()
boolean	isReplaceTemplatePlaceholders()
void	setBaseUrl(String baseUrl)
void	setClient(Mandant client)
void	setClock(Clock clock)
void	setContextPath(String contextPath)
void	setCreatorDataJSON(com.alibaba.fastjson.JSONObject creatorData)
void	setEditorDataJSON(com.alibaba.fastjson.JSONObject editorData)
void	setEncodeForHTML(boolean encodeForHTML)
void	setEncodeFormValuesForPlaceholder(boolean encodeFormValuesForPlaceholder)
void	setEscaper(IPlaceholderEscaper escaper)
void	setFormData(IFormDataAdapter formData)
void	setFormVersion(FormVersion formVersion)
void	setLanguageTag(String languageTag)
void	setProcess(Vorgang process)
void	setProject(Projekt project)
void	setRepetitionContainer(IRepetitionContainer repetitionContext)
void	setRepetitionContainer(String repeatedContainer, int ordinalIndex)
void	setReplaceContextPlaceholders(boolean replaceContextPlaceholders)
void	setReplaceFormPlaceholders(boolean replaceFormPlaceholders)
void	setReplaceI18nPlaceholders(boolean replaceI18nPlaceholders)
void	setReplaceSessionPlaceholders(boolean replaceSessionPlaceholders)
void	setReplaceSystemPlaceholders(boolean replaceSystemPlaceholders)
void	setReplaceTemplatePlaceholders(boolean replaceTemplatePlaceholders)
void	setRequest(javax.servlet.http.HttpServletRequest request)
void	setResponse(javax.servlet.http.HttpServletResponse response)
void	setSessionId(String sessionId)
void	setUserDataJSON(com.alibaba.fastjson.JSONObject userData)
void	setWorkflowProcessing(IWorkflowProcessingContext wfpctx)

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultReplacerParameters

public DefaultReplacerParameters()

DefaultReplacerParameters

public DefaultReplacerParameters(Map<String,Map<String,String>> contextPlaceholderMap,
 Map<String,IContextReplacerParams.IValueReplacer> contextReplacerMap)

DefaultReplacerParameters

public DefaultReplacerParameters(Vorgang process,
 String sessionId,
 String baseUrl)

DefaultReplacerParameters

public DefaultReplacerParameters(Vorgang process,
 String sessionId,
 String baseUrl,
 javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response)

DefaultReplacerParameters

public DefaultReplacerParameters(IFormDataAdapter formData,
 FormVersion formVersion,
 boolean encodeForHTML)

DefaultReplacerParameters

public DefaultReplacerParameters(IFormDataAdapter formData,
 FormVersion formVersion,
 boolean encodeForHTML,
 boolean encodeFormValuesForPlaceholder)

DefaultReplacerParameters

public DefaultReplacerParameters(IBaseWorkflowExecutionContext wfpctx)

DefaultReplacerParameters

public DefaultReplacerParameters(IBaseWorkflowExecutionContext wfpctx,
 Vorgang formRecord)

DefaultReplacerParameters

public DefaultReplacerParameters(IReplacerParams params)

DefaultReplacerParameters

@Deprecated
public DefaultReplacerParameters(IWorkflowProcessingContext wfpctx,
 Vorgang formRecord)

Deprecated.

Use DefaultReplacerParameters(IBaseWorkflowExecutionContext, Vorgang)

Parameters:

wfpctx - A workflow processing context.

formRecord - A form record to use, instead of the form record of the given processing context.

DefaultReplacerParameters

public DefaultReplacerParameters(IFormDataAdapter formData,
 Vorgang process)

DefaultReplacerParameters

@Deprecated
public DefaultReplacerParameters(IWorkflowProcessingContext wfpctx)

Deprecated.

Use DefaultReplacerParameters(IBaseWorkflowExecutionContext)

Parameters:

wfpctx - A workflow processing context.

DefaultReplacerParameters

public DefaultReplacerParameters(Vorgang process)

DefaultReplacerParameters

public DefaultReplacerParameters(Mandant client)

Method Details

isEncodeFormValuesForPlaceholder

public boolean isEncodeFormValuesForPlaceholder()

Specified by:

isEncodeFormValuesForPlaceholder in interface IFormReplacerParams

Specified by:

isEncodeFormValuesForPlaceholder in interface IReplacerParams

setEncodeFormValuesForPlaceholder

public void setEncodeFormValuesForPlaceholder(boolean encodeFormValuesForPlaceholder)

getWorkflowProcessing

@Deprecated
public IWorkflowProcessingContext getWorkflowProcessing()

Deprecated.

Specified by:

getWorkflowProcessing in interface ISystemReplacerParams

Returns:

The current workflow processing context, or null if none is available.

getWorkflowExecutionContext

public IBaseWorkflowExecutionContext getWorkflowExecutionContext()

Specified by:

getWorkflowExecutionContext in interface ISystemReplacerParams

setWorkflowProcessing

public void setWorkflowProcessing(IWorkflowProcessingContext wfpctx)

getClient

public Mandant getClient()

Specified by:

getClient in interface IFormReplacerParams

Specified by:

getClient in interface II18nValueReplacerParams

Specified by:

getClient in interface ISystemReplacerParams

Specified by:

getClient in interface ITemplateReplacerParams

Returns:

the current Mandant object

setClient

public void setClient(Mandant client)

getProcess

public Vorgang getProcess()

Specified by:

getProcess in interface IFormReplacerParams

Specified by:

getProcess in interface ISessionReplacerParams

Specified by:

getProcess in interface ISystemReplacerParams

Returns:

the current Vorgang object

getClock

public Clock getClock()

Specified by:

getClock in interface IPlaceholderValueParams

Specified by:

getClock in interface ISessionReplacerParams

Specified by:

getClock in interface ISystemReplacerParams

Returns:

The clock to use for obtaining the current time.

setClock

public void setClock(Clock clock)

Parameters:

clock - The clock to use for obtaining the current time.

setProcess

public void setProcess(Vorgang process)

getProject

public Projekt getProject()

Specified by:

getProject in interface ISystemReplacerParams

setProject

public void setProject(Projekt project)

getSessionId

public String getSessionId()

Specified by:

getSessionId in interface ISessionReplacerParams

setSessionId

public void setSessionId(String sessionId)

getRequest

public javax.servlet.http.HttpServletRequest getRequest()

Specified by:

getRequest in interface ISessionReplacerParams

setRequest

public void setRequest(javax.servlet.http.HttpServletRequest request)

getResponse

public javax.servlet.http.HttpServletResponse getResponse()

Specified by:

getResponse in interface ISessionReplacerParams

setResponse

public void setResponse(javax.servlet.http.HttpServletResponse response)

getFormData

public IFormDataAdapter getFormData()

Specified by:

getFormData in interface IFormReplacerParams

Specified by:

getFormData in interface ISystemReplacerParams

setFormData

public void setFormData(IFormDataAdapter formData)

Specified by:

setFormData in interface IFormReplacerParams

Specified by:

setFormData in interface ISystemReplacerParams

getFormVersion

public FormVersion getFormVersion()

Specified by:

getFormVersion in interface IFormReplacerParams

Returns:

the current FormVersion object

setFormVersion

public void setFormVersion(FormVersion formVersion)

getContextPath

public String getContextPath()

Specified by:

getContextPath in interface ISessionReplacerParams

Specified by:

getContextPath in interface ISystemReplacerParams

setContextPath

public void setContextPath(String contextPath)

getRepetitionContainer

public IRepetitionContainer getRepetitionContainer()

Description copied from interface: IFormReplacerParams

When a form element placeholder is replaced and the form element is repeated, all repeated values are joined with a comman by default and used as the replacement value. When a repetition container is given as the context for the replacement and the form element is inside the same reptition container, only the value at the given index is used.

For example, let's say we have a form with the following elements:

• ed1
• fs1 (repeated fieldset with the following elements)
  • tf1
  • tf2
• fs2 (repeated fieldset with the following elements)
  • upl1
  • upl2

Let's also say we have two repetions for each fieldset, and the the form elements have the value valTf1_1, valTf1_2, valTf2_1, valTf1_2, valUpl1_1, valUpl1_2, valUpl2_1, valUpl2_2.

Now when we have the placeholder [%ed1%]_[%tf1%]_[%upl2%], it is replaced by valEd1_valTf1_1,valTf1_2_valUpl2_1,valUpl2_2 by default.

But if we are making the replacement within the context of upl2, e.g. when that placeholder is used to compute the file name for upl2, we want to use only the value of the current repetition for upl2, not a values joined with a comma.

To do this, we can set the repetition container to (name="fs2", index=0). Then the placeholder evaluates to valEd1_valTf1_1,valTf1_2_valUpl2_1. If we set the context to (name="fs2", index=1) instead, the placeholder evaluates valEd1_valTf1_1,valTf1_2_valUpl2_2.

Specified by:

getRepetitionContainer in interface IFormReplacerParams

Returns:

The repetition context where the replacement is made. May be null.

setRepetitionContainer

public void setRepetitionContainer(IRepetitionContainer repetitionContext)

setRepetitionContainer

public void setRepetitionContainer(String repeatedContainer,
 int ordinalIndex)

getBaseUrl

public String getBaseUrl()

Specified by:

getBaseUrl in interface ISessionReplacerParams

setBaseUrl

public void setBaseUrl(String baseUrl)

getLanguageTag

public String getLanguageTag()

Specified by:

getLanguageTag in interface IFormReplacerParams

Specified by:

getLanguageTag in interface ILanguageTagProviding

Returns:

The language tag (Locale.toLanguageTag()) provided by this object.

setLanguageTag

public void setLanguageTag(String languageTag)

isEncodeForHTML

public boolean isEncodeForHTML()

Specified by:

isEncodeForHTML in interface IFormReplacerParams

Specified by:

isEncodeForHTML in interface II18nValueReplacerParams

setEncodeForHTML

public void setEncodeForHTML(boolean encodeForHTML)

getEscaper

public IPlaceholderEscaper getEscaper()

Description copied from interface: IPlaceholderValueParams

The placeholder escaper, which should applied for the replaced placeholder values before they returned to the document

Specified by:

getEscaper in interface IFormReplacerParams

Specified by:

getEscaper in interface IPlaceholderValueParams

Specified by:

getEscaper in interface IReplacerParams

Returns:

an instance of IPlaceholderEscaper

setEscaper

public void setEscaper(IPlaceholderEscaper escaper)

getReplacerMap

public Map<String,IContextReplacerParams.IValueReplacer> getReplacerMap()

Specified by:

getReplacerMap in interface IContextReplacerParams

getPlaceholderMap

public Map<String,Map<String,String>> getPlaceholderMap()

Specified by:

getPlaceholderMap in interface IContextReplacerParams

getCreatorDataJSON

public com.alibaba.fastjson.JSONObject getCreatorDataJSON()

Specified by:

getCreatorDataJSON in interface ISystemReplacerParams

setCreatorDataJSON

public void setCreatorDataJSON(com.alibaba.fastjson.JSONObject creatorData)

getEditorDataJSON

public com.alibaba.fastjson.JSONObject getEditorDataJSON()

Specified by:

getEditorDataJSON in interface ISystemReplacerParams

setEditorDataJSON

public void setEditorDataJSON(com.alibaba.fastjson.JSONObject editorData)

getUserDataJSON

public com.alibaba.fastjson.JSONObject getUserDataJSON()

Specified by:

getUserDataJSON in interface ISystemReplacerParams

setUserDataJSON

public void setUserDataJSON(com.alibaba.fastjson.JSONObject userData)

isReplaceContextPlaceholders

public boolean isReplaceContextPlaceholders()

Specified by:

isReplaceContextPlaceholders in interface IContextReplacerParams

Returns:

When false, context placeholders are not replaced.

setReplaceContextPlaceholders

public void setReplaceContextPlaceholders(boolean replaceContextPlaceholders)

isReplaceSystemPlaceholders

public boolean isReplaceSystemPlaceholders()

Specified by:

isReplaceSystemPlaceholders in interface ISystemReplacerParams

Returns:

When false, system placeholders are not replaced.

setReplaceSystemPlaceholders

public void setReplaceSystemPlaceholders(boolean replaceSystemPlaceholders)

isReplaceFormPlaceholders

public boolean isReplaceFormPlaceholders()

Specified by:

isReplaceFormPlaceholders in interface IFormReplacerParams

Returns:

When false, form placeholders are not replaced.

setReplaceFormPlaceholders

public void setReplaceFormPlaceholders(boolean replaceFormPlaceholders)

isReplaceTemplatePlaceholders

public boolean isReplaceTemplatePlaceholders()

Specified by:

isReplaceTemplatePlaceholders in interface ITemplateReplacerParams

Returns:

When false, template placeholders are not replaced.

setReplaceTemplatePlaceholders

public void setReplaceTemplatePlaceholders(boolean replaceTemplatePlaceholders)

isReplaceI18nPlaceholders

public boolean isReplaceI18nPlaceholders()

Specified by:

isReplaceI18nPlaceholders in interface II18nValueReplacerParams

Returns:

When false, i18n placeholders are not replaced.

setReplaceI18nPlaceholders

public void setReplaceI18nPlaceholders(boolean replaceI18nPlaceholders)

isReplaceSessionPlaceholders

public boolean isReplaceSessionPlaceholders()

Specified by:

isReplaceSessionPlaceholders in interface ISessionReplacerParams

setReplaceSessionPlaceholders

public void setReplaceSessionPlaceholders(boolean replaceSessionPlaceholders)