This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/struts-site.git
commit f86663fd386bfe81d0f9407f8ea9dc721a9b269f
Author: jenkins <bui...@apache.org>
AuthorDate: Sat Nov 5 14:06:40 2022 +0000
Updates stage by Jenkins
---
content/core-developers/default-properties.html | 3 +
content/core-developers/interceptors.html | 5 +
content/core-developers/struts-default-xml.html | 5 +
content/plugins/async/index.html | 290 ++++++++++++++++++++++++
content/plugins/bean-validation/index.html | 101 +++++----
content/plugins/cdi/index.html | 25 +-
content/plugins/codebehind/index.html | 13 +-
content/plugins/config-browser/index.html | 32 ++-
content/plugins/convention/index.html | 2 +-
content/plugins/dwr/index.html | 23 +-
content/plugins/embedded-jsp/index.html | 17 +-
content/plugins/index.html | 5 +
content/plugins/jasperreports/index.html | 127 +++++------
content/plugins/java-8-support/index.html | 18 +-
content/plugins/javatemplates/index.html | 48 ++--
content/plugins/jfreechart/index.html | 20 +-
content/plugins/jsf/index.html | 18 +-
content/plugins/json/index.html | 2 +-
content/plugins/junit/index.html | 2 +-
content/plugins/osgi/index.html | 22 +-
content/plugins/oval/index.html | 17 +-
content/plugins/plexus/index.html | 14 +-
content/plugins/portlet-tiles/index.html | 10 +-
content/plugins/portlet/index.html | 21 +-
content/plugins/rest/index.html | 2 +-
content/plugins/sitegraph/index.html | 132 +++++------
content/plugins/sitemesh/index.html | 60 +++--
content/plugins/spring/index.html | 111 +++++----
content/plugins/struts-1/index.html | 14 +-
content/plugins/testng/index.html | 17 +-
content/plugins/tiles-3/index.html | 17 +-
content/plugins/tiles/index.html | 2 +-
content/tag-developers/css-xhtml-theme.html | 2 +-
content/tag-developers/simple-theme.html | 2 +-
content/tag-developers/xhtml-theme.html | 10 +-
35 files changed, 855 insertions(+), 354 deletions(-)
diff --git a/content/core-developers/default-properties.html
b/content/core-developers/default-properties.html
index d8e2758be..741a47f39 100644
--- a/content/core-developers/default-properties.html
+++ b/content/core-developers/default-properties.html
@@ -424,6 +424,9 @@ struts.ognl.expressionMaxLength=256
### These formatters are using a slightly different patterns, please check
JavaDocs of both and more details is in WW-5016
struts.date.formatter=dateTimeFormatter
+struts.url.encoder=strutsUrlEncoder
+struts.url.decoder=strutsUrlDecoder
+
### END SNIPPET: complete_file</code></pre></figure>
diff --git a/content/core-developers/interceptors.html
b/content/core-developers/interceptors.html
index 0e6587bcd..263b0a7ef 100644
--- a/content/core-developers/interceptors.html
+++ b/content/core-developers/interceptors.html
@@ -541,6 +541,11 @@ than reiterate the same list of Interceptors, we can
bundle these Interceptors t
<span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"com.opensymphony.xwork2.ognl.BeanInfoCacheFactory"</span> <span
class="na">name=</span><span class="s">"struts"</span>
<span class="na">class=</span><span
class="s">"com.opensymphony.xwork2.ognl.DefaultOgnlBeanInfoCacheFactory"</span>
<span class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+ <span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"org.apache.struts2.url.UrlEncoder"</span> <span
class="na">name=</span><span class="s">"strutsUrlEncoder"</span>
+ <span class="na">class=</span><span
class="s">"org.apache.struts2.url.StrutsUrlEncoder"</span> <span
class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+ <span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"org.apache.struts2.url.UrlDecoder"</span> <span
class="na">name=</span><span class="s">"strutsUrlDecoder"</span>
+ <span class="na">class=</span><span
class="s">"org.apache.struts2.url.StrutsUrlDecoder"</span> <span
class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+
<span class="nt"><package</span> <span class="na">name=</span><span
class="s">"struts-default"</span> <span class="na">abstract=</span><span
class="s">"true"</span><span class="nt">></span>
<span class="nt"><result-types></span>
<span class="nt"><result-type</span> <span
class="na">name=</span><span class="s">"chain"</span> <span
class="na">class=</span><span
class="s">"com.opensymphony.xwork2.ActionChainResult"</span><span
class="nt">/></span>
diff --git a/content/core-developers/struts-default-xml.html
b/content/core-developers/struts-default-xml.html
index acf692a9b..6b68117a6 100644
--- a/content/core-developers/struts-default-xml.html
+++ b/content/core-developers/struts-default-xml.html
@@ -457,6 +457,11 @@ setting in <a
href="default-properties">default.properties</a>.</p>
<span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"com.opensymphony.xwork2.ognl.BeanInfoCacheFactory"</span> <span
class="na">name=</span><span class="s">"struts"</span>
<span class="na">class=</span><span
class="s">"com.opensymphony.xwork2.ognl.DefaultOgnlBeanInfoCacheFactory"</span>
<span class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+ <span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"org.apache.struts2.url.UrlEncoder"</span> <span
class="na">name=</span><span class="s">"strutsUrlEncoder"</span>
+ <span class="na">class=</span><span
class="s">"org.apache.struts2.url.StrutsUrlEncoder"</span> <span
class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+ <span class="nt"><bean</span> <span class="na">type=</span><span
class="s">"org.apache.struts2.url.UrlDecoder"</span> <span
class="na">name=</span><span class="s">"strutsUrlDecoder"</span>
+ <span class="na">class=</span><span
class="s">"org.apache.struts2.url.StrutsUrlDecoder"</span> <span
class="na">scope=</span><span class="s">"singleton"</span><span
class="nt">/></span>
+
<span class="nt"><package</span> <span class="na">name=</span><span
class="s">"struts-default"</span> <span class="na">abstract=</span><span
class="s">"true"</span><span class="nt">></span>
<span class="nt"><result-types></span>
<span class="nt"><result-type</span> <span
class="na">name=</span><span class="s">"chain"</span> <span
class="na">class=</span><span
class="s">"com.opensymphony.xwork2.ActionChainResult"</span><span
class="nt">/></span>
diff --git a/content/plugins/async/index.html b/content/plugins/async/index.html
new file mode 100644
index 000000000..afeac70d4
--- /dev/null
+++ b/content/plugins/async/index.html
@@ -0,0 +1,290 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <meta name="Date-Revision-yyyymmdd" content="20140918"/>
+ <meta http-equiv="Content-Language" content="en"/>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+
+ <title>Async Plugin</title>
+
+ <link
href="//fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,400italic,600italic,700italic"
rel="stylesheet" type="text/css">
+ <link
href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css"
rel="stylesheet">
+ <link href="/css/main.css" rel="stylesheet">
+ <link href="/css/custom.css" rel="stylesheet">
+ <link href="/highlighter/github-theme.css" rel="stylesheet">
+
+ <script src="//code.jquery.com/jquery-1.11.0.min.js"></script>
+ <script type="text/javascript" src="/bootstrap/js/bootstrap.js"></script>
+ <script type="text/javascript" src="/js/community.js"></script>
+</head>
+<body>
+
+<a href="http://github.com/apache/struts"; class="github-ribbon">
+ <img style="position: absolute; right: 0; border: 0;"
src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png";
alt="Fork me on GitHub">
+</a>
+
+<header>
+ <nav>
+ <div role="navigation" class="navbar navbar-default navbar-fixed-top">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" data-toggle="collapse"
data-target="#struts-menu" class="navbar-toggle">
+ Menu
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a href="/index.html" class="navbar-brand logo"><img
src="/img/struts-logo.svg"></a>
+ </div>
+ <div id="struts-menu" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li class="dropdown">
+ <a data-toggle="dropdown" href="#" class="dropdown-toggle">
+ Home<b class="caret"></b>
+ </a>
+ <ul class="dropdown-menu">
+ <li><a href="/index.html">Welcome</a></li>
+ <li><a href="/download.cgi">Download</a></li>
+ <li><a href="/releases.html">Releases</a></li>
+ <li><a href="/announce-2022.html">Announcements</a></li>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="https://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+ <li><a
href="https://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+ <li><a
href="https://privacy.apache.org/policies/privacy-policy-public.html";>Privacy
Policy</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a data-toggle="dropdown" href="#" class="dropdown-toggle">
+ Support<b class="caret"></b>
+ </a>
+ <ul class="dropdown-menu">
+ <li><a href="/mail.html">User Mailing List</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/WW";>Issue
Tracker</a></li>
+ <li><a href="/security.html">Reporting Security Issues</a></li>
+ <li class="divider"></li>
+ <li><a
href="https://cwiki.apache.org/confluence/display/WW/Migration+Guide";>Version
Notes</a></li>
+ <li><a
href="https://cwiki.apache.org/confluence/display/WW/Security+Bulletins";>Security
Bulletins</a></li>
+ <li class="divider"></li>
+ <li><a href="/maven/project-info.html">Maven Project
Info</a></li>
+ <li><a href="/maven/struts2-core/dependencies.html">Struts
Core Dependencies</a></li>
+ <li><a href="/maven/struts2-plugins/modules.html">Plugin
Dependencies</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a data-toggle="dropdown" href="#" class="dropdown-toggle">
+ Documentation<b class="caret"></b>
+ </a>
+ <ul class="dropdown-menu">
+ <li><a href="/birdseye.html">Birds Eye</a></li>
+ <li><a href="/primer.html">Key Technologies</a></li>
+ <li><a href="/kickstart.html">Kickstart FAQ</a></li>
+ <li><a
href="https://cwiki.apache.org/confluence/display/WW/Home";>Wiki</a></li>
+ <li class="divider"></li>
+ <li><a href="/getting-started/">Getting Started</a></li>
+ <li><a href="/security/">Security Guide</a></li>
+ <li><a href="/core-developers/">Core Developers Guide</a></li>
+ <li><a href="/tag-developers/">Tag Developers Guide</a></li>
+ <li><a href="/maven-archetypes/">Maven Archetypes</a></li>
+ <li><a href="/plugins/">Plugins</a></li>
+ <li><a href="/maven/struts2-core/apidocs/index.html">Struts
Core API</a></li>
+ <li><a href="/tag-developers/tag-reference.html">Tag
reference</a></li>
+ <li><a
href="https://cwiki.apache.org/confluence/display/WW/FAQs";>FAQs</a></li>
+ <li><a
href="http://cwiki.apache.org/S2PLUGINS/home.html";>Plugin registry</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a data-toggle="dropdown" href="#" class="dropdown-toggle">
+ Contributing<b class="caret"></b>
+ </a>
+ <ul class="dropdown-menu">
+ <li><a href="/youatstruts.html">You at Struts</a></li>
+ <li><a href="/helping.html">How to Help FAQ</a></li>
+ <li><a href="/dev-mail.html">Development Lists</a></li>
+ <li class="divider"></li>
+ <li><a href="/submitting-patches.html">Submitting
patches</a></li>
+ <li><a href="/builds.html">Source Code and Builds</a></li>
+ <li><a href="/coding-standards.html">Coding standards</a></li>
+ <li><a href="/contributors/">Contributors Guide</a></li>
+ <li class="divider"></li>
+ <li><a href="/release-guidelines.html">Release
Guidelines</a></li>
+ <li><a href="/bylaws.html">PMC Charter</a></li>
+ <li><a href="/volunteers.html">Volunteers</a></li>
+ <li><a
href="https://gitbox.apache.org/repos/asf?p=struts.git";>Source
Repository</a></li>
+ <li><a href="/updating-website.html">Updating the
website</a></li>
+ </ul>
+ </li>
+ <li class="apache"><a href="http://www.apache.org/";><img
src="/img/apache.png"></a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </nav>
+</header>
+
+
+<article class="container">
+ <section class="col-md-12">
+ <a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/async/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
+
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
+
+ <h1 class="no_toc" id="async-plugin">Async Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#simple-usage" id="markdown-toc-simple-usage">Simple
usage</a></li>
+ <li><a href="#customize-timeout"
id="markdown-toc-customize-timeout">Customize timeout</a></li>
+ <li><a href="#serializing-multiple-async-tasks"
id="markdown-toc-serializing-multiple-async-tasks">Serializing multiple async
tasks</a></li>
+</ul>
+
+<h2 id="description">Description</h2>
+
+<p>The Async plugin allows to implement actions as using
+an <a
href="https://docs.oracle.com/javaee/7/tutorial/servlets012.htm";>Asynchronous
Processing</a>
+available as from Servlet API 3. It’s a thin layer over the Servlet async
layer.</p>
+
+<h2 id="simple-usage">Simple usage</h2>
+
+<p>The example code below shows how to implement and use async actions. Please
check an async action example
+in our <a
href="https://github.com/apache/struts/tree/master/apps/showcase/src/main/java/org/apache/struts2/showcase/async";>Showcase
app</a>.</p>
+
+<p><strong>Action</strong></p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kd">class</span> <span class="nc">AsyncAction</span> <span
class="o">{</span>
+
+ <span class="kd">public</span> <span class="nc">Callable</span><span
class="o"><</span><span class="nc">String</span><span class="o">></span>
<span class="nf">execute</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="k">return</span> <span class="k">new</span> <span
class="nc">Callable</span><span class="o"><</span><span
class="nc">String</span><span class="o">>()</span> <span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="nc">String</span>
<span class="nf">call</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">Exception</span> <span
class="o">{</span>
+ <span class="n">waitForEvent</span><span class="o">();</span>
+ <span class="k">return</span> <span
class="s">"success"</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">};</span>
+ <span class="o">}</span>
+
+ <span class="kd">private</span> <span class="kt">void</span> <span
class="nf">waitForEvent</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="nc">Thread</span><span class="o">.</span><span
class="na">sleep</span><span class="o">(</span><span
class="mi">40000</span><span class="o">);</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre></div></div>
+
+<p><strong>struts.xml</strong></p>
+
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><action</span> <span
class="na">name=</span><span class="s">"async"</span> <span
class="na">class=</span><span
class="s">"com.company.struts.AsyncAction"</span><span class="nt">></span>
+ <span class="nt"><result</span> <span class="na">name=</span><span
class="s">"success"</span> <span class="na">type=</span><span
class="s">"json"</span><span class="nt">/></span>
+<span class="nt"></action></span>
+</code></pre></div></div>
+
+<p><strong>web.xml</strong></p>
+
+<p>You must define the Struts Servlet to allow support Async actions.</p>
+
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><servlet></span>
+ <span class="nt"><servlet-name></span>strutsServlet<span
class="nt"></servlet-name></span>
+ <span
class="nt"><servlet-class></span>org.apache.struts2.dispatcher.servlet.StrutsServlet<span
class="nt"></servlet-class></span>
+ <span class="nt"><load-on-startup></span>1<span
class="nt"></load-on-startup></span>
+ <span class="nt"><async-supported></span>true<span
class="nt"></async-supported></span>
+<span class="nt"></servlet></span>
+
+<span class="nt"><servlet-mapping></span>
+<span class="nt"><servlet-name></span>strutsServlet<span
class="nt"></servlet-name></span>
+<span class="nt"><url-pattern></span>/<span
class="nt"></url-pattern></span>
+<span class="nt"></servlet-mapping></span>
+</code></pre></div></div>
+
+<h2 id="customize-timeout">Customize timeout</h2>
+
+<p><strong>Action</strong></p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kd">class</span> <span class="nc">AsyncAction</span> <span
class="o">{</span>
+
+ <span class="kd">public</span> <span class="nc">Callable</span><span
class="o"><</span><span class="nc">String</span><span class="o">></span>
<span class="nf">execute</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="k">return</span> <span class="k">new</span> <span
class="nf">AsyncAction</span><span class="o">(</span><span
class="mi">60000</span><span class="cm">/*timeout*/</span><span
class="o">,</span> <span class="k">new</span> <span
class="nc">Callable</span><span class="o"><</span><span
class="nc">String</span><span class="o">>()</span> <span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="nc">String</span>
<span class="nf">call</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">Exception</span> <span
class="o">{</span>
+ <span class="n">waitForEvent</span><span class="o">();</span>
+ <span class="k">return</span> <span
class="s">"success"</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">});</span>
+ <span class="o">}</span>
+
+ <span class="kd">private</span> <span class="kt">void</span> <span
class="nf">waitForEvent</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="nc">Thread</span><span class="o">.</span><span
class="na">sleep</span><span class="o">(</span><span
class="mi">40000</span><span class="o">);</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre></div></div>
+
+<h2 id="serializing-multiple-async-tasks">Serializing multiple async tasks</h2>
+
+<p><strong>Action</strong></p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kd">class</span> <span class="nc">AsyncAction</span> <span
class="o">{</span>
+
+ <span class="kd">public</span> <span class="nc">Callable</span><span
class="o"><</span><span class="nc">String</span><span class="o">></span>
<span class="nf">execute</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="k">return</span> <span class="k">new</span> <span
class="nc">Callable</span><span class="o"><</span><span
class="nc">String</span><span class="o">>()</span> <span class="o">{</span>
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span class="nc">String</span>
<span class="nf">call</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">Exception</span> <span
class="o">{</span>
+ <span class="n">waitForEvent1</span><span class="o">();</span>
+ <span class="k">return</span> <span class="k">new</span> <span
class="nc">Callable</span><span class="o"><</span><span
class="nc">String</span><span class="o">>()</span> <span class="o">{</span>
+
+ <span class="nd">@Override</span>
+ <span class="kd">public</span> <span
class="nc">String</span> <span class="nf">call</span><span class="o">()</span>
<span class="kd">throws</span> <span class="nc">Exception</span> <span
class="o">{</span>
+ <span class="n">waitForEvent2</span><span
class="o">();</span>
+ <span class="k">return</span> <span
class="s">"success"</span><span class="o">;</span>
+ <span class="o">}</span>
+ <span class="o">};</span>
+ <span class="o">}</span>
+ <span class="o">};</span>
+ <span class="o">}</span>
+
+ <span class="kd">private</span> <span class="kt">void</span> <span
class="nf">waitForEvent1</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="nc">Thread</span><span class="o">.</span><span
class="na">sleep</span><span class="o">(</span><span
class="mi">40000</span><span class="o">);</span>
+ <span class="o">}</span>
+
+ <span class="kd">private</span> <span class="kt">void</span> <span
class="nf">waitForEvent2</span><span class="o">()</span> <span
class="kd">throws</span> <span class="nc">InterruptedException</span> <span
class="o">{</span>
+ <span class="nc">Thread</span><span class="o">.</span><span
class="na">sleep</span><span class="o">(</span><span
class="mi">40000</span><span class="o">);</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre></div></div>
+
+ </section>
+</article>
+
+
+<footer class="container">
+ <div class="col-md-12">
+ Copyright © 2000-2022 <a href="https://www.apache.org/";>The Apache
Software Foundation</a>.
+ Apache Struts, Struts, Apache, the Apache feather logo, and the Apache
Struts project logos are
+ trademarks of The Apache Software Foundation. All Rights Reserved.
+ </div>
+ <div class="col-md-12">Logo and website design donated by <a
href="https://softwaremill.com/";>SoftwareMill</a>.</div>
+</footer>
+
+<script>!function (d, s, id) {
+ var js, fjs = d.getElementsByTagName(s)[0];
+ if (!d.getElementById(id)) {
+ js = d.createElement(s);
+ js.id = id;
+ js.src = "//platform.twitter.com/widgets.js";
+ fjs.parentNode.insertBefore(js, fjs);
+ }
+}(document, "script", "twitter-wjs");</script>
+<script src="https://apis.google.com/js/platform.js"; async="async"
defer="defer"></script>
+
+<div id="fb-root"></div>
+
+<script>(function (d, s, id) {
+ var js, fjs = d.getElementsByTagName(s)[0];
+ if (d.getElementById(id)) return;
+ js = d.createElement(s);
+ js.id = id;
+ js.src = "//connect.facebook.net/en_GB/all.js#xfbml=1";
+ fjs.parentNode.insertBefore(js, fjs);
+}(document, 'script', 'facebook-jssdk'));</script>
+
+
+</body>
+</html>
diff --git a/content/plugins/bean-validation/index.html
b/content/plugins/bean-validation/index.html
index a65c6b008..28e1749ff 100644
--- a/content/plugins/bean-validation/index.html
+++ b/content/plugins/bean-validation/index.html
@@ -129,32 +129,34 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/bean-validation/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="bean-validation-plugin">Bean Validation Plugin</h1>
+ <h1 class="no_toc" id="bean-validation-plugin">Bean Validation Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#bean-validation" id="markdown-toc-bean-validation">Bean
Validation</a></li>
+ <li><a href="#setup" id="markdown-toc-setup">Setup</a></li>
+ <li><a href="#configuration"
id="markdown-toc-configuration">Configuration</a></li>
+ <li><a href="#bean-validation-example"
id="markdown-toc-bean-validation-example">Bean Validation Example</a></li>
+</ul>
<h2 id="bean-validation">Bean Validation</h2>
-<p>The Bean Validation plugin implements a bridge to use Bean Validation in
struts actions. Bean Validation has been specified in JSR 303 and is part of
the JavaEE platform. Full-fledged application servers already bring validation
providers which can be leveraged by this plugin. The plugin integrates with
other struts features like:</p>
+<p>The Bean Validation plugin implements a bridge to use Bean Validation in
struts actions. Bean Validation has been
+specified in JSR 303 and is part of the JavaEE platform. Full-fledged
application servers already bring validation
+providers which can be leveraged by this plugin. The plugin integrates with
other struts features like:</p>
<ul>
- <li>
- <p>i18n</p>
- </li>
- <li>
- <p>model driven</p>
- </li>
- <li>
- <p>AJAX Validation</p>
- </li>
- <li>
- <p>workflow</p>
- </li>
+ <li>i18n</li>
+ <li>model driven</li>
+ <li>AJAX Validation</li>
+ <li>workflow</li>
</ul>
<h2 id="setup">Setup</h2>
-<p>In order to use the Bean Validation plugin, you first need to add the JAR
file to the <code class="language-plaintext
highlighter-rouge">WEB-INF/lib</code> directory of your application or include
the dependency in your project’s Maven POM file.</p>
+<p>In order to use the Bean Validation plugin, you first need to add the JAR
file to the <code class="language-plaintext
highlighter-rouge">WEB-INF/lib</code> directory of your
+application or include the dependency in your project’s Maven POM file.</p>
<p><strong>pom.xml</strong></p>
@@ -165,11 +167,13 @@
<span class="nt"></dependency></span>
</code></pre></div></div>
-<p>Where X.X.X is the current version of Struts 2. Please remember that the
Bean Validation Plugin is available from version 2.5.</p>
+<p>Where X.X.X is the current version of Struts 2. Please remember that the
Bean Validation Plugin is available from
+version 2.5.</p>
<h2 id="configuration">Configuration</h2>
-<p>This sample shows the configuration constants the plugin provides. It also
shows how to enable bean-validation by extending your own application package
from <code class="language-plaintext
highlighter-rouge">struts-bean-validation</code> which comes along with the
plugin.</p>
+<p>This sample shows the configuration constants the plugin provides. It also
shows how to enable bean-validation
+by extending your own application package from <code class="language-plaintext
highlighter-rouge">struts-bean-validation</code> which comes along with the
plugin.</p>
<p><strong>struts.xml</strong></p>
@@ -178,41 +182,44 @@
<span class="nt"><constant</span> <span class="na">name=</span><span
class="s">"struts.beanValidation.ignoreXMLConfiguration"</span> <span
class="na">value=</span><span class="s">"false"</span><span
class="nt">/></span>
<span class="nt"><constant</span> <span class="na">name=</span><span
class="s">"struts.beanValidation.convertMessageToUtf"</span> <span
class="na">value=</span><span class="s">"false"</span><span
class="nt">/></span>
<span class="nt"><constant</span> <span class="na">name=</span><span
class="s">"struts.beanValidation.convertMessageFromEncoding"</span> <span
class="na">value=</span><span class="s">"ISO-8859-1"</span><span
class="nt">/></span>
-
+
<span class="nt"><package</span> <span class="na">name=</span><span
class="s">"my-bean-validation"</span> <span class="na">extends=</span><span
class="s">"struts-bean-validation"</span><span class="nt">></span>
<span class="nt"></package></span>
<span class="nt"></struts></span>
</code></pre></div></div>
-<p>Here is another example that shows how you can combine bean-validation with
other plugins by configuring your own Interceptor-Stack (note: this is just a
very short example. In a real app you should take more care about your stack).
You can combine bean validation with classic struts validation (or disable
either) by putting the according interceptors in your stack (or by removing
them from your stack).</p>
+<p>Here is another example that shows how you can combine bean-validation with
other plugins by configuring your own
+Interceptor-Stack (note: this is just a very short example. In a real app you
should take more care about your stack).
+You can combine bean validation with classic struts validation (or disable
either) by putting the according interceptors
+in your stack (or by removing them from your stack).</p>
<p><strong>struts.xml</strong></p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><package</span> <span
class="na">name=</span><span class="s">"my-app-package"</span> <span
class="na">extends=</span><span class="s">"struts-default"</span><span
class="nt">></span>
- <span class="nt"><interceptors></span>
- <span class="nt"><interceptor></span>
- name="beanValidation"
-
class="org.apache.struts.beanvalidation.validation.interceptor.BeanValidationInterceptor">
- <span class="nt"></interceptor></span>
- <span class="nt"><interceptor-stack</span> <span
class="na">name=</span><span class="s">"appDefaultStack"</span><span
class="nt">></span>
- <span class="nt"><interceptor-ref</span>
<span class="na">name=</span><span class="s">"beanValidation"</span><span
class="nt">/></span>
- <span class="nt"><interceptor-ref</span>
<span class="na">name=</span><span class="s">"defaultStack"</span><span
class="nt">/></span>
- <span class="nt"></interceptor-stack></span>
- <span class="nt"></interceptors></span>
- <span class="nt"></package></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><package</span> <span
class="na">name=</span><span class="s">"my-app-package"</span> <span
class="na">extends=</span><span class="s">"struts-default"</span><span
class="nt">></span>
+ <span class="nt"><interceptors></span>
+ <span class="nt"><interceptor></span>
+ name="beanValidation"
+
class="org.apache.struts.beanvalidation.validation.interceptor.BeanValidationInterceptor">
+ <span class="nt"></interceptor></span>
+ <span class="nt"><interceptor-stack</span> <span
class="na">name=</span><span class="s">"appDefaultStack"</span><span
class="nt">></span>
+ <span class="nt"><interceptor-ref</span> <span
class="na">name=</span><span class="s">"beanValidation"</span><span
class="nt">/></span>
+ <span class="nt"><interceptor-ref</span> <span
class="na">name=</span><span class="s">"defaultStack"</span><span
class="nt">/></span>
+ <span class="nt"></interceptor-stack></span>
+ <span class="nt"></interceptors></span>
+<span class="nt"></package></span>
</code></pre></div></div>
-<p> </p>
-
<h2 id="bean-validation-example">Bean Validation Example</h2>
-<p>Here is an example Action that makes use of bean validation. Note that some
of the validation annotations are taken from <code class="language-plaintext
highlighter-rouge">javax</code> package (which is defined in the JSR) while
others are taken from the validaton provider (in this case: <code
class="language-plaintext highlighter-rouge">hibernate</code>). You can
specifiy own text keys in the <code class="language-plaintext
highlighter-rouge">message</code> attribute of the annotatio [...]
+<p>Here is an example Action that makes use of bean validation. Note that some
of the validation annotations are taken
+from <code class="language-plaintext highlighter-rouge">javax</code> package
(which is defined in the JSR) while others are taken from the validaton
provider (in this
+case: <code class="language-plaintext highlighter-rouge">hibernate</code>).
You can specifiy own text keys in the <code class="language-plaintext
highlighter-rouge">message</code> attribute of the annotations. If you do that
the
+whole struts i18n mechanism kicks in to resolve those text keys.</p>
<p><strong>com.example.actions.BeanValidationAction</strong></p>
<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kn">package</span> <span
class="nn">com.example.actions</span><span class="o">;</span>
-
<span class="kn">import</span> <span
class="nn">com.opensymphony.xwork2.ActionSupport</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">org.apache.struts.beanvalidation.constraints.FieldMatch</span><span
class="o">;</span>
<span class="kn">import</span> <span
class="nn">org.apache.struts2.convention.annotation.Action</span><span
class="o">;</span>
@@ -224,6 +231,7 @@
<span class="kn">import</span> <span
class="nn">org.hibernate.validator.constraints.NotBlank</span><span
class="o">;</span>
<span class="kn">import</span> <span
class="nn">org.hibernate.validator.constraints.ScriptAssert</span><span
class="o">;</span>
<span class="kn">import</span> <span
class="nn">org.hibernate.validator.constraints.URL</span><span
class="o">;</span>
+
<span class="kn">import</span> <span
class="nn">javax.validation.constraints.*</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">java.util.Date</span><span
class="o">;</span>
@@ -243,7 +251,7 @@
<span class="nd">@NotBlank</span>
<span class="kd">private</span> <span class="nc">String</span> <span
class="n">requiredStringValidatorField</span> <span class="o">=</span> <span
class="kc">null</span><span class="o">;</span>
- <span class="nd">@NotNull</span><span class="o">(</span><span
class="n">message</span><span class="o">=</span><span
class="s">"your.text.key.here"</span><span class="o">)</span>
+ <span class="nd">@NotNull</span><span class="o">(</span><span
class="n">message</span> <span class="o">=</span> <span
class="s">"your.text.key.here"</span><span class="o">)</span>
<span class="nd">@Min</span><span class="o">(</span><span
class="mi">1</span><span class="o">)</span>
<span class="nd">@Max</span><span class="o">(</span><span
class="mi">10</span><span class="o">)</span>
<span class="kd">private</span> <span class="nc">Integer</span> <span
class="n">integerValidatorField</span> <span class="o">=</span> <span
class="kc">null</span><span class="o">;</span>
@@ -272,59 +280,76 @@
<span class="kd">private</span> <span class="nc">String</span> <span
class="n">fieldExpressionValidatorField</span> <span class="o">=</span> <span
class="kc">null</span><span class="o">;</span>
- <span class="kd">public</span> <span class="nc">Date</span> <span
class="nf">getDateValidatorField</span><span class="o">()</span> <span
class="o">{</span>
+ <span class="kd">public</span> <span class="nc">Date</span> <span
class="nf">getDateValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">dateValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setDateValidatorField</span><span class="o">(</span><span
class="nc">Date</span> <span class="n">dateValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">dateValidatorField</span> <span class="o">=</span> <span
class="n">dateValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getEmailValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">emailValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setEmailValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span class="n">emailValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">emailValidatorField</span> <span class="o">=</span> <span
class="n">emailValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">Integer</span> <span
class="nf">getIntegerValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">integerValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setIntegerValidatorField</span><span class="o">(</span><span
class="nc">Integer</span> <span class="n">integerValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">integerValidatorField</span> <span class="o">=</span> <span
class="n">integerValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getRegexValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">regexValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setRegexValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span class="n">regexValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">regexValidatorField</span> <span class="o">=</span> <span
class="n">regexValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getRequiredStringValidatorField</span><span class="o">()</span>
<span class="o">{</span>
<span class="k">return</span> <span
class="n">requiredStringValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setRequiredStringValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span
class="n">requiredStringValidatorField</span><span class="o">)</span> <span
class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">requiredStringValidatorField</span> <span class="o">=</span> <span
class="n">requiredStringValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getRequiredValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">requiredValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setRequiredValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span class="n">requiredValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">requiredValidatorField</span> <span class="o">=</span> <span
class="n">requiredValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getStringLengthValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">stringLengthValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setStringLengthValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span class="n">stringLengthValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">stringLengthValidatorField</span> <span class="o">=</span> <span
class="n">stringLengthValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getFieldExpressionValidatorField</span><span class="o">()</span>
<span class="o">{</span>
<span class="k">return</span> <span
class="n">fieldExpressionValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setFieldExpressionValidatorField</span><span class="o">(</span>
<span class="nc">String</span> <span
class="n">fieldExpressionValidatorField</span><span class="o">)</span> <span
class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">fieldExpressionValidatorField</span> <span class="o">=</span> <span
class="n">fieldExpressionValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="nc">String</span> <span
class="nf">getUrlValidatorField</span><span class="o">()</span> <span
class="o">{</span>
<span class="k">return</span> <span
class="n">urlValidatorField</span><span class="o">;</span>
<span class="o">}</span>
+
<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">setUrlValidatorField</span><span class="o">(</span><span
class="nc">String</span> <span class="n">urlValidatorField</span><span
class="o">)</span> <span class="o">{</span>
<span class="k">this</span><span class="o">.</span><span
class="na">urlValidatorField</span> <span class="o">=</span> <span
class="n">urlValidatorField</span><span class="o">;</span>
<span class="o">}</span>
diff --git a/content/plugins/cdi/index.html b/content/plugins/cdi/index.html
index dc7000289..93d243466 100644
--- a/content/plugins/cdi/index.html
+++ b/content/plugins/cdi/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/cdi/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="cdi-plugin">CDI Plugin</h1>
@@ -364,8 +364,7 @@ to undefined - so check your imports!</p>
<p>Now that you are aware of that, here is the rest of the inevitable
NumberGuess CDI example in Struts 2 flavour.
Add a JSP view similar to this:</p>
-<div class="language-jsp highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="nt"><%@ page </span><span class="na">contentType=</span><span
class="s">"text/html; charset=UTF-8"</span> <span class="nt">%></span>
+<div class="language-jsp highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><%@ page </span><span
class="na">contentType=</span><span class="s">"text/html; charset=UTF-8"</span>
<span class="nt">%></span>
<span class="nt"><%@ taglib </span><span class="na">prefix=</span><span
class="s">"s"</span><span class="na"> uri=</span><span
class="s">"/struts-tags"</span> <span class="nt">%></span>
<span class="nt"><html></span>
<span class="nt"><head></span>
@@ -392,8 +391,7 @@ Add a JSP view similar to this:</p>
<p>along - if not using the fabulous and recommended Struts 2 <a
href="../convention">Convention Plugin</a> - with a struts.xml like this</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="cp"><?xml version="1.0"
encoding="UTF-8"?></span>
<span class="cp"><!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
"http://struts.apache.org/dtds/struts-2.3.dtd"></span>
@@ -414,13 +412,11 @@ Add a JSP view similar to this:</p>
<span class="nt"></package></span>
<span class="nt"></struts></span>
-
</code></pre></div></div>
<p>Now you can add the business logic we want to be managed and injected by
CDI. Start with two qualifier annotations:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">javax.inject.Qualifier</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">java.lang.annotation.Documented</span><span class="o">;</span>
@@ -434,11 +430,9 @@ Add a JSP view similar to this:</p>
<span class="nd">@Documented</span>
<span class="nd">@Qualifier</span>
<span class="kd">public</span> <span class="nd">@interface</span> <span
class="nc">Random</span> <span class="o">{}</span>
-
</code></pre></div></div>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">javax.inject.Qualifier</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">java.lang.annotation.Documented</span><span class="o">;</span>
@@ -452,13 +446,11 @@ Add a JSP view similar to this:</p>
<span class="nd">@Documented</span>
<span class="nd">@Qualifier</span>
<span class="kd">public</span> <span class="nd">@interface</span> <span
class="nc">MaxNumber</span> <span class="o">{}</span>
-
</code></pre></div></div>
<p>Now on to the actual business beans, the Game and the Generator bean:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kn">package</span> <span
class="nn">org.apache.struts2.example.cdi</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">javax.annotation.PostConstruct</span><span class="o">;</span>
<span class="kn">import</span> <span
class="nn">javax.enterprise.context.SessionScoped</span><span class="o">;</span>
@@ -540,7 +532,6 @@ Add a JSP view similar to this:</p>
<span class="o">}</span>
<span class="o">}</span>
-
</code></pre></div></div>
<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
@@ -569,10 +560,8 @@ Add a JSP view similar to this:</p>
<span class="k">return</span> <span class="n">maxNumber</span><span
class="o">;</span>
<span class="o">}</span>
-<span class="o">}</span>
-
+<span class="o">}</span>
</code></pre></div></div>
-
<p>If you understand that code at a glance, you are either already an CDI
expert or profit from the readable, natural
language oriented way the CDI stack works. If neither of this is the case, now
it’s time to check the CDI and Weld
documentation. Remember, this is a trivial example - there is much more to
know about CDI.</p>
diff --git a/content/plugins/codebehind/index.html
b/content/plugins/codebehind/index.html
index d145e42e1..df7dcb0f8 100644
--- a/content/plugins/codebehind/index.html
+++ b/content/plugins/codebehind/index.html
@@ -131,7 +131,18 @@
<a href="../" title="back to Plugins"><< back to Plugins</a>
- <h1 id="codebehind-plugin">Codebehind Plugin</h1>
+ <h1 class="no_toc" id="codebehind-plugin">Codebehind Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#default-mappings"
id="markdown-toc-default-mappings">Default Mappings</a></li>
+ <li><a href="#default-results" id="markdown-toc-default-results">Default
Results</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ </ul>
+ </li>
+</ul>
<blockquote>
<p>Deprecated Plugin</p>
diff --git a/content/plugins/config-browser/index.html
b/content/plugins/config-browser/index.html
index 3d52113e9..0e2b37cbe 100644
--- a/content/plugins/config-browser/index.html
+++ b/content/plugins/config-browser/index.html
@@ -129,9 +129,20 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/config-browser/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="config-browser-plugin">Config Browser Plugin</h1>
+ <h1 class="no_toc" id="config-browser-plugin">Config Browser Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
+
+<h2 id="description">Description</h2>
<p>The Config Browser Plugin is a simple tool to help view an application’s
configuration at runtime.</p>
@@ -140,31 +151,28 @@
<h2 id="features">Features</h2>
<ul>
- <li>
- <p>Browsable view of loaded configuration</p>
- </li>
- <li>
- <p>Shows all accessible action URLs</p>
- </li>
+ <li>Browsable view of loaded configuration</li>
+ <li>Shows all accessible action URLs</li>
</ul>
<h2 id="usage">Usage</h2>
-<p>To use the plugin, simply copy the jar into your application. Once
installed, you can access the tool by opening to the action named
<em>index</em> in the <em>config-browser</em> namespace.</p>
+<p>To use the plugin, simply copy the jar into your application. Once
installed, you can access the tool by opening
+to the action named <em>index</em> in the <em>config-browser</em>
namespace.</p>
<blockquote>
<p>In most cases (if you are using the default <em>ActionMapper</em> ), the
URL is something like http://localhost:8080/starter/config-browser/index.action
or http://localhost:8080/starter/config-browser/index.</p>
</blockquote>
-<h3 id="example">Example</h3>
+<h2 id="example">Example</h2>
<p><img src="../attachments/att30966155_config-browser-example.png"
alt="config-browser-example.png" /></p>
-<h3 id="settings">Settings</h3>
+<h2 id="settings">Settings</h2>
<p>This plugin provides no customizable settings.</p>
-<h3 id="installation">Installation</h3>
+<h2 id="installation">Installation</h2>
<p>This plugin can be installed by copying the plugin jar into your
application’s <code class="language-plaintext
highlighter-rouge">/WEB-INF/lib</code> directory. No other files need to be
copied or created.</p>
diff --git a/content/plugins/convention/index.html
b/content/plugins/convention/index.html
index 2580bf0a2..5a16d8e86 100644
--- a/content/plugins/convention/index.html
+++ b/content/plugins/convention/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/convention/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="convention-plugin">Convention Plugin</h1>
diff --git a/content/plugins/dwr/index.html b/content/plugins/dwr/index.html
index 4c0fbc8c3..b4eddbd12 100644
--- a/content/plugins/dwr/index.html
+++ b/content/plugins/dwr/index.html
@@ -129,15 +129,23 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/dwr/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="dwr-plugin">DWR Plugin</h1>
-
-<p>The DWR plugin provides integration with the Ajax framework <a
href="http://getahead.org/dwr";>Direct Web Remoting</a></p>
+ <h1 class="no_toc" id="dwr-plugin">DWR Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
-<p>This plugin works by allowing DWR to execute a Struts 2 action and return
any validation errors.</p>
+<h2 id="description">Description</h2>
-<p>This plugin is only available with Struts 2.1.1 or later.</p>
+<p>The DWR plugin provides integration with the Ajax framework <a
href="http://getahead.org/dwr";>Direct Web Remoting</a>
+This plugin works by allowing DWR to execute a Struts 2 action and return any
validation errors.
+This plugin is only available with Struts 2.1.1 or later.</p>
<h2 id="features">Features</h2>
@@ -149,8 +157,7 @@
<p>To expose Struts 2 validations via DWR, add this to your DWR
configuration:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
- <span class="nt"><dwr></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><dwr></span>
<span class="nt"><allow></span>
<span class="nt"><create</span> <span class="na">creator=</span><span
class="s">"new"</span> <span class="na">javascript=</span><span
class="s">"validator"</span> <span class="na">class=</span><span
class="s">"org.apache.struts2.validators.DWRValidator"</span><span
class="nt">/></span>
<span class="nt"><convert</span> <span
class="na">converter=</span><span class="s">"bean"</span> <span
class="na">match=</span><span
class="s">"com.opensymphony.xwork2.ValidationAwareSupport"</span><span
class="nt">/></span>
diff --git a/content/plugins/embedded-jsp/index.html
b/content/plugins/embedded-jsp/index.html
index 356f6dd24..4fc2b7a4d 100644
--- a/content/plugins/embedded-jsp/index.html
+++ b/content/plugins/embedded-jsp/index.html
@@ -129,9 +129,22 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/embedded-jsp/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="embedded-jsp-plugin">Embedded JSP Plugin</h1>
+ <h1 class="no_toc" id="embedded-jsp-plugin">Embedded JSP Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#introduction" id="markdown-toc-introduction">Introduction</a>
<ul>
+ <li><a href="#waitwhat" id="markdown-toc-waitwhat">Wait…what?</a></li>
+ <li><a href="#about-includes" id="markdown-toc-about-includes">About
includes</a></li>
+ </ul>
+ </li>
+ <li><a href="#requirements" id="markdown-toc-requirements">Requirements</a>
<ul>
+ <li><a href="#tomcat" id="markdown-toc-tomcat">Tomcat</a></li>
+ <li><a href="#jetty" id="markdown-toc-jetty">Jetty</a></li>
+ </ul>
+ </li>
+</ul>
<p>The Embedded JSP plugin allows you to use JSPs from the classpath (from jar
files).</p>
diff --git a/content/plugins/index.html b/content/plugins/index.html
index 1c5b6723d..3d4a0fc46 100644
--- a/content/plugins/index.html
+++ b/content/plugins/index.html
@@ -151,6 +151,11 @@ to share with others. Several plugins are bundled with the
framework, and others
</tr>
</thead>
<tbody>
+ <tr>
+ <td><a href="async">Async Plugin</a></td>
+ <td>6.0.0+</td>
+ <td> </td>
+ </tr>
<tr>
<td><a href="bean-validation">Bean Validation Plugin</a></td>
<td>2.5+</td>
diff --git a/content/plugins/jasperreports/index.html
b/content/plugins/jasperreports/index.html
index 86d0dd449..03f63dfff 100644
--- a/content/plugins/jasperreports/index.html
+++ b/content/plugins/jasperreports/index.html
@@ -129,94 +129,78 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/jasperreports/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="jasperreports-plugin">JasperReports Plugin</h1>
+ <h1 class="no_toc" id="jasperreports-plugin">JasperReports Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#examples" id="markdown-toc-examples">Examples</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ </ul>
+ </li>
+</ul>
-<p><a
href="http://jasperforge.org/sf/projects/jasperreports";>JasperReports</a> is a
powerful open source Java (LGPL) reporting tool that has the ability to deliver
rich content onto the screen, to the printer or into PDF, HTML, XLS, CSV and
XML files.</p>
+<h2 id="description">Description</h2>
+<p><a
href="http://jasperforge.org/sf/projects/jasperreports";>JasperReports</a> is a
powerful open source Java (LGPL) reporting
+tool that has the ability to deliver rich content onto the screen, to the
printer or into PDF, HTML, XLS, CSV and XML files.</p>
<p>The JasperReports plugin enables Actions to create high-quality reports as
results.</p>
<h2 id="features">Features</h2>
<ul>
- <li>Allows Actions to be rendered through JasperReports</li>
+ <li>Allows actions to be rendered through JasperReports</li>
</ul>
<h2 id="usage">Usage</h2>
-<p>To use this plugin, have your packages that contain the target actions
extend the provided <code class="language-plaintext
highlighter-rouge">jasperreports-default</code> package, which contains the
<code class="language-plaintext highlighter-rouge">jasper</code> result type.
Then, simply use the result type in the desired actions. The result takes the
following parameters:</p>
-
-<p> <p>
- Generates a JasperReports report using the specified format or PDF if no
- format is specified.
- </p>
-</p>
-
-<p>
- <ul>
-
- <li><b>location (default)</b> - the location where the compiled jasper report
- definition is (foo.jasper), relative from current URL.</li>
- <li><b>dataSource (required)</b> - the EL expression used to retrieve the
- datasource from the value stack (usually a List).</li>
- <li><b>parse</b> - true by default. If set to false, the location param will
- not be parsed for EL expressions.</li>
- <li><b>format</b> - the format in which the report should be generated. Valid
- values can be found in {@link JasperReportConstants}. If no format is
- specified, PDF will be used.</li>
- <li><b>contentDisposition</b> - disposition (defaults to "inline", values are
- typically <i>filename="document.pdf"</i>).</li>
- <li><b>documentName</b> - name of the document (will generate the http header
- <code>Content-disposition = X; filename=X.[format]</code>).</li>
- <li><b>delimiter</b> - the delimiter used when generating CSV reports. By
- default, the character used is ",".</li>
- <li><b>imageServletUrl</b> - name of the url that, when prefixed with the
- context page, can return report images.</li>
- <li>
- <b>reportParameters</b> - (2.1.2+) OGNL expression used to retrieve a map of
- report parameters from the value stack. The parameters may be accessed
- in the report via the usual JR mechanism and might include data not
- part of the dataSource, such as the user name of the report creator, etc.
- </li>
- <li>
- <b>exportParameters</b> - (2.1.2+) OGNL expression used to retrieve a map of
- JR exporter parameters from the value stack. The export parameters are
- used to customize the JR export. For example, a PDF export might enable
- encryption and set the user password to a string known to the report creator.
- </li>
- <li>
- <b>connection</b> - (2.1.7+) JDBC Connection which can be passed to the
- report instead of dataSource
- </li>
- <li><b>wrapField</b> - (2.3.18+) defines if fields should warp with
ValueStackDataSource
- see https://issues.apache.org/jira/browse/WW-3698 for more details
- </li>
- </ul>
- <p>
- This result follows the same rules from {@link StrutsResultSupport}.
- Specifically, all parameters will be parsed if the "parse" parameter
- is not set to false.
- </p>
-</p>
+<p>To use this plugin, have your packages that contain the target actions
extend the provided <code class="language-plaintext
highlighter-rouge">jasperreports-default</code>
+package, which contains the <code class="language-plaintext
highlighter-rouge">jasper</code> result type. Then, simply use the result type
in the desired actions.<br />
+The result takes the following parameters:</p>
-<h3 id="examples">Examples</h3>
+<ul>
+ <li>location (default) - the location where the compiled jasper report
definition is (foo.jasper), relative from current URL</li>
+ <li>dataSource (required) - the EL expression used to retrieve the
datasource from the value stack (usually a List)</li>
+ <li>parse - <code class="language-plaintext highlighter-rouge">true</code>
by default, if set to false, the location param will not be parsed for EL
expressions</li>
+ <li>format - the format in which the report should be generated. Valid
values can be found in <code class="language-plaintext
highlighter-rouge">JasperReportConstants</code>.
+If no format is specified, PDF will be used</li>
+ <li>contentDisposition - disposition (defaults to “inline”, values are
typically <code class="language-plaintext
highlighter-rouge">filename="document.pdf"</code>)</li>
+ <li>documentName - name of the document (will generate the http header <code
class="language-plaintext highlighter-rouge">Content-disposition = X;
filename=X.[format]</code>)</li>
+ <li>delimiter - the delimiter used when generating CSV reports. By default,
the character used is “,”</li>
+ <li>imageServletUrl - name of the url that, when prefixed with the context
page, can return report images</li>
+ <li>reportParameters - (since 2.1.2+) OGNL expression used to retrieve a map
of report parameters from the value stack.
+The parameters may be accessed in the report via the usual JR mechanism and
might include data not part of the
+dataSource, such as the user name of the report creator, etc.</li>
+ <li>exportParameters - (since 2.1.2+) OGNL expression used to retrieve a map
of JR exporter parameters from the value stack.
+The export parameters are used to customize the JR export. For example, a PDF
export might enable encryption
+and set the user password to a string known to the report creator.</li>
+ <li>connection - (since 2.1.7+) JDBC Connection which can be passed to the
report instead of dataSource</li>
+ <li>wrapField - (since 2.3.18+) defines if fields should warp with
ValueStackDataSource see
+<a href="https://issues.apache.org/jira/browse/WW-3698";>WW-3698</a> for more
details</li>
+</ul>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><result</span> <span
class="na">name=</span><span class="s">"success"</span> <span
class="na">type=</span><span class="s">"jasper"</span><span
class="nt">></span>
- <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"location"</span><span class="nt">></span>foo.jasper<span
class="nt"></param></span>
- <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"dataSource"</span><span class="nt">></span>mySource<span
class="nt"></param></span>
- <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"format"</span><span class="nt">></span>CSV<span
class="nt"></param></span>
- <span class="nt"></result></span>
+<p>This result follows the same rules from {@link StrutsResultSupport}.
Specifically, all parameters will be parsed
+if the “parse” parameter is not set to false.</p>
+<h3 id="examples">Examples</h3>
+
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><result</span> <span
class="na">name=</span><span class="s">"success"</span> <span
class="na">type=</span><span class="s">"jasper"</span><span
class="nt">></span>
+ <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"location"</span><span class="nt">></span>foo.jasper<span
class="nt"></param></span>
+ <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"dataSource"</span><span class="nt">></span>mySource<span
class="nt"></param></span>
+ <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"format"</span><span class="nt">></span>CSV<span
class="nt"></param></span>
+<span class="nt"></result></span>
</code></pre></div></div>
<p>or for pdf:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><result</span> <span
class="na">name=</span><span class="s">"success"</span> <span
class="na">type=</span><span class="s">"jasper"</span><span
class="nt">></span>
- <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"location"</span><span class="nt">></span>foo.jasper<span
class="nt"></param></span>
- <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"dataSource"</span><span class="nt">></span>mySource<span
class="nt"></param></span>
- <span class="nt"></result></span>
-
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><result</span> <span
class="na">name=</span><span class="s">"success"</span> <span
class="na">type=</span><span class="s">"jasper"</span><span
class="nt">></span>
+ <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"location"</span><span class="nt">></span>foo.jasper<span
class="nt"></param></span>
+ <span class="nt"><param</span> <span class="na">name=</span><span
class="s">"dataSource"</span><span class="nt">></span>mySource<span
class="nt"></param></span>
+<span class="nt"></result></span>
</code></pre></div></div>
<h3 id="settings">Settings</h3>
@@ -225,9 +209,8 @@
<h3 id="installation">Installation</h3>
-<p>This plugin can be installed by copying the plugin jar into your
application’s <code class="language-plaintext
highlighter-rouge">/WEB-INF/lib</code> directory. No other files need to be
copied or created.</p>
-
-<hr />
+<p>This plugin can be installed by copying the plugin jar into your
application’s <code class="language-plaintext
highlighter-rouge">/WEB-INF/lib</code> directory.<br />
+No other files need to be copied or created.</p>
<blockquote>
<p>See also <a
href="http://www.vitarara.org/cms/node/131http://www.vitarara.org/cms/node/131";>Compiling
JasperReports JRXML Files with Maven</a> (Mark Menard)</p>
diff --git a/content/plugins/java-8-support/index.html
b/content/plugins/java-8-support/index.html
index 6c53dc3c8..7f535e848 100644
--- a/content/plugins/java-8-support/index.html
+++ b/content/plugins/java-8-support/index.html
@@ -129,17 +129,21 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/java-8-support/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="java-8-support-plugin">Java 8 Support Plugin</h1>
+ <h1 class="no_toc" id="java-8-support-plugin">Java 8 Support Plugin</h1>
-<p>This plugin was dropped in Struts 2.5.5 as Struts Core is using ASM5 now
which supports Java8.</p>
+<ul id="markdown-toc">
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#supported-java-8-features"
id="markdown-toc-supported-java-8-features">Supported Java 8 features</a></li>
+</ul>
-<p>Adds support for Java 8 - to allow use the latest features of the language
with Struts actions.</p>
+<p>This plugin was dropped in Struts 2.5.5 as Struts Core is using ASM5 now
which supports Java8.
+Adds support for Java 8 - to allow use the latest features of the language
with Struts actions.</p>
<h2 id="usage">Usage</h2>
-<p>You must define it as a dependency in <code class="language-plaintext
highlighter-rouge">pom.xml</code> and exclude the old version of ASM used with
<code class="language-plaintext highlighter-rouge">xwork-core</code>, see a
code snippet below:</p>
+<p>You must define it as a dependency in <code class="language-plaintext
highlighter-rouge">pom.xml</code> and exclude the old version of ASM used with
<code class="language-plaintext highlighter-rouge">xwork-core</code>, see a
code snippet below:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.apache.struts.xwork<span
class="nt"></groupId></span>
@@ -157,12 +161,12 @@
<span class="nt"></dependency></span>
</code></pre></div></div>
-<p>If you don’t use Maven to manage the dependencies, please be sure to
replace <code class="language-plaintext highlighter-rouge">asm.jar</code> and
<code class="language-plaintext highlighter-rouge">asm-commons.jar</code> with
appropriated ASM 5 versions.</p>
+<p>If you don’t use Maven to manage the dependencies, please be sure to
replace <code class="language-plaintext highlighter-rouge">asm.jar</code> and
<code class="language-plaintext highlighter-rouge">asm-commons.jar</code> with
appropriated ASM 5 versions.</p>
<h2 id="supported-java-8-features">Supported Java 8 features</h2>
<ul>
- <li>Lambda Expressions in actions when using them with the Convention
plugin</li>
+ <li>Lambda Expressions in actions when using them with the Convention
plugin</li>
</ul>
</section>
diff --git a/content/plugins/javatemplates/index.html
b/content/plugins/javatemplates/index.html
index e49fb5a28..52cff8f6c 100644
--- a/content/plugins/javatemplates/index.html
+++ b/content/plugins/javatemplates/index.html
@@ -129,9 +129,15 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/javatemplates/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="javatemplates-plugin">Javatemplates Plugin</h1>
+ <h1 class="no_toc" id="javatemplates-plugin">Javatemplates Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ <li><a href="#supported-tags" id="markdown-toc-supported-tags">Supported
tags</a></li>
+ <li><a href="#performance-benchmark"
id="markdown-toc-performance-benchmark">Performance benchmark</a></li>
+</ul>
<p>This plugin provides a faster Java implementation of tags in the “simple”
theme.</p>
@@ -153,25 +159,25 @@
<h2 id="supported-tags">Supported tags</h2>
<ul>
- <li><em>a</em></li>
- <li><em>actionerror</em></li>
- <li><em>actionmessage</em></li>
- <li><em>checkbox</em></li>
- <li><em>datetextfield</em></li>
- <li><em>div</em></li>
- <li><em>fielderror</em></li>
- <li><em>file</em></li>
- <li><em>form</em></li>
- <li><em>head</em></li>
- <li><em>hidden</em></li>
- <li><em>label</em></li>
- <li><em>password</em></li>
- <li><em>select</em></li>
- <li><em>reset</em></li>
- <li><em>submit</em></li>
- <li><em>textfield</em></li>
- <li><em>textarea</em></li>
- <li><em>token</em></li>
+ <li><code class="language-plaintext highlighter-rouge">a</code></li>
+ <li><code class="language-plaintext
highlighter-rouge">actionerror</code></li>
+ <li><code class="language-plaintext
highlighter-rouge">actionmessage</code></li>
+ <li><code class="language-plaintext highlighter-rouge">checkbox</code></li>
+ <li><code class="language-plaintext
highlighter-rouge">datetextfield</code></li>
+ <li><code class="language-plaintext highlighter-rouge">div</code></li>
+ <li><code class="language-plaintext highlighter-rouge">fielderror</code></li>
+ <li><code class="language-plaintext highlighter-rouge">file</code></li>
+ <li><code class="language-plaintext highlighter-rouge">form</code></li>
+ <li><code class="language-plaintext highlighter-rouge">head</code></li>
+ <li><code class="language-plaintext highlighter-rouge">hidden</code></li>
+ <li><code class="language-plaintext highlighter-rouge">label</code></li>
+ <li><code class="language-plaintext highlighter-rouge">password</code></li>
+ <li><code class="language-plaintext highlighter-rouge">select</code></li>
+ <li><code class="language-plaintext highlighter-rouge">reset</code></li>
+ <li><code class="language-plaintext highlighter-rouge">submit</code></li>
+ <li><code class="language-plaintext highlighter-rouge">textfield</code></li>
+ <li><code class="language-plaintext highlighter-rouge">textarea</code></li>
+ <li><code class="language-plaintext highlighter-rouge">token</code></li>
</ul>
<h2 id="performance-benchmark">Performance benchmark</h2>
diff --git a/content/plugins/jfreechart/index.html
b/content/plugins/jfreechart/index.html
index 6f924bc10..09b707ebf 100644
--- a/content/plugins/jfreechart/index.html
+++ b/content/plugins/jfreechart/index.html
@@ -129,9 +129,25 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/jfreechart/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="jfreechart-plugin">JFreeChart Plugin</h1>
+ <h1 class="no_toc" id="jfreechart-plugin">JFreeChart Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a> <ul>
+ <li><a href="#future-work" id="markdown-toc-future-work">Future
Work</a></li>
+ </ul>
+ </li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="description">Description</h2>
<p><a href="http://www.jfree.org/jfreechart/";>JFreeChart</a> is a free 100%
Java (LGPL) chart library that makes it easy for
developers to display professional quality charts in their applications.</p>
diff --git a/content/plugins/jsf/index.html b/content/plugins/jsf/index.html
index 0062095e0..ab4dc60c4 100644
--- a/content/plugins/jsf/index.html
+++ b/content/plugins/jsf/index.html
@@ -129,9 +129,23 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/jsf/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="jsf-plugin">JSF Plugin</h1>
+ <h1 class="no_toc" id="jsf-plugin">JSF Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ </ul>
+ </li>
+ <li><a href="#resources" id="markdown-toc-resources">Resources</a></li>
+</ul>
+
+<h2 id="description">Description</h2>
<p><a href="http://java.sun.com/j2ee/javaserverfaces";>JavaServer Faces</a>
technology simplifies building user interfaces for JavaServer applications.
Developers of various skill levels can quickly build web applications by:
assembling reusable UI components in a page; connecting these components to an
application data source; and wiring client-generated events to server-side
event handlers.</p>
diff --git a/content/plugins/json/index.html b/content/plugins/json/index.html
index 34f2eb8d7..8b7fa3274 100644
--- a/content/plugins/json/index.html
+++ b/content/plugins/json/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/json/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="json-plugin">JSON Plugin</h1>
diff --git a/content/plugins/junit/index.html b/content/plugins/junit/index.html
index 092d2f541..678526ba3 100644
--- a/content/plugins/junit/index.html
+++ b/content/plugins/junit/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/junit/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="junit-plugin">JUnit plugin</h1>
diff --git a/content/plugins/osgi/index.html b/content/plugins/osgi/index.html
index 96a910dba..ae664306c 100644
--- a/content/plugins/osgi/index.html
+++ b/content/plugins/osgi/index.html
@@ -129,9 +129,27 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/osgi/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="osgi-plugin">OSGi Plugin</h1>
+ <h1 class="no_toc" id="osgi-plugin">OSGi Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#overview" id="markdown-toc-overview">Overview</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#missing-features" id="markdown-toc-missing-features">Missing
Features</a></li>
+ <li><a href="#about-run-levels" id="markdown-toc-about-run-levels">About Run
levels</a></li>
+ <li><a href="#simple-usage" id="markdown-toc-simple-usage">Simple
Usage</a></li>
+ <li><a href="#using-spring" id="markdown-toc-using-spring">Using
Spring</a></li>
+ <li><a href="#using-velocity" id="markdown-toc-using-velocity">Using
Velocity</a></li>
+ <li><a href="#using-the-convention-plugin"
id="markdown-toc-using-the-convention-plugin">Using The Convention
Plugin</a></li>
+ <li><a href="#the-osgi-interceptor"
id="markdown-toc-the-osgi-interceptor">The OSGi interceptor</a></li>
+ <li><a href="#admin-bundle" id="markdown-toc-admin-bundle">Admin
bundle</a></li>
+ <li><a href="#about-stoppingstarting-bundles"
id="markdown-toc-about-stoppingstarting-bundles">About stopping/starting
bundles</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#building-bundles-with-maven"
id="markdown-toc-building-bundles-with-maven">Building bundles with
Maven</a></li>
+ <li><a href="#struts-osgi--spring-osgi-diagram"
id="markdown-toc-struts-osgi--spring-osgi-diagram">Struts OSGi + Spring OSGi
diagram</a></li>
+ <li><a href="#resources" id="markdown-toc-resources">Resources</a></li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
diff --git a/content/plugins/oval/index.html b/content/plugins/oval/index.html
index 6a76460bc..c101b7c5d 100644
--- a/content/plugins/oval/index.html
+++ b/content/plugins/oval/index.html
@@ -129,9 +129,22 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/oval/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="oval-plugin">OVal Plugin</h1>
+ <h1 class="no_toc" id="oval-plugin">OVal Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#overview" id="markdown-toc-overview">Overview</a></li>
+ <li><a href="#interceptors"
id="markdown-toc-interceptors">Interceptors</a></li>
+ <li><a href="#annotations" id="markdown-toc-annotations">Annotations</a></li>
+ <li><a href="#xml-configuration" id="markdown-toc-xml-configuration">XML
Configuration</a></li>
+ <li><a href="#profiles" id="markdown-toc-profiles">Profiles</a></li>
+ <li><a href="#internationalization-of-messages"
id="markdown-toc-internationalization-of-messages">Internationalization of
messages</a></li>
+ <li><a href="#the-oval-validation-interceptor"
id="markdown-toc-the-oval-validation-interceptor">The OVal Validation
Interceptor</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ <li><a href="#configuration-reference"
id="markdown-toc-configuration-reference">Configuration reference</a></li>
+ <li><a href="#resources" id="markdown-toc-resources">Resources</a></li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
diff --git a/content/plugins/plexus/index.html
b/content/plugins/plexus/index.html
index 777f6e876..77ce7ea28 100644
--- a/content/plugins/plexus/index.html
+++ b/content/plugins/plexus/index.html
@@ -129,9 +129,19 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/plexus/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="plexus-plugin">Plexus Plugin</h1>
+ <h1 class="no_toc" id="plexus-plugin">Plexus Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+ </ul>
+ </li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
diff --git a/content/plugins/portlet-tiles/index.html
b/content/plugins/portlet-tiles/index.html
index 43d7af4e1..b6a1d1a60 100644
--- a/content/plugins/portlet-tiles/index.html
+++ b/content/plugins/portlet-tiles/index.html
@@ -129,9 +129,15 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/portlet-tiles/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="portlet-tiles-plugin">Portlet Tiles Plugin</h1>
+ <h1 class="no_toc" id="portlet-tiles-plugin">Portlet Tiles Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
diff --git a/content/plugins/portlet/index.html
b/content/plugins/portlet/index.html
index 142d0cdf8..5bbc85a81 100644
--- a/content/plugins/portlet/index.html
+++ b/content/plugins/portlet/index.html
@@ -129,9 +129,26 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/portlet/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="portlet-plugin">Portlet Plugin</h1>
+ <h1 class="no_toc" id="portlet-plugin">Portlet Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#documentation"
id="markdown-toc-documentation">Documentation</a> <ul>
+ <li><a href="#portlet-class"
id="markdown-toc-portlet-class">portlet-class</a></li>
+ <li><a href="#portlet-init-parameters"
id="markdown-toc-portlet-init-parameters">Portlet Init Parameters</a></li>
+ <li><a href="#webxml" id="markdown-toc-webxml">web.xml</a></li>
+ <li><a href="#portlet-phases" id="markdown-toc-portlet-phases">Portlet
Phases</a></li>
+ <li><a href="#portlet-result-dispatching"
id="markdown-toc-portlet-result-dispatching">Portlet Result Dispatching</a>
<ul>
+ <li><a href="#redirectaction"
id="markdown-toc-redirectaction">redirectAction</a></li>
+ </ul>
+ </li>
+ <li><a href="#surl-and-sform-tags"
id="markdown-toc-surl-and-sform-tags">s:url and s:form tags</a></li>
+ <li><a href="#security" id="markdown-toc-security">Security</a></li>
+ <li><a href="#other-resources" id="markdown-toc-other-resources">Other
resources</a></li>
+ </ul>
+ </li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
diff --git a/content/plugins/rest/index.html b/content/plugins/rest/index.html
index f4eaaada0..2db5f2739 100644
--- a/content/plugins/rest/index.html
+++ b/content/plugins/rest/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/rest/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="rest-plugin">REST Plugin</h1>
diff --git a/content/plugins/sitegraph/index.html
b/content/plugins/sitegraph/index.html
index 7c778bdef..a91d5b3de 100644
--- a/content/plugins/sitegraph/index.html
+++ b/content/plugins/sitegraph/index.html
@@ -129,19 +129,32 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/sitegraph/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="sitegraph-plugin">SiteGraph Plugin</h1>
+ <h1 class="no_toc" id="sitegraph-plugin">SiteGraph Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#understanding-the-output"
id="markdown-toc-understanding-the-output">Understanding the Output</a></li>
+ <li><a href="#requirements"
id="markdown-toc-requirements">Requirements</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a> <ul>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#automatic-execution"
id="markdown-toc-automatic-execution">Automatic Execution</a></li>
+ </ul>
+ </li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.5.11!</p>
</blockquote>
-<p>The SiteGraph plugin generates graphical diagrams representing the flow of
your web application.</p>
+<h2 id="description">Description</h2>
-<p>SiteGraph works by parsing your configuration files, Action classes, and
view files (JSP, Velocity, and FreeMarker), and displaying a visual map.</p>
-
-<p>Additional information can be found in the JavaDocs:</p>
+<p>The SiteGraph plugin generates graphical diagrams representing the flow of
your web application.
+SiteGraph works by parsing your configuration files, Action classes, and view
files (JSP, Velocity, and FreeMarker),
+and displaying a visual map. Additional information can be found in the
JavaDocs:</p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> * <p>
* SiteGraph is a tool that renders out GraphViz-generated images depicting
your
@@ -149,76 +162,49 @@
* and that the "dot" executable be in your command path. You can find GraphViz
* at http://www.graphviz.org.
* </p>
-
</code></pre></div></div>
-<p><strong>Understanding the Output</strong></p>
+<h2 id="understanding-the-output">Understanding the Output</h2>
<p>There are several key things to notice when looking at the output from
SiteGraph:</p>
<ul>
- <li>
- <p>Boxes: those shaded red indicate an action; those shaded green indicate
a view file (JSP, etc).</p>
- </li>
- <li>
- <p>Links: arrows colored green imply that no new HTTP request is being
made; black arrows indicate a new HTTP request.</p>
- </li>
- <li>
- <p>Link labels: labels may sometimes contain additional useful
information. For example, a label of <strong>href</strong> means that the link
behavior is that of a hyper-text reference. The complete label behaviors are
provided:</p>
-
+ <li>Boxes: those shaded red indicate an action; those shaded green indicate
a view file (JSP, etc).</li>
+ <li>Links: arrows colored green imply that no new HTTP request is being
made; black arrows indicate a new HTTP request.</li>
+ <li>Link labels: labels may sometimes contain additional useful information.
For example, a label of <strong>href</strong> means that
+the link behavior is that of a hyper-text reference. The complete label
behaviors are provided:
<ul>
- <li>
- <p><strong>href</strong> - a view file references an action by name
(typically ending with the extension “.action”)</p>
- </li>
- <li>
- <p><strong>action</strong> - a view file makes a call to the
<em>action</em> tag</p>
- </li>
- <li>
- <p><strong>form</strong> - a view file is linked to an action using
the <em>form</em> tag</p>
- </li>
- <li>
- <p><strong>redirect</strong> - an action is redirecting to another
view or action</p>
- </li>
- <li>
- <p><strong>! notation</strong> - a link to an action overrides the
method to invoke</p>
- </li>
+ <li><strong>href</strong> - a view file references an action by name
(typically ending with the extension “.action”)</li>
+ <li><strong>action</strong> - a view file makes a call to the
<em>action</em> tag</li>
+ <li><strong>form</strong> - a view file is linked to an action using the
<em>form</em> tag</li>
+ <li><strong>redirect</strong> - an action is redirecting to another view
or action</li>
+ <li><strong>! notation</strong> - a link to an action overrides the
method to invoke</li>
</ul>
</li>
</ul>
-<p><strong>Requirements</strong></p>
+<h2 id="requirements">Requirements</h2>
<p>SiteGraph requires that your view files be structured in a very specific
way. Because it has to read these files, only certain styles are supported. The
requirements are:</p>
<ul>
- <li>
- <p>The JSP tags must use the “s” namespace.</p>
-
+ <li>The JSP tags must use the “s” namespace.
<ul>
- <li>
- <p>In JSP: <s:xxx/></p>
- </li>
- <li>
- <p>In FreeMarker: <@s.xxx/></p>
- </li>
- <li>
- <p>In Velocity: N/A</p>
- </li>
+ <li>In JSP: <code class="language-plaintext
highlighter-rouge"><s:xxx/></code></li>
+ <li>In FreeMarker: <code class="language-plaintext
highlighter-rouge"><@s.xxx/></code></li>
+ <li>In Velocity: N/A</li>
</ul>
</li>
- <li>
- <p>Use of the <em>form</em> tag and <em>action</em> tag must be linking
directly to the action name (and optional namespace). This means that
<s:form action=”foo”/> is OK, but <s:form action=”foo.action”/> is
not.
- Here is also a short overview of what it does and why a developer would want
to use it.</p>
- </li>
+ <li>Use of the <em>form</em> tag and <em>action</em> tag must be linking
directly to the action name (and optional namespace).
+This means that <code class="language-plaintext highlighter-rouge"><s:form
action="foo"/></code> is OK, but <code class="language-plaintext
highlighter-rouge"><s:form action="foo.action"/></code> is not.
+Here is also a short overview of what it does and why a developer would want
to use it.</li>
</ul>
-<p><strong>Features</strong></p>
+<h2 id="features">Features</h2>
-<ul>
- <li>Generates a graphical view of your web application</li>
-</ul>
+<p>Generates a graphical view of your web application</p>
-<h2 id="usage">Usage</h2>
+<h3 id="usage">Usage</h3>
<p>You can use SiteGraph with the following command:</p>
@@ -227,7 +213,6 @@
-views VIEWS_DIRS
-output OUTPUT
[-ns NAMESPACE]
-
</code></pre></div></div>
<p>Where:</p>
@@ -237,16 +222,22 @@
VIEWS_DIRS => comma seperated list of dirs containing JSPs, VMs, etc
OUPUT => the directory where the output should go
NAMESPACE => the namespace path restriction (/, /foo, etc)
-
</code></pre></div></div>
-<p>You must either supply the correct classpath when invoking the SiteGraph
tool or place the Sitegraph plugin in the same directory as the dependent jars.
Specifically, the XWork jar, Struts jar, and their dependencies must be
included in the classpath. Futhermore, <strong>you must also include your
Action class files referenced in</strong> struts.xml. Without the proper class
path entries, SiteGraph will not function properly.</p>
+<p>You must either supply the correct classpath when invoking the SiteGraph
tool or place the Sitegraph plugin in the same
+directory as the dependent jars. Specifically, the XWork jar, Struts jar, and
their dependencies must be included
+in the classpath. Futhermore, <strong>you must also include your Action class
files referenced in</strong> struts.xml.
+Without the proper class path entries, SiteGraph will not function
properly.</p>
-<p>Once you have run SiteGraph, check the directory specified in the “output”
argument (OUTPUT). In there you will find two files: <strong>out.dot</strong>
and <strong>out.gif</strong>. You may immediately open up
<strong>out.gif</strong> and view the web application flow. However, you may
also wish to either run the <strong>out.dot</strong> file through a different
GraphVis layout engine (neato, twopi, etc), so the original dot file is
provided as well. You may also wish to edit the dot [...]
+<p>Once you have run SiteGraph, check the directory specified in the “output”
argument (OUTPUT). In there you will find
+two files: <strong>out.dot</strong> and <strong>out.gif</strong>. You may
immediately open up <strong>out.gif</strong> and view the web application flow.
+However, you may also wish to either run the <strong>out.dot</strong> file
through a different GraphVis layout engine (neato, twopi, etc),
+so the original dot file is provided as well. You may also wish to edit the
dot file before rendering the final flow diagram.</p>
-<p><strong>Automatic Execution</strong></p>
+<h3 id="automatic-execution">Automatic Execution</h3>
-<p>Some advanced users may wish to execute SiteGraph from within their
application - this could be required if you are developing an application that
supports plugin capabilities. This can easily be done. See the JavaDocs for
more info:</p>
+<p>Some advanced users may wish to execute SiteGraph from within their
application - this could be required if you are
+developing an application that supports plugin capabilities. This can easily
be done. See the JavaDocs for more info:</p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> * <p>
* If you wish to use SiteGraph through its API rather than through the
command line,
@@ -254,28 +245,27 @@
* optionally specify a {@link Writer} to output the dot content to, and then
call
* {@link #prepare()}.
* </p>
-
</code></pre></div></div>
<p>The command line version of SiteGraph does exactly this (except for
overriding the Writer):</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nc">SiteGraph</span> <span
class="n">siteGraph</span> <span class="o">=</span> <span class="k">new</span>
<span class="nc">SiteGraph</span><span class="o">(</span><span
class="n">configDir</span><span class="o">,</span> <span
class="n">views</span><span class="o">,</span> <span
class="n">output</span><span class="o">,</span> <span
class="n">namespace</span><span class="o" [...]
- <span class="n">siteGraph</span><span class="o">.</span><span
class="na">prepare</span><span class="o">();</span>
- <span class="n">siteGraph</span><span class="o">.</span><span
class="na">render</span><span class="o">();</span>
-
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nc">SiteGraph</span> <span
class="n">siteGraph</span> <span class="o">=</span> <span class="k">new</span>
<span class="nc">SiteGraph</span><span class="o">(</span><span
class="n">configDir</span><span class="o">,</span> <span
class="n">views</span><span class="o">,</span> <span
class="n">output</span><span class="o">,</span> <span
class="n">namespace</span><span class="o">);</span>
+ <span class="n">siteGraph</span><span class="o">.</span><span
class="na">prepare</span><span class="o">();</span>
+ <span class="n">siteGraph</span><span class="o">.</span><span
class="na">render</span><span class="o">();</span>
</code></pre></div></div>
-<p><strong>Example</strong></p>
-
-<p><strong>Settings</strong></p>
+<h2 id="settings">Settings</h2>
<p>This plugin doesn’t allow for any global settings.</p>
-<p><strong>Installation</strong></p>
+<h2 id="installation">Installation</h2>
-<p>The SiteGraph plugin jar is distributed with Struts, so if you’re up and
running, you don’t need to do download any additional Java packages. However,
SiteGraph does require the “dot” package by <a
href="http://www.graphviz.org";>GraphViz</a>.</p>
+<p>The SiteGraph plugin jar is distributed with Struts, so if you’re up and
running, you don’t need to do download
+any additional Java packages. However, SiteGraph does require the “dot”
package by <a href="http://www.graphviz.org";>GraphViz</a>.</p>
-<p>You’ll need to download the latest version of GraphViz and make sure that
the dot executable (dot.exe in Windows) is in your command path. In Windows the
GraphViz installer typically automatically adds <code class="language-plaintext
highlighter-rouge">dot.exe</code> to your path. However, you may need to do
this by hand depending on your system configuration.</p>
+<p>You’ll need to download the latest version of GraphViz and make sure that
the dot executable (dot.exe in Windows)
+is in your command path. In Windows the GraphViz installer typically
automatically adds <code class="language-plaintext
highlighter-rouge">dot.exe</code> to your path.
+However, you may need to do this by hand depending on your system
configuration.</p>
</section>
</article>
diff --git a/content/plugins/sitemesh/index.html
b/content/plugins/sitemesh/index.html
index e1c2a4a9c..ffdabb6fe 100644
--- a/content/plugins/sitemesh/index.html
+++ b/content/plugins/sitemesh/index.html
@@ -129,9 +129,24 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/sitemesh/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="sitemesh-plugin">SiteMesh Plugin</h1>
+ <h1 class="no_toc" id="sitemesh-plugin">SiteMesh Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#about-sitemesh" id="markdown-toc-about-sitemesh">About
SiteMesh</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#freemarker--and-velocity-decorators"
id="markdown-toc-freemarker--and-velocity-decorators">FreeMarker and Velocity
Decorators</a> <ul>
+ <li><a href="#freemarker"
id="markdown-toc-freemarker">FreeMarker</a></li>
+ <li><a href="#velocity" id="markdown-toc-velocity">Velocity</a></li>
+ <li><a
href="#full-integration-with-sitemesh-2--freemarker-242--velocity-13--including-struts-2-tags-valuestack-and-freemarkermanager-statics"
id="markdown-toc-full-integration-with-sitemesh-2--freemarker-242--velocity-13--including-struts-2-tags-valuestack-and-freemarkermanager-statics">Full
integration with SiteMesh 2 + Freemarker 2.4.2 + Velocity 1.3 , including
Struts 2 Tags, ValueStack, and FreemarkerManager statics.</a></li>
+ </ul>
+ </li>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
<blockquote>
<p>This plugin got marked as deprecated since Struts 2.6!</p>
@@ -146,25 +161,23 @@ framework to aid in creating large sites consisting of
many pages for which a co
<p>The Sitemesh plugin allows Sitemesh templates to access framework
resources.</p>
-<p>The framework stores all its value stack information as request attributes,
meaning that if you wish to display data that is on the stack (or even the
ActionContext), you can do so by using the normal tag libraries that come with
the framework. That’s it!</p>
+<p>The framework stores all its value stack information as request attributes,
meaning that if you wish to display data
+that is on the stack (or even the ActionContext), you can do so by using the
normal tag libraries that come
+with the framework. That’s it!</p>
<h2 id="features">Features</h2>
<ul>
- <li>
- <p>Can use Struts tags in Sitemesh decorator templates</p>
- </li>
- <li>
- <p>Sitemesh decorators can be written in FreeMarker as well as Velocity
and JSP</p>
- </li>
+ <li>Can use Struts tags in Sitemesh decorator templates</li>
+ <li>Sitemesh decorators can be written in FreeMarker as well as Velocity and
JSP</li>
</ul>
<h2 id="usage">Usage</h2>
-<p>From 2.2+ the new <code class="language-plaintext
highlighter-rouge">com.opensymphony.sitemesh.webapp.SiteMeshFilter</code>
filter and Struts <code class="language-plaintext
highlighter-rouge">org.apache.struts2.dispatcher.ng.listener.StrutsListener</code>
context listener must be added to <code class="language-plaintext
highlighter-rouge">web.xml</code>, like:</p>
+<p>From 2.2+ the new <code class="language-plaintext
highlighter-rouge">com.opensymphony.sitemesh.webapp.SiteMeshFilter</code>
filter
+and Struts <code class="language-plaintext
highlighter-rouge">org.apache.struts2.dispatcher.ng.listener.StrutsListener</code>
context listener must be added to <code class="language-plaintext
highlighter-rouge">web.xml</code>, like:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="nt"><filter></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><filter></span>
<span class="nt"><filter-name></span>sitemesh<span
class="nt"></filter-name></span>
<span
class="nt"><filter-class></span>com.opensymphony.sitemesh.webapp.SiteMeshFilter<span
class="nt"></filter-class></span>
<span class="nt"></filter></span>
@@ -177,11 +190,13 @@ framework to aid in creating large sites consisting of
many pages for which a co
<h2 id="freemarker--and-velocity-decorators">FreeMarker and Velocity
Decorators</h2>
-<p>The plugin provides an extension of the SiteMesh <em>Velocity</em> and
<em>FreeMarker</em> servlets. These servlets provide the standard variables
and <em>Struts Tags</em> that you used to create views in your favourite
template language.</p>
+<p>The plugin provides an extension of the SiteMesh <em>Velocity</em> and
<em>FreeMarker</em> servlets. These servlets provide
+the standard variables and <em>Struts Tags</em> that you used to create views
in your favourite template language.</p>
<h3 id="freemarker">FreeMarker</h3>
-<p>From 2.2+ the recommended way to use Freemarker with Sitemesh is through
the <code class="language-plaintext
highlighter-rouge">org.apache.struts2.sitemesh.FreemarkerDecoratorServlet</code>
servlet, which can be configured like this in <code class="language-plaintext
highlighter-rouge">web.xml</code>:</p>
+<p>From 2.2+ the recommended way to use Freemarker with Sitemesh is through
the <code class="language-plaintext
highlighter-rouge">org.apache.struts2.sitemesh.FreemarkerDecoratorServlet</code>
+servlet, which can be configured like this in <code class="language-plaintext
highlighter-rouge">web.xml</code>:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
<span class="nt"><servlet></span>
@@ -207,7 +222,8 @@ framework to aid in creating large sites consisting of many
pages for which a co
<p>NOTE: Please include the <a href="../velocity/">Struts Velocity
plugin</a> in your pom.xml before using this functionality</p>
</blockquote>
-<p>From 2.2+ the recommended way to use Velocity with Sitemesh is through the
<code class="language-plaintext
highlighter-rouge">org.apache.struts2.sitemesh.VelocityDecoratorServlet</code>
servlet, which can be configured like this in <code class="language-plaintext
highlighter-rouge">web.xml</code>:</p>
+<p>From 2.2+ the recommended way to use Velocity with Sitemesh is through the
<code class="language-plaintext
highlighter-rouge">org.apache.struts2.sitemesh.VelocityDecoratorServlet</code>
+servlet, which can be configured like this in <code class="language-plaintext
highlighter-rouge">web.xml</code>:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
<span class="nt"><servlet></span>
@@ -296,8 +312,7 @@ framework to aid in creating large sites consisting of many
pages for which a co
<p>Here is an example of how to configure the filter chains in <code
class="language-plaintext highlighter-rouge">web.xml</code>:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="nt"><filter></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><filter></span>
<span class="nt"><filter-name></span>struts-prepare<span
class="nt"></filter-name></span>
<span
class="nt"><filter-class></span>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter<span
class="nt"></filter-class></span>
<span class="nt"></filter></span>
@@ -366,8 +381,7 @@ framework to aid in creating large sites consisting of many
pages for which a co
<p>Struts 2.1 web.xml filter chain example:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="nt"><filter></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><filter></span>
<span class="nt"><filter-name></span>struts-prepare<span
class="nt"></filter-name></span>
<span
class="nt"><filter-class></span>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter<span
class="nt"></filter-class></span>
<span class="nt"></filter></span>
@@ -399,12 +413,10 @@ framework to aid in creating large sites consisting of
many pages for which a co
</code></pre></div></div>
-<p>You do not need the struts2-sitmesh-plugin if you are using JSP for your
decorators.</p>
+<p>You do not need the struts2-sitmesh-plugin if you are using JSP for your
decorators.
+Here are the only changes needed to web.xml</p>
-<p>Here are the only only changes needed to web.xml</p>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="nt"><filter></span>
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><filter></span>
<span class="nt"><filter-name></span>struts2-prepare<span
class="nt"></filter-name></span>
<span
class="nt"><filter-class></span>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareFilter<span
class="nt"></filter-class></span>
<span class="nt"></filter></span>
diff --git a/content/plugins/spring/index.html
b/content/plugins/spring/index.html
index f9fccad96..34af98b8e 100644
--- a/content/plugins/spring/index.html
+++ b/content/plugins/spring/index.html
@@ -129,46 +129,56 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/spring/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="spring-plugin">Spring Plugin</h1>
<ul id="markdown-toc">
<li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
<li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#autowiring" id="markdown-toc-autowiring">Autowiring</a></li>
+ <li><a href="#initializing-actions-from-spring"
id="markdown-toc-initializing-actions-from-spring">Initializing Actions from
Spring</a></li>
+ <li><a href="#class-reloading" id="markdown-toc-class-reloading">Class
Reloading</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
</ul>
<h2 id="description">Description</h2>
-<p><a href="http://www.springframework.org";>Spring</a> is a lightweight
container, providing centralized, automated configuration and wiring of your
application objects, using a technique called “Dependency Injection”.</p>
+<p><a href="http://www.springframework.org";>Spring</a> is a lightweight
container, providing centralized, automated configuration
+and wiring of your application objects, using a technique called “Dependency
Injection”.</p>
-<p>The Spring Plugin works by overriding the Struts <a
href="/core-developers/object-factory">ObjectFactory</a> to enhance the
creation of core framework objects. When an object is to be created, it uses
the <code class="language-plaintext highlighter-rouge">class</code> attribute
in the Struts configuration to correspond to the <code
class="language-plaintext highlighter-rouge">id</code> attribute in the Spring
configuration. If not found, the class will try to be created as usual, then
[...]
+<p>The Spring Plugin works by overriding the Struts <a
href="/core-developers/object-factory">ObjectFactory</a> to enhance
+the creation of core framework objects. When an object is to be created, it
uses the <code class="language-plaintext highlighter-rouge">class</code>
attribute in
+the Struts configuration to correspond to the <code class="language-plaintext
highlighter-rouge">id</code> attribute in the Spring configuration. If not
found, the class will
+try to be created as usual, then be autowired by Spring. In the case of
Actions, Spring 2’s
+<a
href="http://www.springframework.org/docs/reference/beans.html#beans-factory-scopes";>bean
scope feature</a> can be used to scope
+an Action instance to the session, application, or a custom scope, providing
advanced customization above
+the default per-request scoping.</p>
<blockquote>
- <p>Remember:</p>
-
- <p><strong>registering Actions with Spring is not required</strong>. The
Spring alternative is there if you need it, but the framework will
automatically create Actions objects from the action mappings. But, if you want
to use Spring to inject your Actions, the option is there.</p>
+ <p>Remember:
+<strong>registering Actions with Spring is not required</strong>. The Spring
alternative is there if you need it, but the framework
+will automatically create Actions objects from the action mappings. But, if
you want to use Spring to inject your Actions,
+the option is there.</p>
</blockquote>
-<p><strong>Features</strong></p>
+<h2 id="features">Features</h2>
<ul>
- <li>
- <p>Allow Actions, Interceptors, and Results to be created by Spring</p>
- </li>
- <li>
- <p>Struts-created objects can be autowired by Spring after creation</p>
- </li>
- <li>
- <p>Provides two interceptors that autowire actions, if not using the
Spring ObjectFactory</p>
- </li>
+ <li>Allow Actions, Interceptors, and Results to be created by Spring</li>
+ <li>Struts-created objects can be autowired by Spring after creation</li>
+ <li>Provides two interceptors that autowire actions, if not using the Spring
ObjectFactory</li>
</ul>
<h2 id="usage">Usage</h2>
<p>To enable Spring integration, simply include
struts2-spring-plugin-x-x-x.jar in your application.</p>
-<p>If you are using more than one object factory, (for example, by including
both the Spring and Plexus plugins in your application,) you will need to set
the struts.objectFactory property in <a
href="/core-developers/default-properties">default.properties</a> or in one of
several XML files via <a
href="/core-developers/constant-configuration">Constant Configuration</a>:</p>
+<p>If you are using more than one object factory, (for example, by including
both the Spring and Plexus plugins in your application)
+you will need to set the struts.objectFactory property in <a
href="/core-developers/default-properties">default.properties</a>
+or in one of several XML files via <a
href="/core-developers/constant-configuration">Constant Configuration</a>:</p>
<p><strong>struts.properties</strong></p>
@@ -184,9 +194,10 @@
</code></pre></div></div>
-<p><strong>Autowiring</strong></p>
+<h2 id="autowiring">Autowiring</h2>
-<p>The framework enables “autowiring” by default. (Autowiring means to look
for objects defined in Spring with the same name as your object property). To
change the wiring mode, modify the <code class="language-plaintext
highlighter-rouge">spring.autowire</code> property.</p>
+<p>The framework enables “autowiring” by default. (Autowiring means to look
for objects defined in Spring with the same
+name as your object property). To change the wiring mode, modify the <code
class="language-plaintext highlighter-rouge">spring.autowire</code>
property.</p>
<p><strong>Wiring Mode</strong></p>
@@ -259,7 +270,9 @@
<p>More applicationContext configuration files needed?</p>
-<p>Since the Spring integration uses a standard Listener, it can be configured
to support configuration files other than applicationContext.xml. Adding the
following to your web.xml will cause Spring’s ApplicationContext to be
inititalized from all files matching the given pattern:</p>
+<p>Since the Spring integration uses a standard Listener, it can be configured
to support configuration files other than
+applicationContext.xml. Adding the following to your web.xml will cause
Spring’s ApplicationContext to be initialized
+from all files matching the given pattern:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="c"><!-- Context Configuration locations
for Spring XML files --></span>
<span class="nt"><context-param></span>
@@ -270,13 +283,23 @@
<p>See the Spring documentation for a full description of this parameter.</p>
-<p><strong>Initializing Actions from Spring</strong></p>
+<h2 id="initializing-actions-from-spring">Initializing Actions from Spring</h2>
-<p>Normally, in <code class="language-plaintext
highlighter-rouge">struts.xml</code> you specify the class for each Action.
When using the default SpringObjectFactory, the framework will ask Spring to
create the Action and wire up dependencies as specified by the default
auto-wire behavior.</p>
+<p>Normally, in <code class="language-plaintext
highlighter-rouge">struts.xml</code> you specify the class for each Action.
When using the default SpringObjectFactory, the framework
+will ask Spring to create the Action and wire up dependencies as specified by
the default auto-wire behavior.</p>
-<p>We <strong>strongly</strong> recommend that you find declarative ways of
letting Spring know what to provide for your actions. This includes making your
beans able to be autowired by either naming your dependent properties on your
action the same as the bean defined in Spring which should be provided (to
allow for name-based autowiring), or using autowire-by-type and only having one
of the required type registered with Spring. It also can include using JDK5
annotations to declare tran [...]
+<p>We <strong>strongly</strong> recommend that you find declarative ways of
letting Spring know what to provide for your actions.
+This includes making your beans able to be autowired by either naming your
dependent properties on your action the same
+as the bean defined in Spring which should be provided (to allow for
name-based autowiring), or using autowire-by-type
+and only having one of the required type registered with Spring. It also can
include using JDK5 annotations to declare
+ransactional and security requirements rather than having to explicitly set up
proxies in your Spring configuration.
+If you can find ways to let Spring know what it needs to do for your action
without needing any explicit configuration
+in the Spring applicationContext.xml, then you won’t have to maintain this
configuration in both places.</p>
-<p>However, sometimes you might want the bean to be completely managed by
Spring. This is useful, for example, if you wish to apply more complex AOP or
Spring-enabled technologies, such as Acegi, to your beans. To do this, all you
have to do is configure the bean in your Spring <code class="language-plaintext
highlighter-rouge">applicationContext.xml</code> and then <em>change</em> the
class attribute from your Action in the <code class="language-plaintext
highlighter-rouge">struts.xml< [...]
+<p>However, sometimes you might want the bean to be completely managed by
Spring. This is useful, for example, if you wish
+to apply more complex AOP or Spring-enabled technologies, such as Acegi, to
your beans. To do this, all you have to do
+is configure the bean in your Spring <code class="language-plaintext
highlighter-rouge">applicationContext.xml</code> and then <em>change</em> the
class attribute from your Action
+in the <code class="language-plaintext highlighter-rouge">struts.xml</code> to
use the bean name defined in Spring instead of the class name.</p>
<p>Your <code class="language-plaintext highlighter-rouge">struts.xml</code>
file would then have the Action class attributes changed.</p>
@@ -303,7 +326,8 @@
</code></pre></div></div>
-<p>Where you have a Spring bean defined in your <code
class="language-plaintext highlighter-rouge">applicationContext.xml</code>
named “bar”. Note that the <code class="language-plaintext
highlighter-rouge">com.acme.Foo</code> Action did not need to be changed,
because it can be autowired.</p>
+<p>Where you have a Spring bean defined in your <code
class="language-plaintext highlighter-rouge">applicationContext.xml</code>
named “bar”. Note that the <code class="language-plaintext
highlighter-rouge">com.acme.Foo</code>
+Action did not need to be changed, because it can be autowired.</p>
<p>A typical spring configuration for bar could look as following.</p>
@@ -315,32 +339,26 @@
<span class="nt"><bean</span> <span class="na">id=</span><span
class="s">"bar"</span> <span class="na">class=</span><span
class="s">"com.my.BarClass"</span> <span class="na">singleton=</span><span
class="s">"false"</span><span class="nt">/></span>
...
<span class="nt"></beans></span>
-
</code></pre></div></div>
<p>To use session-scoped components with Spring and Struts, see the <a
href="spring-session-components-workarounds">Spring Session Components
Workarounds</a> analysis.</p>
-<p><strong>Class Reloading</strong></p>
+<h2 id="class-reloading">Class Reloading</h2>
-<p>The Spring plugin can be configured to automatically reload classes that
change in the file system. This feature will enable code changes to be “hot
deployed” without having to restart the web container. To enable this feature
follow these steps:</p>
+<p>The Spring plugin can be configured to automatically reload classes that
change in the file system. This feature will
+enable code changes to be “hot deployed” without having to restart the web
container. To enable this feature follow
+these steps:</p>
<ol>
- <li>
- <p>Set “struts.devMode” to “true”</p>
- </li>
- <li>
- <p>Set “struts.class.reloading.watchList” to a comma separated list of
directories, or jar files (absolute or relative paths)</p>
- </li>
- <li>
- <p>Add this to web.xml:</p>
- </li>
+ <li>Set “struts.devMode” to “true”</li>
+ <li>Set “struts.class.reloading.watchList” to a comma separated list of
directories, or jar files (absolute or relative paths)</li>
+ <li>Add this to web.xml:</li>
</ol>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><context-param></span>
- <span class="nt"><param-name></span>contextClass<span
class="nt"></param-name></span>
- <span
class="nt"><param-value></span>org.apache.struts2.spring.ClassReloadingXMLWebApplicationContext<span
class="nt"></param-value></span>
- <span class="nt"></context-param></span>
-
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><context-param></span>
+ <span class="nt"><param-name></span>contextClass<span
class="nt"></param-name></span>
+ <span
class="nt"><param-value></span>org.apache.struts2.spring.ClassReloadingXMLWebApplicationContext<span
class="nt"></param-value></span>
+<span class="nt"></context-param></span>
</code></pre></div></div>
<ol start="4">
@@ -355,7 +373,10 @@
</code></pre></div></div>
-<p>Letting the reloading class loader handle all the classes can lead to
ClassCastException(s) because instances of the same classes loaded by different
class loaders can not be assigned to each other. To prevent this problem we
suggest that <code class="language-plaintext
highlighter-rouge">struts.class.reloading.acceptClasses</code> is used to limit
the classes loaded by the reloading class loader, so only actions are handled
by it. This constant supports a comma separated list of regu [...]
+<p>Letting the reloading class loader handle all the classes can lead to
ClassCastException(s) because instances of the same
+classes loaded by different class loaders can not be assigned to each other.
To prevent this problem we suggest
+that <code class="language-plaintext
highlighter-rouge">struts.class.reloading.acceptClasses</code> is used to limit
the classes loaded by the reloading class loader,
+so only actions are handled by it. This constant supports a comma separated
list of regular expressions:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><constant</span> <span
class="na">name=</span><span
class="s">"struts.class.reloading.acceptClasses"</span> <span
class="na">value=</span><span
class="s">"com.myproject.example.actions..*"</span> <span
class="nt">/></span>
@@ -365,7 +386,7 @@
<p>This feature is experimental, and <strong>should never</strong> be used
in production systems.</p>
</blockquote>
-<p><strong>Settings</strong></p>
+<h2 id="settings">Settings</h2>
<p>The following settings can be customized. See the <a
href="/core-developers/configuration-files">developer guide</a>.</p>
@@ -424,7 +445,7 @@
</tbody>
</table>
-<p><strong>Installation</strong></p>
+<h2 id="installation">Installation</h2>
<p>This plugin can be installed by copying the plugin jar into your
application’s <code class="language-plaintext
highlighter-rouge">/WEB-INF/lib</code> directory. No other files need to be
copied or created.</p>
diff --git a/content/plugins/struts-1/index.html
b/content/plugins/struts-1/index.html
index 601d854aa..f41cb3d2c 100644
--- a/content/plugins/struts-1/index.html
+++ b/content/plugins/struts-1/index.html
@@ -129,10 +129,20 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/struts-1/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="struts-1-plugin">Struts 1 Plugin</h1>
+ <h1 class="no_toc" id="struts-1-plugin">Struts 1 Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
+<h2 id="description">Description</h2>
<p>The Struts 1 plugin allows you to use existing Struts 1 Actions and
ActionForms in Struts 2 applications</p>
<p>This plugin provides a generic Struts 2 Action class to wrap an existing
Struts 1 Action, <code class="language-plaintext
highlighter-rouge">org.apache.struts2.s1.Struts1Action</code>. The wrapper
class provides the expected calls to the legacy Struts 1 Action and ActionForm,
converting incoming and outgoing objects into the expected forms. It works by
using the <a href="/core-developers/scoped-model-driven-interceptor">scoped
model driven</a> technique that uses a single Object as [...]
diff --git a/content/plugins/testng/index.html
b/content/plugins/testng/index.html
index f642c67ec..cbb186de0 100644
--- a/content/plugins/testng/index.html
+++ b/content/plugins/testng/index.html
@@ -129,13 +129,22 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/testng/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="testng-plugin">TestNG Plugin</h1>
+ <h1 class="no_toc" id="testng-plugin">TestNG Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#description" id="markdown-toc-description">Description</a></li>
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
-<p>The TestNG plugin provides integration with the popular <a
href="http://testng.org";>TestNG</a> unit testing framework.</p>
+<h2 id="description">Description</h2>
-<p>This plugin provides a base <code class="language-plaintext
highlighter-rouge">StrutsTestCase</code> class that can subclassed for tests
that work on Struts 2 components.</p>
+<p>The TestNG plugin provides integration with the popular <a
href="http://testng.org";>TestNG</a> unit testing framework.
+This plugin provides a base <code class="language-plaintext
highlighter-rouge">StrutsTestCase</code> class that can subclassed for tests
that work on Struts 2 components.</p>
<blockquote>
<p>This plugin is only available with Struts 2.1.1 or later</p>
diff --git a/content/plugins/tiles-3/index.html
b/content/plugins/tiles-3/index.html
index baf5a03ac..4fc94d5d0 100644
--- a/content/plugins/tiles-3/index.html
+++ b/content/plugins/tiles-3/index.html
@@ -129,14 +129,25 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/tiles-3/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
- <h1 id="tiles-3-plugin">Tiles 3 Plugin</h1>
+ <h1 class="no_toc" id="tiles-3-plugin">Tiles 3 Plugin</h1>
+
+<ul id="markdown-toc">
+ <li><a href="#features" id="markdown-toc-features">Features</a></li>
+ <li><a href="#usage" id="markdown-toc-usage">Usage</a></li>
+ <li><a href="#example" id="markdown-toc-example">Example</a></li>
+ <li><a href="#settings" id="markdown-toc-settings">Settings</a></li>
+ <li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
+</ul>
<blockquote>
<p>This plugin was dropped in Struts 2.5, instead please use <a
href="../tiles">Tiles Plugin</a> which was extended and upgraded to Tiles 3.</p>
+</blockquote>
- <p>Tiles is a templating framework designed to easily allow the creation of
web application pages with a consistent look and feel. It can be used for both
page decorating and componentization. This is the first release of the
plugin!</p>
+<blockquote>
+ <p>Tiles is a templating framework designed to easily allow the creation of
web application pages with a consistent look
+and feel. It can be used for both page decorating and componentization. This
is the first release of the plugin!</p>
</blockquote>
<p>The Tiles 3 plugin allows actions to return Tiles 3 pages.</p>
diff --git a/content/plugins/tiles/index.html b/content/plugins/tiles/index.html
index f65f45b89..e88cfd918 100644
--- a/content/plugins/tiles/index.html
+++ b/content/plugins/tiles/index.html
@@ -129,7 +129,7 @@
<section class="col-md-12">
<a class="edit-on-gh"
href="https://github.com/apache/struts-site/edit/master/source/plugins/tiles/index.md";
title="Edit this page on GitHub">Edit on GitHub</a>
- <a href="../" title="back to Plugins"><< back to Plugins</a>
+ <a href="index.html" title="back to Plugins"><< back to Plugins</a>
<h1 class="no_toc" id="tiles-plugin">Tiles Plugin</h1>
diff --git a/content/tag-developers/css-xhtml-theme.html
b/content/tag-developers/css-xhtml-theme.html
index f18ec9208..c98dca938 100644
--- a/content/tag-developers/css-xhtml-theme.html
+++ b/content/tag-developers/css-xhtml-theme.html
@@ -327,7 +327,7 @@ to provide the layout. The contents of
<strong>head.ftl</strong> are:</p>
* under the License.
*/
-->
-<link <#include "/${parameters.templateDir}/simple/nonce.ftl" />
rel="stylesheet" href="<@s.url
value='${parameters.staticContentPath}/css_xhtml/styles.css'
includeParams='none' encode='false' />" type="text/css" />
+<@s.link rel="stylesheet"
href="${base}${parameters.staticContentPath}/css_xhtml/styles.css"
type="text/css" />
<#include "/${parameters.templateDir}/simple/head.ftl"
/></code></pre></figure>
<p>The head includes a style sheet. The contents of
<strong>styles.css</strong> are:</p>
diff --git a/content/tag-developers/simple-theme.html
b/content/tag-developers/simple-theme.html
index 0209c1e4a..f04b608ac 100644
--- a/content/tag-developers/simple-theme.html
+++ b/content/tag-developers/simple-theme.html
@@ -181,7 +181,7 @@ Ajax/Dojo support so that tags can import Dojo widgets
easily.</p>
* under the License.
*/
-->
-<script src="${base}${parameters.staticContentPath}/utils.js"
type="text/javascript" <#include
"/${parameters.templateDir}/simple/nonce.ftl" />
></script></code></pre></figure>
+<@s.script src="${base}${parameters.staticContentPath}/utils.js"
type="text/javascript" /></code></pre></figure>
</section>
diff --git a/content/tag-developers/xhtml-theme.html
b/content/tag-developers/xhtml-theme.html
index ed3518b28..c78bacb21 100644
--- a/content/tag-developers/xhtml-theme.html
+++ b/content/tag-developers/xhtml-theme.html
@@ -392,7 +392,7 @@ render the form elements.</p>
* under the License.
*/
-->
-<link rel="stylesheet" href="<@s.url
value='${parameters.staticContentPath}/xhtml/styles.css' includeParams='none'
encode='false'/>" type="text/css" <#include
"/${parameters.templateDir}/simple/nonce.ftl" /> />
+<@s.link rel="stylesheet"
href="${base}${parameters.staticContentPath}/xhtml/styles.css" type="text/css"
/>
<#include "/${parameters.templateDir}/simple/head.ftl"
/></code></pre></figure>
<p>The head template imports a style sheet. The contents of
<strong>styles.css</strong> are:</p>
@@ -506,14 +506,14 @@ wrapping table, the opening and closing templates also,
if the <code class="lang
<#include "/${parameters.templateDir}/simple/form-close.ftl" />
<#include
"/${parameters.templateDir}/${parameters.expandTheme}/form-close-validate.ftl"
/>
<#if parameters.focusElement??>
-<script type="text/javascript" <#include
"/${parameters.templateDir}/simple/nonce.ftl" /> >
+<@s.script type="text/javascript">
StrutsUtils.addOnLoad(function() {
var element =
document.getElementById("${parameters.focusElement?js_string}");
if(element) {
element.focus();
}
});
-</script>
+</@s.script>
</#if></code></pre></figure>
<h3 id="xhtml-form-template">xhtml form template</h3>
@@ -582,14 +582,14 @@ to <code class="language-plaintext
highlighter-rouge">true</code>, enable <a hre
<#include "/${parameters.templateDir}/simple/form-close.ftl" />
<#include
"/${parameters.templateDir}/${parameters.expandTheme}/form-close-validate.ftl"
/>
<#if parameters.focusElement??>
-<script type="text/javascript" <#include
"/${parameters.templateDir}/simple/nonce.ftl" /> >
+<@s.script type="text/javascript">
StrutsUtils.addOnLoad(function() {
var element =
document.getElementById("${parameters.focusElement?js_string}");
if(element) {
element.focus();
}
});
-</script>
+</@s.script>
</#if></code></pre></figure>
![https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"](https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"){kind=link}