com.iplanet.jato.view.command
Class DefaultTiledRequestHandlingCommand
java.lang.Object
|
+--com.iplanet.jato.view.command.DefaultTiledRequestHandlingCommand
- All Implemented Interfaces:
- Command
- public class DefaultTiledRequestHandlingCommand
- extends java.lang.Object
- implements Command
The default command used to handle client requests within a TiledView.
This command will dispatch the request to a handler method on the parent
tiled view of the activated CommandField
.
All event handling methods have the same name of the following form:
handle<Command field name>Request(...)
This implementation searches for event handling methods by signature
in the following order:
If the target container is an instance of TiledView
:
public void handle<Command field name>Request(RequestInvocationEvent event)
public void handle<Command name>Request(RequestContext requestContext,
int rowNumber) (for backward compatibility)
If the activated command child is an image button or HREF, then this
implementation searches for event handling methods by signature
in the following order:
If the target container is an instance of TiledView
:
public void handle<Command field name>Request(RequestInvocationEvent event)
public void handle<Command name>Request(RequestContext requestContext,
int rowNumber, int imageXCoordinate, int imageYCoordinate) (for backward compatibility)
public void handle<Command name>Request(RequestContext requestContext,
int rowNumber) (for backward compatibility)
In both cases, the event signatures without RequestInvocatinEvent
are for backward compatibility with older JATO applications and should not be
used in new JATO applications. Also, in both cases, the expanded handler
method signature with image coordinates is optional, and if not found, the
request will be dispatched to the default handler method signature.
Note that the throws clause of handler methods need not declare any particular
exceptions except those that the developer wishes to throw from the method.>p>
The expected behavior of the request event handling method is to forward the
request to another JSP/view bean/resource, preparing the target in any way
necessary to support the request. Note that the current request context has
already been set on the target parent container when the event handler method
is called by virtue of the RequestParticipant
interface.
- Since:
- JATO/1.2
- Version:
- JATO/1.2.2 $Id: DefaultTiledRequestHandlingCommand.java,v 1.6 2002/03/16 03:26:42 todd Exp $
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
HANDLE_REQUEST_METHOD_PREFIX
public static final java.lang.String HANDLE_REQUEST_METHOD_PREFIX
HANDLE_REQUEST_METHOD_SUFFIX
public static final java.lang.String HANDLE_REQUEST_METHOD_SUFFIX
COMMAND_DESCRIPTOR
public static final CommandDescriptor COMMAND_DESCRIPTOR
OPTION_FALLBACK_TO_LEGACY_REQUEST_EVENT_SIGNATURES
public static final boolean OPTION_FALLBACK_TO_LEGACY_REQUEST_EVENT_SIGNATURES
DefaultTiledRequestHandlingCommand
public DefaultTiledRequestHandlingCommand()
- Default constructor
execute
public void execute(CommandEvent anEvent)
throws CommandException
- Description copied from interface:
Command
- Called to execute the command.
Classes which implement this interface may chooce to implement this
method in any arbitrary fashion. They can choose to take advantage of
any, all, or none of the information provided by the
CommandEvent
parameter.
- Specified by:
execute
in interface Command
- Following copied from interface:
com.iplanet.jato.command.Command
- Parameters:
event
- The command event, contains information pertinent to
to the invocation of this command- Throws:
CommandException
- Thrown if an error occurs executing the command