Modified:
websites/production/struts/content/getting-started/form-validation.html
==============================================================================
--- websites/production/struts/content/getting-started/form-validation.html
(original)
+++ websites/production/struts/content/getting-started/form-validation.html Sun
Apr 2 09:12:56 2017
@@ -123,7 +123,7 @@
<section class="col-md-12">
<h2 id="form-validation">Form Validation</h2>
-<p>This tutorial assumes youâve completed the <em>Processing Forms</em>
tutorial and have a working form_processing project. The example code for this
tutorial, form_validation, is available for checkout from the Struts 2 GitHub
repository: <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
+<p>This tutorial assumes youâve completed the <a
href="processing-forms.html">Processing Forms</a> tutorial and have a working
form_processing project. The example code for this tutorial, form_validation,
is available for checkout from the Struts 2 GitHub repository: <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
<blockquote>
@@ -133,20 +133,7 @@
<p>In this tutorial weâll explore using Struts 2 to validate the userâs
input on a form. There are two ways you can use Struts 2 to do form validation.
This tutorial will cover the more basic method, where the validation is
included in the Struts 2 Action class.</p>
-<table>
- <tbody>
- <tr>
- <td>The <a href="http://struts.apache.org/mail.html";>Struts 2 user
mailing list</a>^[http://struts.apache.org/mail.html] is an excellent place to
get help. If you are having a problem getting the tutorial example applications
to work search the Struts 2 mailing list. If you donât find an answer to your
problem, post a question on the mailing list.</td>
- </tr>
- </tbody>
-</table>
-
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
+<p>The <a href="http://struts.apache.org/mail.html";>Struts 2 user mailing
list</a> is an excellent place to get help. If you are having a problem getting
the tutorial example applications to work search the Struts 2 mailing list. If
you donât find an answer to your problem, post a question on the mailing
list.</p>
<p><strong>Add validate Method</strong></p>
@@ -158,7 +145,7 @@
<li>User younger then 18 cannot register</li>
</ol>
-<p>If you recall from the <em>Processing Forms</em> tutorial the userâs
input into the form fields is placed by Struts 2 into the Java model class
personBean. So a userâs input into the firstName field would end up as the
value for personBeanâs firstName instance field (via the
personBean.setFirstName method).</p>
+<p>If you recall from the <a href="processing-forms.html">Processing Forms</a>
tutorial the userâs input into the form fields is placed by Struts 2 into the
Java model class personBean. So a userâs input into the firstName field would
end up as the value for personBeanâs firstName instance field (via the
personBean.setFirstName method).</p>
<p>In the validate method we can refer to get the values of personBeanâs
instance fields by using the appropriate get methods. Once we have the values
we can employ logic to enforce our business rules.</p>
@@ -166,30 +153,19 @@
<p><strong>validate method</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code> public void
validate(){
-
- if ( personBean.getFirstName().length() == 0 ){
-
- addFieldError( "personBean.firstName", "First name is
required." );
-
- }
-
-
- if ( personBean.getEmail().length() == 0 ){
-
- addFieldError( "personBean.email", "Email is required."
);
-
- }
-
- if ( personBean.getAge() < 18 ){
-
- addFieldError( "personBean.age", "Age is required and
must be 18 or older" );
-
- }
-
-
- }
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="kd">public</span> <span class="kt">void</span> <span
class="nf">validate</span><span class="p">(</span><span class="o">){</span>
+ <span class="k">if</span> <span class="o">(</span><span
class="n">personBean</span><span class="o">.</span><span
class="na">getFirstName</span><span class="o">().</span><span
class="na">length</span><span class="o">()</span> <span class="o">==</span>
<span class="mi">0</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">addFieldError</span><span class="o">(</span><span
class="s">"personBean.firstName"</span><span class="o">,</span> <span
class="s">"First name is required."</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="k">if</span> <span class="o">(</span><span
class="n">personBean</span><span class="o">.</span><span
class="na">getEmail</span><span class="o">().</span><span
class="na">length</span><span class="o">()</span> <span class="o">==</span>
<span class="mi">0</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">addFieldError</span><span class="o">(</span><span
class="s">"personBean.email"</span><span class="o">,</span> <span
class="s">"Email is required."</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="k">if</span> <span class="o">(</span><span
class="n">personBean</span><span class="o">.</span><span
class="na">getAge</span><span class="o">()</span> <span class="o"><</span>
<span class="mi">18</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">addFieldError</span><span class="o">(</span><span
class="s">"personBean.age"</span><span class="o">,</span> <span class="s">"Age
is required and must be 18 or older"</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}</span>
</code></pre>
</div>
@@ -203,8 +179,7 @@
<p>To handle the return value of âinputâ we need to add the following
result to our action node in struts.xml.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code><result
name="input">/register.jsp</result>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><result</span> <span class="na">name=</span><span
class="s">"input"</span><span class="nt">></span>/register.jsp<span
class="nt"></result></span>
</code></pre>
</div>
@@ -216,14 +191,13 @@
<p>So the following addFieldError method call:</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>addFieldError(
"personBean.firstName", "First name is required.")
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="n">addFieldError</span><span class="o">(</span><span
class="s">"personBean.firstName"</span><span class="o">,</span> <span
class="s">"First name is required."</span><span class="o">)</span>
</code></pre>
</div>
<p>will cause the message âFirst name is requiredâ to be displayed above
the firstName field on the form.</p>
-<p>If you have made the above changes to the <em>Processing Forms</em>
tutorial or you have downloaded from <a
href="http://code.google.com/p/struts2-examples/downloads/list";>Google
Code</a>^[http://code.google.com/p/struts2-examples/downloads/list] either the
Form_Validation_Struts2_Ant or Form_Validation_Struts2_Mvn projects run the
application (see the README.txt in the project root folder). Click on the
Please register link. On the registration form, just click the submit button
and you should see:</p>
+<p>If you have made the above changes to the <em>Processing Forms</em>
tutorial or you have downloaded from <a
href="http://code.google.com/p/struts2-examples/downloads/list";>Google Code</a>
either the Form_Validation_Struts2_Ant or Form_Validation_Struts2_Mvn projects
run the application (see the README.txt in the project root folder). Click on
the Please register link. On the registration form, just click the submit
button and you should see:</p>
<p><img src="attachments/att14975003_form_errors.png" alt="form_errors.png"
/></p>
@@ -231,23 +205,13 @@
<p><strong>Styling The Error Messages</strong></p>
-<p>The Struts 2 s:head tag can be used to provide CSS that includes a style
for the error message. Add</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code><s:head />
-</code></pre>
-</div>
-<p>to register.jsp before the closing HTML</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code></head>
-</code></pre>
-</div>
-<p>tag. Go through the same steps as above and you should see:</p>
+<p>The Struts 2 s:head tag can be used to provide CSS that includes a style
for the error message. Add <code class="highlighter-rouge"><s:head
/></code> to register.jsp before the closing HTML <code
class="highlighter-rouge"></head></code> tag. Go through the same steps
as above and you should see:</p>
<p><img src="attachments/att14975001_form_errors_styled.png"
alt="form_errors_styled.png" /></p>
<p><strong>Summary</strong></p>
-<p>This tutorial covered validating a userâs form input by adding a validate
method to an Action class. There is another more sophisticated way to validate
user input using XML. If you want to learn more about using XML for validation
in Struts 2 see <em>Validation</em> .</p>
+<p>This tutorial covered validating a userâs form input by adding a validate
method to an Action class. There is another more sophisticated way to validate
user input using XML. If you want to learn more about using XML for validation
in Struts 2 see <a
href="//struts.apache.org/docs/validation.html">Validation</a> .</p>
<p><strong>Up Next</strong></p>
Modified:
websites/production/struts/content/getting-started/message-resource-files.html
==============================================================================
---
websites/production/struts/content/getting-started/message-resource-files.html
(original)
+++
websites/production/struts/content/getting-started/message-resource-files.html
Sun Apr 2 09:12:56 2017
@@ -123,40 +123,21 @@
<section class="col-md-12">
<h2 id="message-resource-files">Message Resource Files</h2>
-<p>This tutorial assumes youâve completed the <em>Form Validation</em>
tutorial and have a working form_validation project. The example code for this
tutorial, message_resource, is available for checkout from the</p>
+<p>This tutorial assumes youâve completed the <a
href="form-validation.html">Form Validation</a> tutorial and have a working
form_validation project. The example code for this tutorial, message_resource,
is available for checkout from the</p>
-<blockquote>
- <p>Struts 2 GitHub repository at <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
-</blockquote>
-
-<blockquote>
-
-</blockquote>
+<p>Struts 2 GitHub repository at <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
<p><strong>Introduction</strong></p>
<p>In this tutorial weâll explore using Struts 2 message resource
capabilities (also called resource bundles). Message resources provide a simple
way to put text in a view page that is the same through out your application,
to create form field labels, and to change text to a specific language based on
the userâs locale (i18n).</p>
-<table>
- <tbody>
- <tr>
- <td>The <a href="http://struts.apache.org/mail.html";>Struts 2 user
mailing list</a>^[http://struts.apache.org/mail.html] is an excellent place to
get help. If you are having a problem getting the tutorial example applications
to work search the Struts 2 mailing list. If you donât find an answer to your
problem, post a question on the mailing list.</td>
- </tr>
- </tbody>
-</table>
-
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
+<p>The <a href="http://struts.apache.org/mail.html";>Struts 2 user mailing
list</a> is an excellent place to get help. If you are having a problem getting
the tutorial example applications to work search the Struts 2 mailing list. If
you donât find an answer to your problem, post a question on the mailing
list.</p>
<p><strong>Message Resource Property Files</strong></p>
<p>In a Struts 2 web application you may associate a message resource property
file with each Struts 2 Action class by creating a properties file with the
same name as the Action class and having the .properties extension. This
properties file must go in the same package as the Action class. For our
tutorial example, letâs say we want to place the form field labels into a
separate file where we can easily change them and also provide the capability
to display the labels in other languages.</p>
-<p>If youâre doing this tutorial after completing <em>Form Validation</em>
then you can make these changes to that tutorialâs example application.</p>
+<p>If youâre doing this tutorial after completing <a
href="form-validation.html">Form Validation</a> then you can make these changes
to that tutorialâs example application.</p>
<p>Put the text below in a file named Register.properties in the
org.apache.struts.register.action package in the src/resources/java folder.</p>
@@ -167,7 +148,6 @@ personBean.lastName=Last name
personBean.age=Age
personBean.email=Email
thankyou=Thank you for registering %{personBean.firstName}.
-
</code></pre>
</div>
@@ -175,14 +155,13 @@ thankyou=Thank you for registering %{per
<p><strong>Struts 2 Key Attribute</strong></p>
-<p>The Struts 2 key attribute can be used in the <em>textfield</em> tag to
instruct the framework what value to use for the textfieldâs name and label
attributes. Instead of providing those attributes and their values directly,
you can just use the key attribute.</p>
+<p>The Struts 2 key attribute can be used in the <a
href="//struts.apache.org/docs/textfield.html">textfield</a> tag to instruct
the framework what value to use for the textfieldâs name and label
attributes. Instead of providing those attributes and their values directly,
you can just use the key attribute.</p>
-<p>If you open register.jsp from the <em>Form Validation</em> tutorial
youâll see this Struts 2 textfield tag:</p>
+<p>If you open register.jsp from the <a href="form-validation.html">Form
Validation</a> tutorial youâll see this Struts 2 textfield tag:</p>
<p><strong>textfield tag</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><s:textfield
name="personBean.firstName" label="First name" />
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><s:textfield</span> <span class="na">name=</span><span
class="s">"personBean.firstName"</span> <span class="na">label=</span><span
class="s">"First name"</span> <span class="nt">/></span>
</code></pre>
</div>
@@ -190,19 +169,17 @@ thankyou=Thank you for registering %{per
<p><strong>textfield tag with key attribute</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><s:textfield
key="personBean.firstName" />
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><s:textfield</span> <span class="na">key=</span><span
class="s">"personBean.firstName"</span> <span class="nt">/></span>
</code></pre>
</div>
<p>The value for the key attribute instructs the Struts 2 framework to use the
same value for the name attribute (personBean.firstName). For the label
attributeâs value the value of the key attribute is used by the Struts 2
framework to find a key in a properties file with the same value. So in our
example, Struts 2 will look in Register.properties for a key with a value of
personBean.firstName. The value of that key (First name) will be used as the
label attributeâs value.</p>
-<p>To enable the key attribute to find the properties file, the display of the
view page must be the result of executing a Struts 2 Action class. Right now if
you examine index.jsp from the <em>Form Validation</em> tutorial the link to
the register.jsp page is a standard URL.</p>
+<p>To enable the key attribute to find the properties file, the display of the
view page must be the result of executing a Struts 2 Action class. Right now if
you examine index.jsp from the <a href="form-validation.html">Form
Validation</a> tutorial the link to the register.jsp page is a standard URL.</p>
<p><strong>link to register.jsp</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><p><a
href="register.jsp">Please register</a> for our prize
drawing.</p>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"register.jsp"</span><span class="nt">></span>Please register<span
class="nt"></a></span> for our prize drawing.<span
class="nt"></p></span>
</code></pre>
</div>
@@ -210,9 +187,8 @@ thankyou=Thank you for registering %{per
<p><strong>link to Register Action class</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><s:url
action="registerInput" var="registerInputLink" />
-<p><a href="${registerInputLink}">Please register</a> for
our prize drawing.</p>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><s:url</span> <span class="na">action=</span><span
class="s">"registerInput"</span> <span class="na">var=</span><span
class="s">"registerInputLink"</span> <span class="nt">/></span>
+<span class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"${registerInputLink}"</span><span class="nt">></span>Please
register<span class="nt"></a></span> for our prize drawing.<span
class="nt"></p></span>
</code></pre>
</div>
@@ -220,22 +196,21 @@ thankyou=Thank you for registering %{per
<p><strong>registerInput action node for struts.xml</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><action
name="registerInput" class="org.apache.struts.register.action.Register"
method="input" >
- <result name="input">/register.jsp</result>
-</action>
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="nt"><action</span> <span class="na">name=</span><span
class="s">"registerInput"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.register.action.Register"</span> <span
class="na">method=</span><span class="s">"input"</span> <span
class="nt">></span>
+ <span class="nt"><result</span> <span class="na">name=</span><span
class="s">"input"</span><span class="nt">></span>/register.jsp<span
class="nt"></result></span>
+ <span class="nt"></action></span>
</code></pre>
</div>
<p>The above action node instructs the Struts 2 framework to execute class
Registerâs input method in response to action registerInput. The input method
is inherited by class Register from class ActionSupport. The default behavior
of the inherited input method is to return the String input. The result node
above specifies that if the returned result is âinputâ then render the view
register.jsp.</p>
-<p>By doing the above the view page register.jsp will have access to the
properties defined in Register.properties. The Struts 2 framework will make
those properties defined in Register.properties available to the view page
since the view page was rendered after Register.java (the Struts 2 Action
class) was executed.</p>
+<p>By doing the above the view page register.jsp will have access to the
properties defined in <code
class="highlighter-rouge">Register.properties</code>. The Struts 2 framework
will make those properties defined in <code
class="highlighter-rouge">Register.properties</code> available to the view page
since the view page was rendered after Register.java (the Struts 2 Action
class) was executed.</p>
<p>Follow the instructions (README.txt) in the project to create the war file
and copy the war file to your servlet container. Open a web browser and
navigate to the home page specified in the README.txt file (index.action). You
should see a link to registerInput.action when mousing over the hyperlink
Please Register.</p>
<p><img src="attachments/att14975007_registerInput.png"
alt="registerInput.png" /></p>
-<p>When you click on the Please Register link your browser should display the
register.jsp. The form field labels should be the key values from the
Register.properties file.</p>
+<p>When you click on the Please Register link your browser should display the
register.jsp. The form field labels should be the key values from the <code
class="highlighter-rouge">Register.properties</code> file.</p>
<p><img src="attachments/att14975006_register.png" alt="register.png" /></p>
@@ -245,8 +220,7 @@ thankyou=Thank you for registering %{per
<p><strong>text tag</strong></p>
-<div class="highlighter-rouge"><pre
class="highlight"><code><h3><s:text name="thankyou" /></h3>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><h3><s:text</span> <span class="na">name=</span><span
class="s">"thankyou"</span> <span class="nt">/></h3></span>
</code></pre>
</div>
@@ -259,11 +233,10 @@ thankyou=Thank you for registering %{per
<p><strong>Register.properties</strong></p>
<div class="highlighter-rouge"><pre class="highlight"><code>thankyou=Thank you
for registering %{personBean.firstName}.
-
</code></pre>
</div>
-<p>The markup %{personBean.firstName} tells Struts 2 to replace this part with
the result of calling getPersonBean, which returns a Person object. Then call
the getFirstName method which returns a String (the value the user inputted
into the personBean.firstName form field on register.jsp).</p>
+<p>The markup <code class="highlighter-rouge">%{personBean.firstName}</code>
tells Struts 2 to replace this part with the result of calling getPersonBean,
which returns a Person object. Then call the getFirstName method which returns
a String (the value the user inputted into the personBean.firstName form field
on register.jsp).</p>
<p><strong>Package Level Properties</strong></p>
@@ -274,7 +247,6 @@ thankyou=Thank you for registering %{per
<p><strong>package.properties</strong></p>
<div class="highlighter-rouge"><pre class="highlight"><code>greeting=Welcome
to The Wonderful World of Struts 2
-
</code></pre>
</div>
@@ -282,8 +254,7 @@ thankyou=Thank you for registering %{per
<p><strong>Using properties set in package.properties</strong></p>
-<div class="highlighter-rouge"><pre
class="highlight"><code><h1><s:text name="greeting" /></h1>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><h1><s:text</span> <span class="na">name=</span><span
class="s">"greeting"</span> <span class="nt">/></h1></span>
</code></pre>
</div>
@@ -295,14 +266,13 @@ thankyou=Thank you for registering %{per
<p><strong>Global Properties</strong></p>
-<p>You can also specify a global property file in struts.xml. The keys and
values defined in that property file will be available to all the view pages
that are rendered after executing an Action class.</p>
+<p>You can also specify a global property file in <code
class="highlighter-rouge">struts.xml</code>. The keys and values defined in
that property file will be available to all the view pages that are rendered
after executing an Action class.</p>
-<p>Add the following to a file named global.properties (note the name
doesnât have to be global).</p>
+<p>Add the following to a file named <code
class="highlighter-rouge">global.properties</code> (note the name doesnât
have to be global).</p>
<p><strong>global.properties</strong></p>
<div class="highlighter-rouge"><pre class="highlight"><code>contact=For
assistance contact <a
href='mailto:cont...@email.com'>cont...@email.com</a>
-
</code></pre>
</div>
@@ -312,8 +282,7 @@ thankyou=Thank you for registering %{per
<p><strong>Specify Global Property File In struts.xml</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><constant
name="struts.custom.i18n.resources" value="global" />
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><constant</span> <span class="na">name=</span><span
class="s">"struts.custom.i18n.resources"</span> <span
class="na">value=</span><span class="s">"global"</span> <span
class="nt">/></span>
</code></pre>
</div>
@@ -321,9 +290,8 @@ thankyou=Thank you for registering %{per
<p><strong>Using contact property</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><hr />
-<s:text name="contact" />
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="nt"><hr</span> <span class="nt">/></span>
+ <span class="nt"><s:text</span> <span class="na">name=</span><span
class="s">"contact"</span> <span class="nt">/></span>
</code></pre>
</div>
@@ -337,9 +305,9 @@ thankyou=Thank you for registering %{per
<p><strong>Internationalization (i18n)</strong></p>
-<p>Using message resource files (resource bundles) also enables you to provide
text in different languages. By default, Struts 2 will use the userâs default
locale. If that locale is en for English then the property files used will be
the ones without a locale specification (for example Register.properties). If
the locale is not English but say Spanish (es) then Struts 2 will look for a
properties file named Register_es.properties.</p>
+<p>Using message resource files (resource bundles) also enables you to provide
text in different languages. By default, Struts 2 will use the userâs default
locale. If that locale is en for English then the property files used will be
the ones without a locale specification (for example <code
class="highlighter-rouge">Register.properties</code>). If the locale is not
English but say Spanish (es) then Struts 2 will look for a properties file
named <code class="highlighter-rouge">Register_es.properties</code>.</p>
-<p>To provide an example of Struts 2 support for i18n create a file named
Register_es.properties and in that file add the following Spanish
translations.</p>
+<p>To provide an example of Struts 2 support for i18n create a file named
<code class="highlighter-rouge">Register_es.properties</code> and in that file
add the following Spanish translations.</p>
<p><strong>Register_es.properties</strong></p>
@@ -348,7 +316,6 @@ personBean.lastName=Apellidos
personBean.age=Edad
personBean.email=Correo
thankyou=Gracias por registrarse, %{personBean.firstName}.
-
</code></pre>
</div>
@@ -360,35 +327,27 @@ thankyou=Gracias por registrarse, %{pers
</tbody>
</table>
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
-
-<p>Save the Register_es.properties file in the same package as
Register.properties.</p>
+<p>Save the <code class="highlighter-rouge">Register_es.properties</code> file
in the same package as <code
class="highlighter-rouge">Register.properties</code>.</p>
<p>In our example application, we need to tell Struts 2 to use a locale value
of es (since weâre not in a Spanish locale) instead of the default locale
value of our location (which is en). Add the following markup to index.jsp.</p>
<p><strong>Specify The Locale As a URL Parameter</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><h3>Registro
español</h3>
-<s:url action="registerInput" var="registerInputLinkES">
- <s:param name="request_locale">es</s:param>
-</s:url>
-<p><a href="${registerInputLinkES}">Por favor,
regÃstrese</a> para nuestro sorteo</p>
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="nt"><h3></span>Registro español<span class="nt"></h3></span>
+ <span class="nt"><s:url</span> <span class="na">action=</span><span
class="s">"registerInput"</span> <span class="na">var=</span><span
class="s">"registerInputLinkES"</span><span class="nt">></span>
+ <span class="nt"><s:param</span> <span class="na">name=</span><span
class="s">"request_locale"</span><span class="nt">></span>es<span
class="nt"></s:param></span>
+ <span class="nt"></s:url></span>
+ <span class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"${registerInputLinkES}"</span><span class="nt">></span>Por favor,
regÃstrese<span class="nt"></a></span> para nuestro sorteo<span
class="nt"></p></span>
</code></pre>
</div>
-<p>In the above markup weâve added a parameter named request_locale to the
URL. The value of that parameter is es. The Action class that responds to this
URL (Register.java) will see that the locale is es and will look for property
files with _es (for example Register_es.properties). It will use those property
files to find the values of the property keys referenced by the view page (e.g.
personBean.firstName).</p>
+<p>In the above markup weâve added a parameter named request_locale to the
URL. The value of that parameter is es. The Action class that responds to this
URL (Register.java) will see that the locale is es and will look for property
files with _es (for example <code
class="highlighter-rouge">Register_es.properties</code>). It will use those
property files to find the values of the property keys referenced by the view
page (e.g. personBean.firstName).</p>
<p>After clicking on the above link you should see the same form as before but
with the form field labels in Spanish.</p>
<p><img src="attachments/att14975008_spanishform.png" alt="spanishform.png"
/></p>
-<p>If we implement the same concept by creating _es.properties versions of
global.properties (global_es.properties) and package.properties
(package_es.properties) then we can create a complete registration web page in
Spanish. Download the finished example application for this tutorial from
Google Code - <a
href="http://code.google.com/p/struts2-examples/downloads/list";>http://code.google.com/p/struts2-examples/downloads/list</a>
to see those property files and run the complete example with the registration
form in Spanish.</p>
+<p>If we implement the same concept by creating _es.properties versions of
<code class="highlighter-rouge">global.properties</code> (<code
class="highlighter-rouge">global_es.properties</code>) and <code
class="highlighter-rouge">package.properties</code> (<code
class="highlighter-rouge">package_es.properties</code>) then we can create a
complete registration web page in Spanish. Download the finished example
application for this tutorial from Google Code - <a
href="http://code.google.com/p/struts2-examples/downloads/list";>http://code.google.com/p/struts2-examples/downloads/list</a>
to see those property files and run the complete example with the registration
form in Spanish.</p>
<p><strong>Summary</strong></p>
Modified:
websites/production/struts/content/getting-started/processing-forms.html
==============================================================================
--- websites/production/struts/content/getting-started/processing-forms.html
(original)
+++ websites/production/struts/content/getting-started/processing-forms.html
Sun Apr 2 09:12:56 2017
@@ -123,7 +123,7 @@
<section class="col-md-12">
<h2 id="processing-forms">Processing Forms</h2>
-<p>This tutorial assumes youâve completed the <em>Coding Struts 2
Actons</em> tutorial and have a working coding_actions project. The example
code for this tutorial, form_processing, is available for checkout from the
Struts 2 GitHub subversion repository: <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
+<p>This tutorial assumes youâve completed the <a
href="coding-actions.html">Coding Struts 2 Actons</a> tutorial and have a
working coding_actions project. The example code for this tutorial,
form_processing, is available for checkout from the Struts 2 GitHub subversion
repository: <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a>.</p>
<blockquote>
@@ -133,86 +133,61 @@
<p>In this tutorial weâll explore using Struts 2 to do more involved
processing of a form submission. Weâll cover how to use a Java model class to
store the form input and how to create the Struts 2 form to match up with that
model class.</p>
-<p>The code provided in this tutorial may be added to the <em>Coding Struts 2
Actions</em> example or you can download this complete example from Google
Code - <a
href="http://code.google.com/p/struts2-examples/downloads/list";>http://code.google.com/p/struts2-examples/downloads/list</a>.</p>
+<p>The code provided in this tutorial may be added to the <a
href="coding-actions.html">Coding Struts 2 Actions</a> example or you can
download this complete example from Google Code - <a
href="http://code.google.com/p/struts2-examples/downloads/list";>http://code.google.com/p/struts2-examples/downloads/list</a>.</p>
-<table>
- <tbody>
- <tr>
- <td>The <a href="http://struts.apache.org/mail.html";>Struts 2 user
mailing list</a>^[http://struts.apache.org/mail.html] is an excellent place to
get help. If you are having a problem getting the tutorial example applications
to work search the Struts 2 mailing list. If you donât find an answer to your
problem, post a question on the mailing list.</td>
- </tr>
- </tbody>
-</table>
-
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
+<p>The <a href="http://struts.apache.org/mail.html";>Struts 2 user mailing
list</a> is an excellent place to get help. If you are having a problem getting
the tutorial example applications to work search the Struts 2 mailing list. If
you donât find an answer to your problem, post a question on the mailing
list.</p>
<p><strong>Forms and A Java Model Class</strong></p>
<p>For this tutorial letâs say we need to provide a form that a user may
submit to register for a prize drawing. Our business rules state the user must
provide his/her first name, last name, email address, and age.</p>
-<p>To encapsulate this data, weâll use a simple Java class that follows the
basic Java Bean specifications (public set/get methods for each instance
field). If youâre following along add this class to package
org.apache.struts.register.model in the <em>Coding Struts 2 Actions</em>
example.</p>
+<p>To encapsulate this data, weâll use a simple Java class that follows the
basic Java Bean specifications (public set/get methods for each instance
field). If youâre following along add this class to package
org.apache.struts.register.model in the <a href="coding-actions.html">Coding
Struts 2 Actions</a> example.</p>
<p><strong>Person.java</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code>public class Person
-{
- private String firstName;
- private String lastName;
- private String email;
- private int age;
-
- public String getFirstName()
- {
- return firstName;
- }
-
- public void setFirstName(String firstName)
- {
- this.firstName = firstName;
- }
-
- public String getLastName()
- {
- return lastName;
- }
-
- public void setLastName(String lastName)
- {
- this.lastName = lastName;
- }
-
- public String getEmail()
- {
- return email;
- }
-
- public void setEmail(String email)
- {
- this.email = email;
- }
-
- public int getAge()
- {
- return age;
- }
-
- public void setAge( int age)
- {
- this.age = age;
- }
-
-
- public String toString()
- {
- return "First Name: " + getFirstName() + " Last Name: " +
getLastName() +
- " Email: " + getEmail() + " Age: " + getAge() ;
- }
-}
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kd">public</span> <span class="kd">class</span> <span
class="nc">Person</span> <span class="o">{</span>
+ <span class="kd">private</span> <span class="n">String</span> <span
class="n">firstName</span><span class="o">;</span>
+ <span class="kd">private</span> <span class="n">String</span> <span
class="n">lastName</span><span class="o">;</span>
+ <span class="kd">private</span> <span class="n">String</span> <span
class="n">email</span><span class="o">;</span>
+ <span class="kd">private</span> <span class="kt">int</span> <span
class="n">age</span><span class="o">;</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">getFirstName</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">firstName</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setFirstName</span><span class="o">(</span><span
class="n">String</span> <span class="n">firstName</span><span
class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">firstName</span> <span class="o">=</span> <span
class="n">firstName</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">getLastName</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">lastName</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setLastName</span><span class="o">(</span><span
class="n">String</span> <span class="n">lastName</span><span class="o">)</span>
<span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">lastName</span> <span class="o">=</span> <span
class="n">lastName</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">getEmail</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">email</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setEmail</span><span class="o">(</span><span class="n">String</span>
<span class="n">email</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">email</span> <span class="o">=</span> <span
class="n">email</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">int</span> <span
class="n">getAge</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">age</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setAge</span><span class="o">(</span><span class="kt">int</span>
<span class="n">age</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">age</span> <span class="o">=</span> <span class="n">age</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">toString</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="s">"First Name: "</span>
<span class="o">+</span> <span class="n">getFirstName</span><span
class="o">()</span> <span class="o">+</span> <span class="s">" Last Name:
"</span> <span class="o">+</span> <span class="n">getLastName</span><span
class="o">()</span> <span class="o">+</span>
+ <span class="s">" Email: "</span> <span class="o">+</span> <span
class="n">getEmail</span><span class="o">()</span> <span class="o">+</span>
<span class="s">" Age: "</span> <span class="o">+</span> <span
class="n">getAge</span><span class="o">()</span> <span class="o">;</span>
+ <span class="o">}</span>
+<span class="o">}</span>
</code></pre>
</div>
@@ -226,31 +201,29 @@
<div class="highlighter-rouge"><pre class="highlight"><code><span
class="cp"><?xml version="1.0" encoding="ISO-8859-1" ?></span>
<span class="err"><</span>%@ taglib prefix="s" uri="/struts-tags" %>
-<span class="err"><</span>%@ page language="java" contentType="text/html;
charset=ISO-8859-1"
- pageEncoding="ISO-8859-1"%>
+<span class="err"><</span>%@ page language="java" contentType="text/html;
charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<span class="cp"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0
Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"></span>
<span class="nt"><html</span> <span class="na">xmlns=</span><span
class="s">"http://www.w3.org/1999/xhtml";</span><span class="nt">></span>
-<span class="nt"><head></span>
-<span class="nt"><meta</span> <span class="na">http-equiv=</span><span
class="s">"Content-Type"</span> <span class="na">content=</span><span
class="s">"text/html; charset=ISO-8859-1"</span> <span class="nt">/></span>
-<span class="nt"><title></span>Register<span
class="nt"></title></span>
-<span class="nt"></head></span>
-<span class="nt"><body></span>
-<span class="nt"><h3></span>Register for a prize by completing this
form.<span class="nt"></h3></span>
-
-<span class="nt"><s:form</span> <span class="na">action=</span><span
class="s">"register"</span><span class="nt">></span>
-
- <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.firstName"</span> <span
class="na">label=</span><span class="s">"First name"</span> <span
class="nt">/></span>
- <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.lastName"</span> <span
class="na">label=</span><span class="s">"Last name"</span> <span
class="nt">/></span>
- <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.email"</span> <span
class="na">label =</span><span class="s">"Email"</span><span
class="nt">/></span>
- <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.age"</span> <span
class="na">label=</span><span class="s">"Age"</span> <span
class="nt">/></span>
-
- <span class="nt"><s:submit/></span>
+ <span class="nt"><head></span>
+ <span class="nt"><meta</span> <span class="na">http-equiv=</span><span
class="s">"Content-Type"</span> <span class="na">content=</span><span
class="s">"text/html; charset=ISO-8859-1"</span> <span class="nt">/></span>
+ <span class="nt"><title></span>Register<span
class="nt"></title></span>
+ <span class="nt"></head></span>
+ <span class="nt"><body></span>
+ <span class="nt"><h3></span>Register for a prize by completing this
form.<span class="nt"></h3></span>
+
+ <span class="nt"><s:form</span> <span class="na">action=</span><span
class="s">"register"</span><span class="nt">></span>
+
+ <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.firstName"</span> <span
class="na">label=</span><span class="s">"First name"</span> <span
class="nt">/></span>
+ <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.lastName"</span> <span
class="na">label=</span><span class="s">"Last name"</span> <span
class="nt">/></span>
+ <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.email"</span> <span
class="na">label =</span><span class="s">"Email"</span><span
class="nt">/></span>
+ <span class="nt"><s:textfield</span> <span
class="na">name=</span><span class="s">"personBean.age"</span> <span
class="na">label=</span><span class="s">"Age"</span> <span
class="nt">/></span>
+
+ <span class="nt"><s:submit/></span>
-<span class="nt"></s:form></span>
+ <span class="nt"></s:form></span>
-<span class="nt"></body></span>
+ <span class="nt"></body></span>
<span class="nt"></html></span>
-
</code></pre>
</div>
@@ -262,52 +235,45 @@
<p>The complete name value, personBean.firstName, instructs Struts 2 to use
the input value for that textfield as the argument to the personBean objectâs
setFirstName method. So if the user types âBruceâ in the textfield that has
the label âFirst nameâ, the personBeanâs firstName instance field will
have a value of âBruceâ.</p>
-<p>Note we have a Struts 2 textfield for each instance field of the class
Person. Remember that Person classâs age attribute is of type integer. All
form field input values are Strings. Struts 2 will automatically convert the
String value (â25â) the user entered for the age form field to 25 when
calling the setAge method of object personBean.</p>
+<p>Note that we have a Struts 2 textfield for each instance field of the class
Person. Remember that Person classâs age attribute is of type integer. All
form field input values are Strings. Struts 2 will automatically convert the
String value (â25â) the user entered for the age form field to 25 when
calling the setAge method of object personBean.</p>
<p><strong>Creating the Action Class To Handle the Form Submission</strong></p>
-<p>When the user clicks on the submit button of the above form, the action
âregisterâ and the form data will be sent to the Struts 2 framework. We
need an Action class to process this form. If you recall from the tutorial
<em>Coding Struts 2 Actions</em> our Action class should extends the Struts 2
ActionSupport class.</p>
+<p>When the user clicks on the submit button of the above form, the action
âregisterâ and the form data will be sent to the Struts 2 framework. We
need an Action class to process this form. If you recall from the tutorial <a
href="coding-actions.html">Coding Struts 2 Actions</a> our Action class should
extend the Struts 2 ActionSupport class.</p>
<p>Here is the Action class used for this example. Place it in package
org.apache.struts.register.action.</p>
<p><strong>Register.java Struts 2 Action Class</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code>package
org.apache.struts.register.action;
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kn">package</span> <span class="n">org</span><span
class="o">.</span><span class="na">apache</span><span class="o">.</span><span
class="na">struts</span><span class="o">.</span><span
class="na">register</span><span class="o">.</span><span
class="na">action</span><span class="o">;</span>
-import org.apache.struts.register.model.Person;
+<span class="kn">import</span> <span
class="nn">org.apache.struts.register.model.Person</span><span
class="o">;</span>
-import com.opensymphony.xwork2.ActionSupport;
+<span class="kn">import</span> <span
class="nn">com.opensymphony.xwork2.ActionSupport</span><span class="o">;</span>
-public class Register extends ActionSupport {
+<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">Register</span> <span class="kd">extends</span> <span
class="n">ActionSupport</span> <span class="o">{</span>
- private static final long serialVersionUID = 1L;
+ <span class="kd">private</span> <span class="kd">static</span> <span
class="kd">final</span> <span class="kt">long</span> <span
class="n">serialVersionUID</span> <span class="o">=</span> <span
class="mi">1L</span><span class="o">;</span>
- private Person personBean;
+ <span class="kd">private</span> <span class="n">Person</span> <span
class="n">personBean</span><span class="o">;</span>
- @Override
- public String execute() throws Exception {
-
- //call Service class to store personBean's state in database
-
- return SUCCESS;
-
- }
-
- public Person getPersonBean() {
-
- return personBean;
-
- }
-
- public void setPersonBean(Person person) {
-
- personBean = person;
-
- }
-
-}
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">execute</span><span class="o">()</span> <span
class="kd">throws</span> <span class="n">Exception</span> <span
class="o">{</span>
+ <span class="c1">//call Service class to store personBean's state in
database</span>
+
+ <span class="k">return</span> <span class="n">SUCCESS</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">Person</span> <span
class="n">getPersonBean</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">personBean</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setPersonBean</span><span class="o">(</span><span
class="n">Person</span> <span class="n">person</span><span class="o">)</span>
<span class="o">{</span>
+ <span class="n">personBean</span> <span class="o">=</span> <span
class="n">person</span><span class="o">;</span>
+ <span class="o">}</span>
+<span class="o">}</span>
</code></pre>
</div>
@@ -329,30 +295,25 @@ public class Register extends ActionSupp
<div class="highlighter-rouge"><pre class="highlight"><code><span
class="cp"><?xml version="1.0" encoding="ISO-8859-1" ?></span>
<span class="err"><</span>%@ taglib prefix="s" uri="/struts-tags" %>
-<span class="err"><</span>%@ page language="java" contentType="text/html;
charset=ISO-8859-1"
- pageEncoding="ISO-8859-1"%>
+<span class="err"><</span>%@ page language="java" contentType="text/html;
charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<span class="cp"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0
Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"></span>
<span class="nt"><html</span> <span class="na">xmlns=</span><span
class="s">"http://www.w3.org/1999/xhtml";</span><span class="nt">></span>
-<span class="nt"><head></span>
-<span class="nt"><meta</span> <span class="na">http-equiv=</span><span
class="s">"Content-Type"</span> <span class="na">content=</span><span
class="s">"text/html; charset=ISO-8859-1"</span> <span class="nt">/></span>
-<span class="nt"><title></span>Registration Successful<span
class="nt"></title></span>
-<span class="nt"></head></span>
-<span class="nt"><body></span>
-<span class="nt"><h3></span>Thank you for registering for a prize.<span
class="nt"></h3></span>
-
-<span class="nt"><p></span>Your registration information: <span
class="nt"><s:property</span> <span class="na">value=</span><span
class="s">"personBean"</span> <span class="nt">/></span> <span
class="nt"></p></span>
+ <span class="nt"><head></span>
+ <span class="nt"><meta</span> <span class="na">http-equiv=</span><span
class="s">"Content-Type"</span> <span class="na">content=</span><span
class="s">"text/html; charset=ISO-8859-1"</span> <span class="nt">/></span>
+ <span class="nt"><title></span>Registration Successful<span
class="nt"></title></span>
+ <span class="nt"></head></span>
+ <span class="nt"><body></span>
+ <span class="nt"><h3></span>Thank you for registering for a
prize.<span class="nt"></h3></span>
-<span class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"<s:url action='index' />"</span> <span
class="nt">></span>Return to home page<span
class="nt"></a></span>.<span class="nt"></p></span>
+ <span class="nt"><p></span>Your registration information: <span
class="nt"><s:property</span> <span class="na">value=</span><span
class="s">"personBean"</span> <span class="nt">/></span> <span
class="nt"></p></span>
-<span class="nt"></body></span>
+ <span class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"<s:url action='index' />"</span> <span
class="nt">></span>Return to home page<span
class="nt"></a></span>.<span class="nt"></p></span>
+ <span class="nt"></body></span>
<span class="nt"></html></span>
-
-
-
</code></pre>
</div>
-<p>If you donât recall how the Struts 2 property and url tags work consult
the <a href="#PAGE_14811875">Using Struts 2 Tags</a> tutorial.</p>
+<p>If you donât recall how the Struts 2 property and url tags work consult
the <a href="using-tags.html">Using Struts 2 Tags</a> tutorial.</p>
<p><strong>Create action Node In struts.xml</strong></p>
@@ -360,11 +321,9 @@ public class Register extends ActionSupp
<p><strong>action node for struts.xml</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><action
name="register" class="org.apache.struts.register.action.Register"
method="execute">
- <result name="success">/thankyou.jsp</result>
-</action>
-
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><action</span> <span class="na">name=</span><span
class="s">"register"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.register.action.Register"</span> <span
class="na">method=</span><span class="s">"execute"</span><span
class="nt">></span>
+ <span class="nt"><result</span> <span class="na">name=</span><span
class="s">"success"</span><span class="nt">></span>/thankyou.jsp<span
class="nt"></result></span>
+<span class="nt"></action></span>
</code></pre>
</div>
@@ -378,8 +337,7 @@ public class Register extends ActionSupp
<p><strong>Link to register.jsp</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><p><a
href="register.jsp">Please register</a> for our prize
drawing.</p>
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><p><a</span> <span class="na">href=</span><span
class="s">"register.jsp"</span><span class="nt">></span>Please register<span
class="nt"></a></span> for our prize drawing.<span
class="nt"></p></span>
</code></pre>
</div>
Modified: websites/production/struts/content/getting-started/spring.html
==============================================================================
--- websites/production/struts/content/getting-started/spring.html (original)
+++ websites/production/struts/content/getting-started/spring.html Sun Apr 2
09:12:56 2017
@@ -125,44 +125,15 @@
<p>The example code for this tutorial, spring_struts, is available for
checkout at <a
href="https://github.com/apache/struts-examples";>https://github.com/apache/struts-examples</a></p>
-<blockquote>
-
-</blockquote>
-
-<p>#####Introduction#####</p>
+<p><strong>Introduction</strong></p>
<p>In the execute method of many Struts 2 ActionSupport classes are statements
that create objects and then have those objects execute methods that perform
needed tasks. Whenever one class creates an object of another class that
introduces a dependency between the two classes. The Spring framework makes it
easier for the application developer to manage these dependencies and helps
make the application more flexible and maintainable. This tutorial will show
you how to use Struts 2 and Spring together to manage the dependencies between
your ActionSupport classes and other classes in your application.</p>
<blockquote>
-
-</blockquote>
-
-<blockquote>
-
-</blockquote>
-
-<blockquote>
<p>This tutorial assumes you understand how to use the Spring framework to
manage dependencies between classes. You can learn more about Spring by reading
the documentation at <a
href="http://www.springsource.org/documentation";>http://www.springsource.org/documentation</a></p>
</blockquote>
-<blockquote>
-
-</blockquote>
-
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
-
-<table>
- <tbody>
- <tr>
- <td>The <a href="http://struts.apache.org/mail.html";>Struts 2 user
mailing list</a>^[http://struts.apache.org/mail.html] is an excellent place to
get help. If you are having a problem getting the tutorial example applications
to work search the Struts 2 mailing list. If you donât find an answer to your
problem, post a question on the mailing list.</td>
- </tr>
- </tbody>
-</table>
+<p>The <a href="http://struts.apache.org/mail.html";>Struts 2 user mailing
list</a> is an excellent place to get help. If you are having a problem getting
the tutorial example applications to work search the Struts 2 mailing list. If
you donât find an answer to your problem, post a question on the mailing
list.</p>
<table>
<tbody>
@@ -175,85 +146,68 @@
<p><strong>EditAction Class Hard-Coded Dependency</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code>private
EditService editService = new EditServiceInMemory();
-
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kd">private</span> <span class="n">EditService</span> <span
class="n">editService</span> <span class="o">=</span> <span
class="k">new</span> <span class="n">EditServiceInMemory</span><span
class="o">();</span>
</code></pre>
</div>
-<p>The above statement hard-codes a dependency between the EditAction class
and the EditServiceInMemory class. This is poor design for two reasons.</p>
+<p>The above statement hard-codes a dependency between the <code
class="highlighter-rouge">EditAction</code> class and the <code
class="highlighter-rouge">EditServiceInMemory</code> class. This is poor design
for two reasons.</p>
<ol>
<li>
- <p>If I need to replace the EditServiceInMemory with another class that
implements the EditService interface Iâll have to hunt down and replace all
statements where I hard-coded the dependency.</p>
+ <p>If I need to replace the <code
class="highlighter-rouge">EditServiceInMemory</code> with another class that
implements the <code class="highlighter-rouge">EditService</code> interface
Iâll have to hunt down and replace all statements where I hard-coded the
dependency.</p>
</li>
<li>
- <p>I cannot test EditAction without using the EditServiceInMemory class. I
cannot isolate EditAction by using a stub implementation of EditService when
writing my test case because the use of EditServiceInMemory is hard-coded.</p>
+ <p>I cannot test <code class="highlighter-rouge">EditAction</code> without
using the <code class="highlighter-rouge">EditServiceInMemory</code> class. I
cannot isolate <code class="highlighter-rouge">EditAction</code> by using a
stub implementation of <code class="highlighter-rouge">EditService</code> when
writing my test case because the use of <code
class="highlighter-rouge">EditServiceInMemory</code> is hard-coded.</p>
</li>
</ol>
-<p>Spring provides a mechanism to manage dependencies by injecting them at run
time. Struts 2 ActionSupport classesâlike any other Java classâcan be
injected with a dependent object by the Spring framework. So instead of having
the above code, I would have this statement in EditAction.</p>
+<p>Spring provides a mechanism to manage dependencies by injecting them at run
time. Struts 2 ActionSupport classesâlike any other Java classâcan be
injected with a dependent object by the Spring framework. So instead of having
the above code, I would have this statement in <code
class="highlighter-rouge">EditAction</code>.</p>
<p><strong>EditAction Class No Hard-Coded Dependency</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code> private
EditService editService ;
-
-
+<div class="highlighter-rouge"><pre class="highlight"><code> <span
class="kd">private</span> <span class="n">EditService</span> <span
class="n">editService</span> <span class="o">;</span>
</code></pre>
</div>
<p>At run time the Spring framework will provide an object of a class that
implements the EditService interface.</p>
-<p>#####Struts 2 Spring Plugin#####</p>
+<p><strong>Struts 2 Spring Plugin</strong></p>
-<p>Struts 2 provides a plugin that enables Spring to inject into the
ActionSupport classes any dependent objects youâve specified in the Spring
configuration file. Consult <em>Spring Plugin documentation</em> for more
information about how the plugin works.</p>
+<p>Struts 2 provides a plugin that enables Spring to inject into the
ActionSupport classes any dependent objects youâve specified in the Spring
configuration file. Consult <a
href="//struts.apache.org/docs/spring-plugin.html">Spring Plugin
documentation</a> for more information about how the plugin works.</p>
<p>For a Maven application youâll need to add a dependency to the
struts2-spring-plugin jar (see the Maven example application for this
tutorial). The pluginâs pom.xml includes transitive dependencies to the
Spring jar files.</p>
<table>
<tbody>
<tr>
- <td>The current version (2.3.15) of the Struts 2 Spring plugin has
transitive dependencies to the Spring 3.0.5 version. If you want to use the
latest version of Spring, then you should exclude the transitive dependencies
in your pom.xml for the Struts 2 Spring plugin and then declare dependency
nodes to the current version of the Spring jar files. If you are using Ant and
explicitly including the jar files in your application, then just include the
latest version of the Spring jar files.</td>
+ <td>The current version (<code
class="highlighter-rouge">2.5.10.1</code>) of the Struts 2 Spring plugin has
transitive dependencies to the Spring <code
class="highlighter-rouge">4.1.6.RELEASE</code> version. If you want to use the
latest version of Spring, then you should exclude the transitive dependencies
in your pom.xml for the Struts 2 Spring plugin and then declare dependency
nodes to the current version of the Spring jar files. If you are using Ant and
explicitly including the jar files in your application, then just include the
latest version of the Spring jar files.</td>
</tr>
</tbody>
</table>
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
-
-<p>In your ActionSupport class you must have a set method for the dependent
object that follows standard Java bean naming conventions. If you examine the
EditAction class for this tutorialâs application youâll see this set
method.</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>public void
setEditService(EditService editService) {
-
- this.editService = editService;
-
-}
-
+<p>In your <code class="highlighter-rouge">ActionSupport</code> class you must
have a set method for the dependent object that follows standard Java bean
naming conventions. If you examine the <code
class="highlighter-rouge">EditAction</code> class for this tutorialâs
application youâll see this set method.</p>
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kd">public</span> <span class="kt">void</span> <span
class="nf">setEditService</span><span class="p">(</span><span
class="n">EditService</span> <span class="n">editService</span><span
class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">editService</span> <span class="o">=</span> <span
class="n">editService</span><span class="o">;</span>
+<span class="o">}</span>
</code></pre>
</div>
-<p>Spring will use that set method to provide an object of type EditService to
the EditAction class at run time.</p>
+<p>Spring will use that set method to provide an object of type <code
class="highlighter-rouge">EditService</code> to the <code
class="highlighter-rouge">EditAction</code> class at run time.</p>
<p>To make our application âSpring awareâ we need to add this line to
web.xml.</p>
<p><strong>Spring Listener In web.xml</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><listener>
-
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
-</listener>
-
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><listener></span>
+ <span
class="nt"><listener-class></span>org.springframework.web.context.ContextLoaderListener<span
class="nt"></listener-class></span>
+<span class="nt"></listener></span>
</code></pre>
</div>
<p>The above code will activate the Spring framework when the application is
started up by the Servlet container. By default Spring will look for a
configuration file name applicationContext.xml in WEB-INF (consult the Spring
documentation for how you can change where Spring looks and what the
configuration file name is).</p>
-<p>#####Spring Configuration File#####</p>
+<p><strong>Spring Configuration File</strong></p>
<p>In the Spring configuration file we create a bean node for those objects we
want Spring to create an instance of and inject into our ActionSupport class.
In the example application is this applicationContext.xml.</p>
@@ -266,34 +220,19 @@
<span
class="err">http://www.springframework.org/schema/beans</span>
<span
class="err">http://www.springframework.org/schema/beans/spring-beans.xsd";</span><span
class="nt">></span>
-<span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editService"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.service.EditServiceInMemory"</span> <span
class="nt">/></span>
+ <span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editService"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.service.EditServiceInMemory"</span> <span
class="nt">/></span>
<span class="nt"></beans></span>
-
-
</code></pre>
</div>
-<p>Note the id value above. By default the Spring plugin works with Spring to
autowire the dependencies of the ActionClass by âname.â Spring will create
an object of class EditServiceMemory and provide that object to any
ActionSupport class that has a setEditService method with an argument of type
EditService. Consult the <em>Spring Plugin</em> documentation for how to
change the default autowire method.</p>
+<p>Note the id value above. By default the Spring plugin works with Spring to
autowire the dependencies of the ActionClass by âname.â Spring will create
an object of class EditServiceMemory and provide that object to any
ActionSupport class that has a setEditService method with an argument of type
EditService. Consult the <a
href="//struts.apache.org/docs/spring-plugin.html">Spring Plugin</a>
documentation for how to change the default autowire method.</p>
-<table>
- <tbody>
- <tr>
- <td>The editService bean created by Spring will have a scope of
singleton since that is the default scope. Consult section 3.5 of the <a
href="http://www.springsource.org/documentation";>Spring
documentation</a>^[http://www.springsource.org/documentation] for how to
configure the bean definition to use a different scope (e.g. request or
session).</td>
- </tr>
- </tbody>
-</table>
+<p>The editService bean created by Spring will have a scope of singleton since
that is the default scope. Consult section 3.5 of the <a
href="http://www.springsource.org/documentation";>Spring documentation</a> for
how to configure the bean definition to use a different scope (e.g. request or
session).</p>
-<table>
- <tbody>
- <tr>
- </tr>
- </tbody>
-</table>
+<p><strong>Alternative - Have Spring Manage Creation Of ActionSupport
Class</strong></p>
-<p>#####Alternative - Have Spring Manage Creation Of ActionSupport
Class#####</p>
-
-<p>Using the above methodology, the Struts 2 framework will still manage the
creation of the ActionSupport class. If you prefer you can configure the
application so that Spring will create the ActionSupport class also. To support
this technique you need to add a bean node to the Spring configuration file for
the ActionSupport class.</p>
+<p>Using the above methodology, the Struts 2 framework will still manage the
creation of the <code class="highlighter-rouge">ActionSupport</code> class. If
you prefer you can configure the application so that Spring will create the
ActionSupport class also. To support this technique you need to add a bean node
to the Spring configuration file for the ActionSupport class.</p>
<p><strong>Spring Configuration For ActionSupport Class Managed By
Spring</strong></p>
@@ -304,83 +243,29 @@
<span
class="err">http://www.springframework.org/schema/beans</span>
<span
class="err">http://www.springframework.org/schema/beans/spring-beans.xsd";</span><span
class="nt">></span>
+ <span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editService"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.service.EditServiceInMemory"</span> <span
class="nt">/></span>
-<span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editService"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.service.EditServiceInMemory"</span> <span
class="nt">/></span>
-
-<span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editAction"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.action.EditAction"</span> <span
class="na">scope=</span><span class="s">"prototype"</span><span
class="nt">></span>
-
- <span class="nt"><property</span> <span class="na">name=</span><span
class="s">"editService"</span> <span class="na">ref=</span><span
class="s">"editService"</span> <span class="nt">/></span>
-
-<span class="nt"></bean></span>
+ <span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"editAction"</span> <span class="na">class=</span><span
class="s">"org.apache.struts.edit.action.EditAction"</span> <span
class="na">scope=</span><span class="s">"prototype"</span><span
class="nt">></span>
+ <span class="nt"><property</span> <span
class="na">name=</span><span class="s">"editService"</span> <span
class="na">ref=</span><span class="s">"editService"</span> <span
class="nt">/></span>
+ <span class="nt"></bean></span>
<span class="nt"></beans></span>
-
-
-</code></pre>
-</div>
-
-<p>Note in the above that there is an</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>editAction
-</code></pre>
-</div>
-<p>Â bean and its</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>editService
-</code></pre>
-</div>
-<p>Â property is set to the</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>editService
-</code></pre>
-</div>
-<p>Â bean. Since we are having Spring manage the</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>EditAction
</code></pre>
</div>
-<p>Â class we must specify any properties of</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>EditAction
-</code></pre>
-</div>
-<p>Â that we want Spring to inject. Please remember that actions must be
created on each request, they cannot be </p>
+<p>Note in the above that there is an <code
class="highlighter-rouge">editAction</code>Â bean and its <code
class="highlighter-rouge">editService</code>Â property is set to the <code
class="highlighter-rouge">editService</code>Â bean. Since we are having Spring
manage the <code class="highlighter-rouge">EditAction</code> class we must
specify any properties of <code class="highlighter-rouge">EditAction</code>Â
that we want Spring to inject. Please remember that actions must be created on
each request, they cannot be <code
class="highlighter-rouge">singletons</code>- this is the default <code
class="highlighter-rouge">scope</code> thatâs why it must be changed toÂ
<code class="highlighter-rouge">prototype</code>.</p>
-<div class="highlighter-rouge"><pre class="highlight"><code>singletons
-</code></pre>
-</div>
-<ul>
- <li>this is the default </li>
-</ul>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>scope
-</code></pre>
-</div>
-<p>thatâs why it must be changed to </p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>prototype
-</code></pre>
-</div>
-<p>.</p>
-
-<p>In the</p>
-
-<div class="highlighter-rouge"><pre class="highlight"><code>struts.xml
-</code></pre>
-</div>
-<p>Â configuration file you must specify the Spring id value for the class
attribute of the action node. This tells Struts to get a bean with that id
value from Spring for the Action class.</p>
+<p>In the <code class="highlighter-rouge">struts.xml</code>Â configuration
file you must specify the Spring id value for the class attribute of the action
node. This tells Struts to get a bean with that id value from Spring for the
Action class.</p>
<p><strong>Struts Configuration For Spring Managed ActionSupport
Class</strong></p>
-<div class="highlighter-rouge"><pre class="highlight"><code><action
name="edit" class="editAction" method="input">
- <result name="input">/edit.jsp</result>
-</action>
-
-
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><action</span> <span class="na">name=</span><span
class="s">"edit"</span> <span class="na">class=</span><span
class="s">"editAction"</span> <span class="na">method=</span><span
class="s">"input"</span><span class="nt">></span>
+ <span class="nt"><result</span> <span class="na">name=</span><span
class="s">"input"</span><span class="nt">></span>/edit.jsp<span
class="nt"></result></span>
+<span class="nt"></action></span>
</code></pre>
</div>
-<p>#####Summary#####</p>
+<p><strong>Summary</strong></p>
<p>In this tutorial we reviewed how to use the Struts 2 Spring plugin to
integrate Spring and Struts. By using the Struts 2 Spring plugin you can have
Spring manage the dependencies of your ActionSupport classes. Of course you can
also take advantage of the many other benefits (AOP, Spring JDBC) that the
Spring framework provides.</p>
