blob: c67f7cd903a20c7b1b5cfb91fbaf10999660366e [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you 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.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>Add Forward Dialog Box</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>
<body>
<p><a id="org.netbeans.modules.web.struts.dialogs.AddForwardDialogPanel" name="org.netbeans.modules.web.struts.dialogs.AddForwardDialogPanel"></a></p>
<div id="NBCSH4253"><!-- infolevel="all" infotype="General" --><a id="sthref565" name="sthref565"></a>
<h1>Add Forward Dialog Box</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>Use to register an action forward in the <code dir="ltr">struts-config.xml</code> file.
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1189">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>A Struts action responds to a request. Writing an action means subclassing one of the Action classes and then overriding the class's execute method. Use the New Struts Action wizard for this purpose.
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1188">
<param name="text" value="<html><u>More</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p>An action forward is an output view. For example, an action forward can forward to an output view called success. In the <code dir="ltr">struts-config.xml</code> file, you specify this name, together with the action or the path to the resource file that provides the view.</p>
<p>In the <b>Add Forward</b> dialog box, you set the following properties:</p>
<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t16">Element</th>
<th align="left" valign="bottom" id="r1c2-t16">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t16" headers="r1c1-t16">
<p>Forward Name</p>
</td>
<td align="left" headers="r2c1-t16 r1c2-t16">Specifies the name of the forward.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t16" headers="r1c1-t16">
<p>Forward To</p>
</td>
<td align="left" headers="r3c1-t16 r1c2-t16">Sets the action and the JSP page.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t16" headers="r1c1-t16">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Resource File</p>
</td>
<td align="left" headers="r4c1-t16 r1c2-t16">Specifies the path to the JSP page that handles the action.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t16" headers="r1c1-t16">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Action</p>
</td>
<td align="left" headers="r5c1-t16 r1c2-t16">Specifies the action that handles the forwardaction or includeaction.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t16" headers="r1c1-t16">
<p>Redirect</p>
</td>
<td align="left" headers="r6c1-t16 r1c2-t16">Prevents a page reload which, in turn, prevents form values from being resubmitted to an application.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r7c1-t16" headers="r1c1-t16">
<p>Location</p>
</td>
<td align="left" headers="r7c1-t16 r1c2-t16">Sets the action and whether the forward is applicable to all.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r8c1-t16" headers="r1c1-t16">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Global</p>
</td>
<td align="left" headers="r8c1-t16 r1c2-t16">Specifies that the forward applies to all actions.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r9c1-t16" headers="r1c1-t16">
<p>&nbsp;&nbsp;&nbsp;&nbsp;Action</p>
</td>
<td align="left" headers="r9c1-t16 r1c2-t16">Specifies the specific action to which the forward applies.</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<p><b>Note:</b> If you want to change a registered forward, you can do so by manually editing the XML tags in the <code dir="ltr">struts-config.xml</code> file.</p>
<a id="NBCSH4262" name="NBCSH4262"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1188">
<param name="text" value="<html><u>&quot;Working with the Struts Framework&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1140">
<param name="text" value="<html><u>&quot;About Using Web Application Frameworks&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<!-- -->
<!-- Start Footer -->
<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>