Package de.xima.fc.plugin.models.retval.replacer

Class PluginGenericReplacerRetVal

java.lang.Object

de.xima.fc.plugin.models.retval.replacer.PluginGenericReplacerRetVal

All Implemented Interfaces:

IPluginReturnValue, IPluginFormReplacerRetVal, IPluginGenericReplacerRetVal, IPluginSessionReplacerRetVal, IPluginSystemReplacerRetVal, IPluginTemplateReplacerRetVal

public class PluginGenericReplacerRetVal
extends Object
implements IPluginFormReplacerRetVal, IPluginSessionReplacerRetVal, IPluginSystemReplacerRetVal, IPluginTemplateReplacerRetVal

Default POJO implementation of IPluginFormReplacerRetVal, IPluginSessionReplacerRetVal, IPluginSystemReplacerRetVal, IPluginTemplateReplacerRetVal.

Author:

XIMA MEDIA GmbH

Constructor Summary

Constructors

Constructor	Description
PluginGenericReplacerRetVal(String replacedValue)	Deprecated. This uses the EPluginReplacementStatus.LEGACY behavior.

Method Summary

Modifier and Type	Method	Description
String	getReplacedValue()	The value that should be used as the replacement for the placeholder.
EPluginReplacementStatus	getReplacementStatus()	The status indicating whether the placeholder could be resolved.
static PluginGenericReplacerRetVal	replacementFailure()	A placeholder plugin result when the plugin could not resolve the placeholder.
static PluginGenericReplacerRetVal	replacementSuccess(String replacedValue)	A placeholder plugin result when the plugin could resolve the placeholder.

Methods inherited from class java.lang.Object

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

Constructor Details

PluginGenericReplacerRetVal

@Deprecated
public PluginGenericReplacerRetVal(String replacedValue)

Deprecated.

This uses the EPluginReplacementStatus.LEGACY behavior. Use either replacementSuccess(String) or replacementFailure().

Parameters:

replacedValue - The resolved value of the placeholder. In case this value equals the placeholder content, that is treated as if the plugin could not resolve the placeholder.

Method Details

getReplacedValue

public String getReplacedValue()

Description copied from interface: IPluginGenericReplacerRetVal

The value that should be used as the replacement for the placeholder. This must be just the value, without any placeholder-specific prefixes or suffixes.

Also, a plugin may not want to handle all placeholders and delegate some placeholders to other plugins or to the default placeholder replacer. Return the name of the placeholder as the replaced value to indicate that the plugin cannot (or does not with to) handle that placeholder.

Specified by:

getReplacedValue in interface IPluginFormReplacerRetVal

Specified by:

getReplacedValue in interface IPluginGenericReplacerRetVal

Specified by:

getReplacedValue in interface IPluginSessionReplacerRetVal

Specified by:

getReplacedValue in interface IPluginSystemReplacerRetVal

Specified by:

getReplacedValue in interface IPluginTemplateReplacerRetVal

Returns:

The value to be used as the replacement for the placeholder. When this returns null: The placeholder is considered not resolved if IPluginGenericReplacerRetVal.getReplacementStatus() is LEGACY; otherwise null is treated as the empty string.

getReplacementStatus

public EPluginReplacementStatus getReplacementStatus()

Description copied from interface: IPluginGenericReplacerRetVal

The status indicating whether the placeholder could be resolved. If it could be resolved, the IPluginGenericReplacerRetVal.getReplacedValue() is used as the replacement for the placeholder. If it could not be resolved, other placeholder plugin are tried, and if none of those plugins could resolve the placeholder, the default placeholder replacer is used.

Specified by:

getReplacementStatus in interface IPluginGenericReplacerRetVal

Returns:

Whether the placeholder could be resolved.

replacementSuccess

public static PluginGenericReplacerRetVal replacementSuccess(String replacedValue)

A placeholder plugin result when the plugin could resolve the placeholder. The placeholder is replaced with the given value.

Parameters:

replacedValue - The resolved value of the placeholder. null is treated as if the empty string had been passed.

Returns:

A placeholder plugin result when the plugin could resolve the placeholder.

replacementFailure

public static PluginGenericReplacerRetVal replacementFailure()

A placeholder plugin result when the plugin could not resolve the placeholder. Other placeholder plugins and the default placeholder replacer are tried instead.

Returns:

A placeholder plugin result when the plugin could not resolve the placeholder.