org.apache.tapestry.form
Class Submit

java.lang.Object
  org.apache.hivemind.impl.BaseLocatable
      org.apache.tapestry.AbstractComponent
          org.apache.tapestry.form.AbstractFormComponent
              org.apache.tapestry.form.Submit

All Implemented Interfaces:

org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder, IFormComponent, IComponent, IDirectEvent, IDynamicInvoker, Component, IRender

Direct Known Subclasses:

ImageSubmit

public abstract class Submit
extends AbstractFormComponent

Implements a component that manages an HTML <input type=submit> form element. [ Component Reference ]

This component is generally only used when the form has multiple submit buttons, and it is important for the application to know which one was pressed. You may also want to use ImageSubmitwhich accomplishes much the same thing, but uses a graphic image instead.

Author:

Howard Lewis Ship

Field Summary

Fields inherited from class org.apache.tapestry.AbstractComponent

_body, _bodyCount

Constructor Summary

Submit()

Method Summary

abstract IActionListener	getAction() parameter.
abstract boolean	getDefer() parameter.
abstract IEngineService	getDirectService() Injected.
abstract String	getLabel() parameter.
abstract IActionListener	getListener() parameter.
abstract ListenerInvoker	getListenerInvoker() Injected.
abstract Object	getParameters() parameter.
abstract IScript	getSubmitScript() Injected.
abstract String	getSubmitType() The type of submission, normal/cancel/refresh.
abstract Object	getTag() parameter.
abstract List	getUpdateComponents() If set, will be used to update/refresh portions of a response during XHR requests.
abstract boolean	isAsync() Used to specify whether or not the result of this invocation should be returned asynchronously or use normal browser page reload semantics.
protected boolean	isClicked(IRequestCycle cycle, String name) Determine if this submit component was clicked.
abstract boolean	isJson() Used to specify that the return invocation of the response created should be in the "http://json.org" format.
protected void	renderFormComponent(IMarkupWriter writer, IRequestCycle cycle) Invoked from AbstractFormComponent.renderComponent(IMarkupWriter, IRequestCycle) to render the component.
protected void	renderSubmitBindings(IMarkupWriter writer, IRequestCycle cycle) Manages rendering of important submit client side bindings, like invoking the right submit type or any of the optional IDynamicInvoker parameters.
protected void	rewindFormComponent(IMarkupWriter writer, IRequestCycle cycle) Invoked from AbstractFormComponent.renderComponent(IMarkupWriter, IRequestCycle) to rewind the component.
abstract void	setSelected(Object tag) parameter.

Methods inherited from class org.apache.tapestry.form.AbstractFormComponent

generateClientId, getCanTakeFocus, getForm, getIdParameter, getName, getRenderBodyOnRewind, isRequired, peekClientId, renderComponent, renderDelegateAttributes, renderDelegatePrefix, renderDelegateSuffix, setForm, setName, setName

Methods inherited from class org.apache.tapestry.AbstractComponent

addAsset, addBody, addComponent, checkActiveLock, cleanupAfterRender, enterActiveState, equals, finishLoad, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getBoundId, getClientId, getComponent, getComponents, getContainedComponent, getContainedRenderers, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getInnerRenderers, getListeners, getMessages, getNamespace, getPage, getRenderWorker, getSpecification, getSpecifiedId, getTemplateTagName, hasEvents, hashCode, isInActiveState, isParameterBound, isRendering, isStateful, pageEndRender, prepareForRender, render, renderBody, renderIdAttribute, renderInformalParameters, setBinding, setClientId, setContainedComponent, setContainer, setHasEvents, setId, setNamespace, setPage, setTemplateTagName, toString, triggerEvent

Methods inherited from class org.apache.hivemind.impl.BaseLocatable

getLocation, setLocation

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.tapestry.form.IFormComponent

getClientId, getDisplayName, isDisabled

Methods inherited from interface org.apache.tapestry.IComponent

addAsset, addBody, addComponent, enterActiveState, finishLoad, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getComponent, getComponents, getContainedComponent, getContainer, getEventInvoker, getExtendedId, getId, getIdPath, getListeners, getMessages, getNamespace, getPage, getSpecification, getSpecifiedId, getTemplateTagName, isRendering, renderBody, setBinding, setClientId, setContainedComponent, setContainer, setId, setNamespace, setPage, setTemplateTagName

Methods inherited from interface org.apache.tapestry.IRender

render

Methods inherited from interface org.apache.hivemind.LocationHolder

setLocation

Methods inherited from interface org.apache.hivemind.Locatable

getLocation

Constructor Detail

Submit

public Submit()

Method Detail

isClicked

protected boolean isClicked(IRequestCycle cycle,
                            String name)

Determine if this submit component was clicked.

Parameters:

cycle - The current request.

name - The name of this form element.

Returns:

true if this submit was clicked

renderFormComponent

protected void renderFormComponent(IMarkupWriter writer,
                                   IRequestCycle cycle)

Description copied from class: AbstractFormComponent

Invoked from AbstractFormComponent.renderComponent(IMarkupWriter, IRequestCycle) to render the component.

Specified by:

renderFormComponent in class AbstractFormComponent

See Also:

AbstractFormComponent.renderFormComponent(org.apache.tapestry.IMarkupWriter, org.apache.tapestry.IRequestCycle)

getLabel

public abstract String getLabel()

parameter.

rewindFormComponent

protected void rewindFormComponent(IMarkupWriter writer,
                                   IRequestCycle cycle)

Description copied from class: AbstractFormComponent

Invoked from AbstractFormComponent.renderComponent(IMarkupWriter, IRequestCycle) to rewind the component. If the component is disabled this will not be invoked.

Specified by:

rewindFormComponent in class AbstractFormComponent

See Also:

AbstractFormComponent.rewindFormComponent(org.apache.tapestry.IMarkupWriter, org.apache.tapestry.IRequestCycle)

renderSubmitBindings

protected void renderSubmitBindings(IMarkupWriter writer,
                                    IRequestCycle cycle)

Manages rendering of important submit client side bindings, like invoking the right submit type or any of the optional IDynamicInvoker parameters.

Parameters:

writer - The writer to use to write content.

cycle - The current request cycle.

getListener

public abstract IActionListener getListener()

parameter.

getAction

public abstract IActionListener getAction()

parameter.

getTag

public abstract Object getTag()

parameter.

setSelected

public abstract void setSelected(Object tag)

parameter.

getDefer

public abstract boolean getDefer()

parameter.

getParameters

public abstract Object getParameters()

parameter.

getSubmitType

public abstract String getSubmitType()

The type of submission, normal/cancel/refresh.

getUpdateComponents

public abstract List getUpdateComponents()

If set, will be used to update/refresh portions of a response during XHR requests.

For instance, if you have a page listing projects and you wanted to update an Any components contents whenever one of the project links was clicked you would use a DirectLink with the parameters:

      updateComponents="{'projectDetails'}"
      async="true"
 

Specified by:

getUpdateComponents in interface IDynamicInvoker

Returns:

The list of components to update, if any.

isAsync

public abstract boolean isAsync()

Used to specify whether or not the result of this invocation should be returned asynchronously or use normal browser page reload semantics.

Async being true means responses will be encoded as XML using XmlHttpRequests. If you would like your request/response to be in another format - like JSON - you must also specify the additional parameter IDynamicInvoker.isJson(). Without setting the IDynamicInvoker.getUpdateComponents() parameter this parameter is pretty useless.

Specified by:

isAsync in interface IDynamicInvoker

Returns:

True if invocation should be processed asynchronously.

See Also:

IDynamicInvoker.isJson()

isJson

public abstract boolean isJson()

Used to specify that the return invocation of the response created should be in the "http://json.org" format. Without setting the IDynamicInvoker.getUpdateComponents() parameter this parameter is pretty useless.

Specified by:

isJson in interface IDynamicInvoker

Returns:

True if response should be encoded using JSON semantics.

See Also:

org.apache.tapestry.IJSONRender}

getDirectService

public abstract IEngineService getDirectService()

Injected.

getListenerInvoker

public abstract ListenerInvoker getListenerInvoker()

Injected.

getSubmitScript

public abstract IScript getSubmitScript()

Injected.