This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 3c62abca1 Automatic Site Publish by Buildbot
3c62abca1 is described below
commit 3c62abca161954e2c0cf1d4d97353202904ae00d
Author: buildbot <[email protected]>
AuthorDate: Sat Feb 3 16:43:51 2024 +0000
Automatic Site Publish by Buildbot
---
output/plugins/tiles/index.html | 120 ++++++++---------
output/plugins/tiles/tiles-use.html | 257 ------------------------------------
2 files changed, 56 insertions(+), 321 deletions(-)
diff --git a/output/plugins/tiles/index.html b/output/plugins/tiles/index.html
index 0b3f05e38..83f1258db 100644
--- a/output/plugins/tiles/index.html
+++ b/output/plugins/tiles/index.html
@@ -164,8 +164,8 @@
<li><a href="#installation"
id="markdown-toc-installation">Installation</a></li>
</ul>
-<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.</p>
+<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.</p>
<p>The Tiles plugin allows actions to return Tiles pages.</p>
@@ -181,101 +181,93 @@ be used for both page decorating and
componentization.</p>
<p>The following steps must be taken in order to enable tiles support within
your Struts2 application:</p>
<ol>
- <li>Include the struts-tiles-plugin as a dependency in your web application.
If you are using maven2, the dependency configuration will
- be similar to:</li>
-</ol>
+ <li>
+ <p>Include the struts-tiles-plugin as a dependency in your web
application. If you are using maven2, the dependency
+configuration will be similar to:</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><dependency></span>
+ <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<span
class="nt"></groupId></span>
<span class="nt"><artifactId></span>struts2-tiles-plugin<span
class="nt"></artifactId></span>
<span class="nt"><version></span>${version.tiles}<span
class="nt"></version></span>
<span class="nt"></dependency></span>
+</code></pre></div> </div>
+ </li>
+ <li>
+ <p>Register the Tiles listener. This listener will typically either be the
standard tiles listener <code class="language-plaintext
highlighter-rouge">org.apache.tiles.listener.TilesListener</code>
+or the Struts2 replacement <code class="language-plaintext
highlighter-rouge">org.apache.struts2.tiles.TilesListener</code>. The latter
provides tighter integration with
+Struts features such as freemarker integration.</p>
-</code></pre></div></div>
-
-<ol>
- <li>Register the tiles listener. This listener will typically either be the
standard tiles listener <code class="language-plaintext
highlighter-rouge">org.apache.tiles.listener.TilesListener</code>
- or the Struts2 replacement <code class="language-plaintext
highlighter-rouge">org.apache.struts2.tiles.TilesListener</code>. The latter
provides tighter integration with Struts features such
- as freemarker integration.</li>
-</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><listener></span>
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><listener></span>
<span
class="nt"><listener-class></span>org.apache.struts2.tiles.StrutsTilesListener<span
class="nt"></listener-class></span>
<span class="nt"></listener></span>
+</code></pre></div> </div>
+ </li>
+ <li>
+ <p>All package definitions, which require tiles support, must either
extend the <code class="language-plaintext
highlighter-rouge">tiles-default</code> package or must register
+the <strong>Tiles Result</strong> type definition.</p>
-</code></pre></div></div>
-
-<ol>
- <li>All package definitions which require tiles support must either extend
the <code class="language-plaintext highlighter-rouge">tiles-default</code>
package or must register
- the [Tiles Result] type definition.</li>
-</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><result-types></span>
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><result-types></span>
<span class="nt"><result-type</span> <span class="na">name=</span><span
class="s">"tiles"</span> <span class="na">class=</span><span
class="s">"org.apache.struts2.views.tiles.TilesResult"</span><span
class="nt">/></span>
<span class="nt"></result-types></span>
+</code></pre></div> </div>
+ </li>
+ <li>
+ <p>Configure your actions to utilize a tiles definition:</p>
-</code></pre></div></div>
-
-<ol>
- <li>Configure your actions to utilize a tiles definition:</li>
-</ol>
-
-<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">"sample"</span> <span
class="na">class=</span><span
class="s">"org.apache.struts2.tiles.example.SampleAction"</span> <span
class="nt">></span>
+ <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">"sample"</span> <span
class="na">class=</span><span
class="s">"org.apache.struts2.tiles.example.SampleAction"</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">"tiles"</span><span class="nt">></span>tilesWorks<span
class="nt"></result></span>
<span class="nt"></action></span>
+</code></pre></div> </div>
+ </li>
+ <li>
+ <p>Instead of xml configuration you can use annotations</p>
-</code></pre></div></div>
-
-<ol>
- <li>Instead of xml configuration you can use annotations</li>
-</ol>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Result</span><span
class="o">(</span><span class="n">name</span> <span class="o">=</span> <span
class="s">"success"</span><span class="o">,</span> <span
class="n">type</span><span class="o">=</span><span
class="s">"tiles"</span><span class="o">)</span>
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Result</span><span
class="o">(</span><span class="n">name</span> <span class="o">=</span> <span
class="s">"success"</span><span class="o">,</span> <span
class="n">type</span><span class="o">=</span><span
class="s">"tiles"</span><span class="o">)</span>
<span class="nd">@TilesDefinition</span><span class="o">(</span><span
class="n">extend</span> <span class="o">=</span> <span
class="s">"fooLayout"</span><span class="o">,</span> <span
class="n">putAttributes</span> <span class="o">=</span> <span class="o">{</span>
<span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"header"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span
class="s">"/WEB-INF/tiles/header.jsp"</span><span class="o">),</span>
<span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"body"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span class="s">"/WEB-INF/tiles/body.ftl"</span><span
class="o">)</span>
<span class="o">})</span>
<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">FooAction</span> <span class="kd">extends</span> <span
class="nc">ActionSupport</span> <span class="o">{</span>
-</code></pre></div></div>
-
-<ol>
- <li>You have to define Tiles Definitons in a <code class="language-plaintext
highlighter-rouge">tiles.xml</code> file. That can be placed in <code
class="language-plaintext highlighter-rouge">resources</code> or in <code
class="language-plaintext highlighter-rouge">WEB-INF</code>.</li>
-</ol>
+</code></pre></div> </div>
+ </li>
+ <li>
+ <p>You have to define Tiles Definitions in a <code
class="language-plaintext highlighter-rouge">tiles.xml</code> file. That can be
placed in <code class="language-plaintext highlighter-rouge">resources</code>
or in <code class="language-plaintext highlighter-rouge">WEB-INF</code>.</p>
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="cp"><!DOCTYPE tiles-definitions PUBLIC
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="cp"><!DOCTYPE tiles-definitions PUBLIC
"-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
"http://tiles.apache.org/dtds/tiles-config_3_0.dtd"></span>
-
<span class="nt"><tiles-definitions></span>
-
+
<span class="nt"><definition</span> <span class="na">name=</span><span
class="s">"fooLayout"</span> <span class="na">template=</span><span
class="s">"/WEB-INF/tiles/layout.jsp"</span><span class="nt">></span>
<span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"title"</span> <span
class="na">value=</span><span class="s">"Tiles Sample"</span><span
class="nt">/></span>
<span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"header"</span> <span
class="na">value=</span><span class="s">".header"</span><span
class="nt">/></span>
<span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"body"</span> <span
class="na">value=</span><span class="s">".bodyp"</span><span
class="nt">/></span>
<span class="nt"></definition></span>
-
+
<span class="nt"><definition</span> <span class="na">name=</span><span
class="s">"tilesWorks"</span> <span class="na">extends=</span><span
class="s">"fooLayout"</span><span class="nt">></span>
<span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"header"</span> <span
class="na">value=</span><span class="s">"/WEB-INF/tiles/header.jsp"</span><span
class="nt">/></span>
<span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"body"</span> <span
class="na">value=</span><span class="s">"/WEB-INF/tiles/body.jsp"</span><span
class="nt">/></span>
<span class="nt"></definition></span>
-
+
<span class="nt"></tiles-definitions></span>
-</code></pre></div></div>
+</code></pre></div> </div>
+ </li>
+</ol>
-<p>As from Struts 2.3.28, the plugin automatically loads all Tiles definitions
matching the following pattern <code class="language-plaintext
highlighter-rouge">tiles*.xml</code> - you don’t have
-to specify them via <code class="language-plaintext
highlighter-rouge">org.apache.tiles.definition.DefinitionsFactory.DEFINITIONS_CONFIG</code>
in <code class="language-plaintext highlighter-rouge">web.xml</code>, but you
can use this option if your
-application is going to work in restricted servlet environment e.g. Google
AppEngine. In such case, definitions will be read from
-the provided init-param.</p>
+<p>As from Struts 2.3.28, the plugin automatically loads all Tiles definitions
matching the following pattern <code class="language-plaintext
highlighter-rouge">tiles*.xml</code> -
+you don’t have to specify them via <code class="language-plaintext
highlighter-rouge">org.apache.tiles.definition.DefinitionsFactory.DEFINITIONS_CONFIG</code>
in <code class="language-plaintext highlighter-rouge">web.xml</code>,
+but you can use this option if your application is going to work in restricted
servlet environment e.g., Google AppEngine.
+In such case, definitions will be read from the provided init-param.</p>
<blockquote>
- <p>Note: When using a Tomcat WAR versoning mechanism which uses <code
class="language-plaintext highlighter-rouge">##</code> you must specify all the
tiles definition directly using
-the <code class="language-plaintext highlighter-rouge">init-param</code>, in
other case it won’t be loaded. It’s due to limitation of <code
class="language-plaintext highlighter-rouge">URL</code> class.</p>
+ <p>Note: When using a Tomcat WAR versoning mechanism which uses <code
class="language-plaintext highlighter-rouge">##</code> you must specify all the
tiles definition directly
+using the <code class="language-plaintext
highlighter-rouge">init-param</code>, in other case it won’t be loaded. It’s
due to limitation of <code class="language-plaintext
highlighter-rouge">URL</code> class.</p>
</blockquote>
<h3 id="accessing-struts-attributes">Accessing Struts attributes</h3>
-<p>As from Struts version 2.5.3 it’s possible accessing defined values on a
<code class="language-plaintext highlighter-rouge">ValueStack</code> using
<code class="language-plaintext highlighter-rouge">S2</code> prefix when
defining an expression
-in tiles definition, e.g.:</p>
+<p>As from Struts version 2.5.3 it’s possible accessing defined values on a
<code class="language-plaintext highlighter-rouge">ValueStack</code> using
<code class="language-plaintext highlighter-rouge">S2</code> prefix when
defining
+an expression in tiles definition, e.g.:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><definition</span> <span
class="na">name=</span><span class="s">"home"</span> <span
class="na">extends=</span><span class="s">"logged-in"</span><span
class="nt">></span>
<span class="nt"><put-attribute</span> <span class="na">name=</span><span
class="s">"title"</span> <span class="na">expression=</span><span
class="s">"S2:actionProperty"</span><span class="nt">/></span>
@@ -283,12 +275,12 @@ in tiles definition, e.g.:</p>
<span class="nt"></definition></span>
</code></pre></div></div>
-<p>In such case Tiles will delegate evaluation of the expression to Struts and
<code class="language-plaintext highlighter-rouge">ValueStack</code> will be
examined to evaluate the expression.</p>
+<p>In such case Tiles will delegate evaluation of the expression to Struts and
<code class="language-plaintext highlighter-rouge">ValueStack</code> will be
examined.</p>
<h3 id="i18n">I18N</h3>
-<p>Instead of defining new tiles definitions per supported language (i.e.:
<code class="language-plaintext highlighter-rouge">tiles.xml</code>, <code
class="language-plaintext highlighter-rouge">tiles_de.xml</code>, <code
class="language-plaintext highlighter-rouge">tiles_pl.xml</code>) you can use
<code class="language-plaintext highlighter-rouge">I18N</code>
-prefix to evaluate provided expression as a key in Struts resource bundles.
</p>
+<p>Instead of defining new tiles definitions per supported language (i.e.:
<code class="language-plaintext highlighter-rouge">tiles.xml</code>, <code
class="language-plaintext highlighter-rouge">tiles_de.xml</code>, <code
class="language-plaintext highlighter-rouge">tiles_pl.xml</code>)
+you can use <code class="language-plaintext highlighter-rouge">I18N</code>
prefix to evaluate provided expression as a key in Struts resource bundles.</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><definition</span> <span
class="na">name=</span><span class="s">"home"</span> <span
class="na">extends=</span><span class="s">"logged-in"</span><span
class="nt">></span>
<span class="nt"><put-attribute</span> <span class="na">name=</span><span
class="s">"title"</span> <span class="na">expression=</span><span
class="s">"I18N:home.title"</span><span class="nt">/></span>
@@ -310,21 +302,21 @@ prefix to evaluate provided expression as a key in Struts
resource bundles. </p
<span class="nt"><body></span>
<span class="nt"><tiles:insertAttribute </span><span
class="na">name=</span><span class="s">"header"</span><span
class="nt">/></span>
<span class="nt"><tiles:insertAttribute </span><span
class="na">name=</span><span class="s">"body"</span><span
class="nt">/></span>
- <span class="nt"><p></span>Notice that this is a layout made in
JSP<span class="nt"></p></span>
+ <span class="nt"><p></span>Notice that this is a layout made in
JSP<span class="nt"></p></span>
<span class="nt"></body></span>
<span class="nt"></html></span>
-
</code></pre></div></div>
-<p>Please check <a
href="https://github.com/apache/struts-examples/tree/master/tiles";>tiles</a>
example in <a
href="https://github.com/apache/struts-examples/tree/master/tiles";>struts-examples</a>
project.</p>
+<p>Please check <a
href="https://github.com/apache/struts-examples/tree/master/tiles";>tiles</a>
example in <a
href="https://github.com/apache/struts-examples/tree/master/tiles";>struts-examples</a>
project.</p>
<h2 id="settings">Settings</h2>
-<p>This plugin does inherits settings from <a
href="https://tiles.apache.org/framework/config-reference.html";>Tiles
configuration</a>.</p>
+<p>This plugin does inherit settings from <a
href="https://tiles.apache.org/framework/config-reference.html";>Tiles
configuration</a>.</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>
+<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>
</section>
</article>
diff --git a/output/plugins/tiles/tiles-use.html
b/output/plugins/tiles/tiles-use.html
deleted file mode 100644
index 96ff74aa7..000000000
--- a/output/plugins/tiles/tiles-use.html
+++ /dev/null
@@ -1,257 +0,0 @@
-<!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>Tiles Use</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>
-
- <!-- Matomo -->
- <script>
- var _paq = window._paq = window._paq || [];
- /* tracker methods like "setCustomDimension" should be called before
"trackPageView" */
- /* We explicitly disable cookie tracking to avoid privacy issues */
- _paq.push(['disableCookies']);
- _paq.push(['trackPageView']);
- _paq.push(['enableLinkTracking']);
- (function() {
- var u="//analytics.apache.org/";
- _paq.push(['setTrackerUrl', u+'matomo.php']);
- _paq.push(['setSiteId', '41']);
- var d=document, g=d.createElement('script'),
s=d.getElementsByTagName('script')[0];
- g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
- })();
- </script>
- <!-- End Matomo Code -->
-</head>
-<body>
-
-<a href="https://github.com/apache/struts"; class="github-ribbon">
- <img decoding="async" loading="lazy" style="position: absolute; right: 0;
border: 0;" width="149" height="149"
src="https://github.blog/wp-content/uploads/2008/12/forkme_right_red_aa0000.png?resize=149%2C149";
class="attachment-full size-full" alt="Fork me on GitHub" data-recalc-dims="1">
-</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-2023.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><a href="/commercial-support.html">Commercial
Support</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/tiles/tiles-use.md";
title="Edit this page on GitHub">Edit on GitHub</a>
-
- <a href="../" title="back to Plugins"><< back to Plugins</a>
-
- <h1 id="tiles-use">Tiles Use</h1>
-
-<p>Tiles uses a definition file (XML document) that must be instantiated
before use. One way to render the definition file would be to use Spring.
Another way would be to use a separate Listener, as shown by
Tilesconfigurer.</p>
-
-<p><strong>TilesConfigurer.java</strong></p>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
-<span class="kn">package</span> <span
class="nn">com.opensymphony.webwork.views.tiles</span><span class="o">;</span>
-
-<span class="kn">import</span> <span
class="nn">javax.servlet.ServletContextEvent</span><span class="o">;</span>
-<span class="kn">import</span> <span
class="nn">javax.servlet.ServletContextListener</span><span class="o">;</span>
-
-<span class="kn">import</span> <span
class="nn">org.apache.struts.tiles.DefinitionsFactoryConfig</span><span
class="o">;</span>
-<span class="kn">import</span> <span
class="nn">org.apache.struts.tiles.DefinitionsFactoryException</span><span
class="o">;</span>
-<span class="kn">import</span> <span
class="nn">org.apache.struts.tiles.TilesUtil</span><span class="o">;</span>
-<span class="kn">import</span> <span
class="nn">org.apache.struts.tiles.xmlDefinition.I18nFactorySet</span><span
class="o">;</span>
-
-<span class="cm">/*
-* Modified from Spring's source
-*
-* here's how a smaple web xml should look like:
-* <web-app>
-* <context-param>
-* <param-name>tilesDefinitions</param-name>
-* <param-value>/WEB-INF/tiles.xml</param-value>
-* </context-param>
-*
-* <listener>
-*
<listener-class>com.opensymphony.webwork.views.tiles.TilesConfigurer</listener-class>
-* </listener>
-* </web-app>
-*
-* To use the definitions specified you would use a dispatcher result (since
-* tiles jsp is just another jsp) to render tiles view.
-*/</span>
-<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">TilesConfigurer</span> <span class="kd">implements</span> <span
class="nc">ServletContextListener</span> <span class="o">{</span>
-
- <span class="kd">private</span> <span class="kt">boolean</span> <span
class="n">initialized</span> <span class="o">=</span> <span
class="kc">false</span><span class="o">;</span>
-
- <span class="kd">public</span> <span class="kt">void</span> <span
class="nf">contextInitialized</span> <span class="o">(</span><span
class="nc">ServletContextEvent</span> <span class="n">evt</span><span
class="o">)</span> <span class="o">{</span>
-
- <span class="k">if</span> <span class="o">(!</span><span
class="n">initialized</span><span class="o">)</span> <span class="o">{</span>
- <span class="nc">DefinitionsFactoryConfig</span> <span
class="n">factoryConfig</span> <span class="o">=</span> <span
class="k">new</span> <span class="nc">DefinitionsFactoryConfig</span><span
class="o">();</span>
- <span class="n">factoryConfig</span><span class="o">.</span><span
class="na">setFactoryClassname</span><span class="o">(</span><span
class="nc">I18nFactorySet</span><span class="o">.</span><span
class="na">class</span><span class="o">.</span><span
class="na">getName</span><span class="o">());</span>
- <span class="n">factoryConfig</span><span class="o">.</span><span
class="na">setParserValidate</span><span class="o">(</span><span
class="kc">true</span><span class="o">);</span>
- <span class="n">factoryConfig</span><span class="o">.</span><span
class="na">setDefinitionConfigFiles</span><span class="o">(</span><span
class="n">evt</span><span class="o">.</span><span
class="na">getServletContext</span><span class="o">().</span><span
class="na">getInitParameter</span><span class="o">(</span><span
class="s">"tilesDefinitions"</span><span class="o">));</span>
- <span class="k">try</span> <span class="o">{</span>
- <span class="nc">TilesUtil</span><span class="o">.</span><span
class="na">createDefinitionsFactory</span><span class="o">(</span><span
class="n">evt</span><span class="o">.</span><span
class="na">getServletContext</span><span class="o">(),</span> <span
class="n">factoryConfig</span><span class="o">);</span>
- <span class="o">}</span> <span class="k">catch</span> <span
class="o">(</span><span class="nc">DefinitionsFactoryException</span> <span
class="n">e</span><span class="o">)</span> <span class="o">{</span>
- <span class="n">e</span><span class="o">.</span><span
class="na">printStackTrace</span><span class="o">();</span>
- <span class="o">}</span>
- <span class="n">initialized</span> <span class="o">=</span> <span
class="kc">true</span><span class="o">;</span>
- <span class="o">}</span>
-
- <span class="o">}</span>
-
- <span class="kd">public</span> <span class="kt">void</span> <span
class="nf">contextDestroyed</span> <span class="o">(</span><span
class="nc">ServletContextEvent</span> <span class="n">evt</span><span
class="o">)</span> <span class="o">{</span>
- <span class="o">}</span>
-
-<span class="o">}</span>
-
-</code></pre></div></div>
-
-<blockquote>
- <p>The TilesConfigurer was adapted from the Spring source code.</p>
-</blockquote>
-
- </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>
![https://github.blog/wp-content/uploads/2008/12/forkme_right_red_aa0000.png?resize=149%2C149"](https://github.blog/wp-content/uploads/2008/12/forkme_right_red_aa0000.png?resize=149%2C149"){kind=link}