com.sapportals.wcm.rendering.uicommand

Interface IUIMassCommand

All Superinterfaces:

IExecCommand, IMassExecCommand, IUIBaseCommand

All Known Implementing Classes:

AbstractUIMassCommand

Deprecated. As of EP 5.0 SP6 and EP 6.0 SP1, replaced by IMassCommand

public interface IUIMassCommand

extends IMassExecCommand

Copyright 2004 SAP AG

Field Summary

Fields inherited from interface com.sapportals.wcm.rendering.uicommand.IExecCommand

APPLICABLE_FALSE, APPLICABLE_TRUE, APPLICABLE_UNKNOWN

Fields inherited from interface com.sapportals.wcm.rendering.base.IUIBaseCommand

ERR_MESSAGE_MISSING_CONFIG_ENTRY, ERR_MESSAGE_WRONG_METHOD_CALL, KEY_INPUT_CONTROL_TEXT, KEY_INPUT_CONTROL_TEXT_2, KEY_INPUT_CONTROL_TEXT_2_DEFAULT_TEXT, KEY_INPUT_CONTROL_TEXT_3, KEY_INPUT_CONTROL_TEXT_DEFAULT_TEXT, KEY_LABEL, KEY_MASS_EMBEDDED_COMMAND_TEXT, KEY_MASS_EMBEDDED_COMMANT_TOOLTIP, KEY_SINGLE_EMBEDDED_COMMAND_TEXT, KEY_SINGLE_EMBEDDED_COMMAND_TOOLTIP, KEY_TOOLTIP, LINE_BREAK, TEXT_KEYS, VALUE_EMPTY_STRING

Method Summary

WdfEvent	execute() Deprecated. carries out the wanted functionality on the given IResourceList .
WdfEvent	execute(ControllerDynPage dynpage, boolean pushStack) Deprecated. carries out the wanted functionality on the given IResourceList and might start a screenflow to do so.
IUIMassCommand	getNewInstance() Deprecated. returns a new instance of the class with all the values set by the configuration.
void	setTextProperties(Properties properties) Deprecated. allows to set key-value pairs used for the texts on the screen for the implementing command.

Methods inherited from interface com.sapportals.wcm.rendering.uicommand.IMassExecCommand

setResourceList

Methods inherited from interface com.sapportals.wcm.rendering.uicommand.IExecCommand

getAlias, getLinkAttributes, getTargetParameters, isApplicable, isExecutable, raisesEvent, setAlias, setTargetParameters

Methods inherited from interface com.sapportals.wcm.rendering.base.IUIBaseCommand

getComponent, getConfigurationProperties, getParameters, getReplaceCommands, getText, setConfigurationProperties, setLabelBundleKey, setParameters, setProxy, setReplaceCommands, setResource, setResourceBundle, setResourceContext, setTooltipBundleKey

Method Detail

execute

public WdfEvent execute()
                 throws WdfException

Deprecated.

carries out the wanted functionality on the given IResourceList . When this method is called, no screenflow can be started, the command can only carry out its action and return a status message. Some IUICommand s need to start a screenflow to properly execute their tasks. They might throw an Exception or simply return an error message stating that this method call is not usable by them.

Returns:

the WdfEvent that encapsulates the information about the status of the execution.

Throws:

WdfException - Exception raised in failure situation

execute

public WdfEvent execute(ControllerDynPage dynpage,
                        boolean pushStack)
                 throws WdfException

Deprecated.

carries out the wanted functionality on the given IResourceList and might start a screenflow to do so.

Parameters:

dynpage - The page the current AbstractProxyControl and the command are rendered in.

pushStack - flag that states, if the current pane of the Wdf-Screenflow should be stored on the stack, or not. If the value is true , all registered Controls will be stored on the stack and when the screenflow returns to this stack, the userinput of these controls is still available

Returns:

the WdfEvent that encapsulates the information about the status of the execution. It also acts as the trigger to jump into the IUICommand's screenflow (If one is defined). Note, that a WdfEvent can encapsulate other events.

Throws:

WdfException - Exception raised in failure situation

getNewInstance

public IUIMassCommand getNewInstance()

Deprecated.

returns a new instance of the class with all the values set by the configuration. When the CM is starting, the UICommandFactory reads out the configuration for the IUIMassCommands and creates an instance of each command. Whenever the factory is asked to return a certain command, it uses the initially created command instance and calls its getNewInstance method. The command is responsible to set all values stemming from the configuration to the newly created instance. This delegated responsibility allows for greater flexibility inside the commands.

Returns:

a new Instance of the class, must not return null.

setTextProperties

public void setTextProperties(Properties properties)

Deprecated.

allows to set key-value pairs used for the texts on the screen for the implementing command. The command must have some default-values to use, if no properties are sent from the configuration.

Specified by:

setTextProperties in interface IExecCommand

Parameters:

properties - The new textProperties value