tapestry-framework/src/java/org/apache/tapestry/wml/Go.jwc

<?xml version="1.0" encoding="UTF-8"?>
<!-- 
    Copyright 2004, 2005 The Apache Software Foundation
    
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    
    http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-->

<!DOCTYPE component-specification PUBLIC
  "-//Apache Software Foundation//Tapestry Specification 4.0//EN"
  "http://tapestry.apache.org/dtd/Tapestry_4_0.dtd">

<component-specification class="org.apache.tapestry.wml.Go">

    <description>The go element declares a go task, indicating navigation to a URI.</description>

    <bean name="delegate" class="org.apache.tapestry.valid.ValidationDelegate" property="delegate" />

    <parameter name="method" default-value="literal:post">
        <description>
            The method used by the form when it is submitted, defaults to POST.
        </description>
    </parameter>

    <parameter name="success">
        <description>
            Object invoked when the form is submitted normally (not a cancel or a refresh) and the
            validation delegate contains no errors.
        </description>
    </parameter>

    <parameter name="cancel">
        <description>
            Object invoked when the form is cancelled (a special type of form submission). The
            cancel listener (if any) overrides the standard listener. Other properties will not be
            affected by the rewind.
        </description>
    </parameter>

    <parameter name="refresh">
        <description>
            Object invoked when the form is refreshed (a special type of form submission). The
            refresh listener (if any) overrides the standard listener. Other properties managed by
            enclosed components will be updated.
        </description>
    </parameter>

    <parameter name="listener">
        <description>Default listener used when no other listener is invoked.</description>
    </parameter>


    <parameter name="stateful" default-value="true">
        <description>
            If true (the default), then an active session is required when the Go is submitted, if a
            session was active when the Go was rendered.
        </description>
    </parameter>

    <parameter name="scheme">
        <description>
            Forces the link to be generated as an absolute URL with the given scheme (unless the
            scheme matches the scheme for the current request).
        </description>
    </parameter>

    <parameter name="port">
        <description>
            Forces the link to be generated as an absolute URL with the given port (unless the port
            matches the port for the current request).
        </description>
    </parameter>


    <reserved-parameter name="href" />
    <reserved-parameter name="name" />

    <inject property="directService" object="engine-service:direct" />
    <inject property="response" object="infrastructure:response" />
    <inject property="listenerInvoker" object="infrastructure:listenerInvoker" />
    <inject property="javascriptManager" object="service:tapestry.js.JavascriptManager"/>

</component-specification>