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 7da06c7 Updates production by Jenkins
7da06c7 is described below
commit 7da06c76b8a36a496d45cc6a451deef3ed3b23e8
Author: jenkins <bui...@apache.org>
AuthorDate: Thu Oct 5 08:20:43 2017 +0000
Updates production by Jenkins
---
content/core-developers/result-types.html | 4 +-
content/getting-started/index.html | 4 +
.../getting-started/jasper-reports-tutorial.html | 512 +++++++++++++++++++++
3 files changed, 518 insertions(+), 2 deletions(-)
diff --git a/content/core-developers/result-types.html
b/content/core-developers/result-types.html
index c76c400..ef3aa90 100644
--- a/content/core-developers/result-types.html
+++ b/content/core-developers/result-types.html
@@ -204,8 +204,8 @@ own applications.</p>
<table>
<tbody>
<tr>
- <td>[JasperReports Plugin]</td>
- <td>Used for <a href="../plugins/jasperreports/">JasperReports
Tutorial</a> integration</td>
+ <td><a href="../plugins/jasperreports/">JasperReports Plugin</a></td>
+ <td>Used for <a
href="../getting-started/jasper-reports-tutorial.html">JasperReports
Tutorial</a> integration</td>
<td>Optional, third-party plugin</td>
</tr>
</tbody>
diff --git a/content/getting-started/index.html
b/content/getting-started/index.html
index 78198fc..057f0d7 100644
--- a/content/getting-started/index.html
+++ b/content/getting-started/index.html
@@ -188,6 +188,10 @@ post a question on the mailing list.</p>
<p><a href="exclude-parameters.html">Exclude Parameters</a></p>
+<h2 id="extra-tutorials">Extra tutorials</h2>
+
+<p><a href="jasper-reports-tutorial.html">JasperReports Tutorial</a></p>
+
</section>
</article>
diff --git a/content/getting-started/jasper-reports-tutorial.html
b/content/getting-started/jasper-reports-tutorial.html
new file mode 100644
index 0000000..f805e5f
--- /dev/null
+++ b/content/getting-started/jasper-reports-tutorial.html
@@ -0,0 +1,512 @@
+<!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>Getting started</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="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.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="/downloads.html">Downloads</a></li>
+ <li><a href="/announce.html">Announcements</a></li>
+ <li><a href="http://www.apache.org/licenses/";>License</a></li>
+ <li><a
href="http://apache.org/foundation/thanks.html";>Thanks!</a></li>
+ <li><a
href="http://apache.org/foundation/sponsorship.html";>Sponsorship</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="/maven/project-info.html">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 class="divider"></li>
+ <li><a href="/maven/struts2-core/apidocs/index.html">Struts
Core API</a></li>
+ <li><a href="/docs/plugins.html">Plugin APIs</a></li>
+ <li><a href="/docs/tag-reference.html">Tag reference</a></li>
+ <li><a
href="http://cwiki.apache.org/S2PLUGINS/home.html";>Plugin registry</a></li>
+ <li class="divider"></li>
+ <li><a href="/docs/tutorials.html">Tutorials -
DEPRECATED</a></li>
+ <li><a href="/docs/faqs.html">FAQs - DEPRECATED</a></li>
+ <li><a href="/docs/guides.html">Guides - DEPRECATED</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</a></li>
+ <li><a href="/coding-standards.html">Coding standards</a></li>
+ <li class="divider"></li>
+ <li><a href="/releases.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://git-wip-us.apache.org/repos/asf?p=struts.git";>Source
Repository</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/getting-started/jasper-reports-tutorial.md";
title="Edit this page on GitHub">Edit on GitHub</a>
+
+ <a href="index.html" title="back to Getting started"><< back to Getting
started</a>
+
+ <h1 id="jasperreports-tutorial">JasperReports Tutorial</h1>
+
+<p>The Struts 2 JasperReports plugin is a bridge from Struts 2 to
JasperReports and does not include JasperReports itself,
+which must be downloaded separately.</p>
+
+<p><a href="http://jasperreports.sourceforge.net";>JasperReports</a> is one of
the leading open-source Java reporting libraries.
+It compiles <code class="highlighter-rouge">.jrxml</code> (XML source) to
<code class="highlighter-rouge">.jasper</code> (compiled) files, which in turn
can be transformed into several output
+types including PDF, HTML, CSV, and XLS.</p>
+
+<p>In the following example, we will use the framework to create a PDF with a
list of persons. Our action will be used
+to create a List with <code class="highlighter-rouge">Person</code> objects,
and our JasperReports Result will use this list to fill our template, and
return
+the PDF.</p>
+
+<h2 id="our-person-class">Our Person class</h2>
+
+<p>We start by defining a simple <code class="highlighter-rouge">Person</code>
POJO class.</p>
+
+<p><strong>com.acme.test.Person.java</strong></p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kn">package</span> <span class="n">com</span><span
class="o">.</span><span class="na">acme</span><span class="o">.</span><span
class="na">test</span><span class="o">;</span>
+
+<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">Person</span> <span class="o">{</span>
+
+ <span class="kd">private</span> <span class="n">Long</span> <span
class="n">id</span><span class="o">;</span>
+
+ <span class="kd">private</span> <span class="n">String</span> <span
class="n">name</span><span class="o">;</span>
+
+ <span class="kd">private</span> <span class="n">String</span> <span
class="n">lastName</span><span class="o">;</span>
+
+ <span class="kd">public</span> <span class="n">Person</span><span
class="o">()</span> <span class="o">{</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">Person</span><span
class="o">(</span><span class="n">String</span> <span
class="n">name</span><span class="o">,</span> <span class="n">String</span>
<span class="n">lastName</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">name</span> <span class="o">=</span> <span
class="n">name</span><span class="o">;</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">lastName</span> <span class="o">=</span> <span
class="n">lastName</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">Person</span><span
class="o">(</span><span class="n">Long</span> <span class="n">id</span><span
class="o">,</span> <span class="n">String</span> <span
class="n">name</span><span class="o">,</span> <span class="n">String</span>
<span class="n">lastName</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">id</span> <span class="o">=</span> <span class="n">id</span><span
class="o">;</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">name</span> <span class="o">=</span> <span
class="n">name</span><span class="o">;</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">lastName</span> <span class="o">=</span> <span
class="n">lastName</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">Long</span> <span
class="n">getId</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">id</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setId</span><span class="o">(</span><span class="n">Long</span> <span
class="n">id</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">id</span> <span class="o">=</span> <span class="n">id</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">getLastName</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">lastName</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setLastName</span><span class="o">(</span><span
class="n">String</span> <span class="n">lastName</span><span class="o">)</span>
<span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">lastName</span> <span class="o">=</span> <span
class="n">lastName</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">getName</span><span class="o">()</span> <span class="o">{</span>
+ <span class="k">return</span> <span class="n">name</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="kt">void</span> <span
class="n">setName</span><span class="o">(</span><span class="n">String</span>
<span class="n">name</span><span class="o">)</span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">name</span> <span class="o">=</span> <span
class="n">name</span><span class="o">;</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre>
+</div>
+
+<h2 id="jasperreports-libraries">JasperReports libraries</h2>
+
+<p>Before we can continue, we need to add the JR libraries to our classpath.
You can download the JR project here:
+<a
href="http://www.sourceforge.net/projects/jasperreports";>http://www.sourceforge.net/projects/jasperreports</a></p>
+
+<p>Save the <code class="highlighter-rouge">jasperreports-X-project.zip</code>
to your harddisk, and extract the files.</p>
+
+<p>We need the following files:</p>
+
+<ul>
+ <li>dist/jasperreports-X.jar</li>
+ <li>lib/commons-*.jar (all the commons - except maybe for
commons-logging)</li>
+ <li>lib/itext-X.jar</li>
+ <li>lib/jdt-compiler.jar</li>
+</ul>
+
+<p>Copy these jars over to your <code
class="highlighter-rouge">S2_WABAPP/WEB-INF/lib</code> directory, and add them
to your classpath.</p>
+
+<h1 id="creating-the-action">Creating the Action</h1>
+
+<p><strong>com.acme.test.action.JasperAction</strong></p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="kn">package</span> <span class="n">com</span><span
class="o">.</span><span class="na">acme</span><span class="o">.</span><span
class="na">test</span><span class="o">.</span><span
class="na">action</span><span class="o">;</span>
+
+<span class="kn">import</span> <span
class="nn">java.util.ArrayList</span><span class="o">;</span>
+<span class="kn">import</span> <span class="nn">java.util.List</span><span
class="o">;</span>
+
+<span class="kn">import</span> <span
class="nn">net.sf.jasperreports.engine.JasperCompileManager</span><span
class="o">;</span>
+
+<span class="kn">import</span> <span
class="nn">com.acme.test.Person</span><span class="o">;</span>
+<span class="kn">import</span> <span
class="nn">com.opensymphony.xwork.ActionSupport</span><span class="o">;</span>
+
+<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">JasperAction</span> <span class="kd">extends</span> <span
class="n">ActionSupport</span> <span class="o">{</span>
+
+ <span class="cm">/** List to use as our JasperReports dataSource. */</span>
+ <span class="kd">private</span> <span class="n">List</span><span
class="o"><</span><span class="n">Person</span><span class="o">></span>
<span class="n">myList</span><span class="o">;</span>
+
+ <span class="kd">public</span> <span class="n">String</span> <span
class="n">execute</span><span class="o">()</span> <span
class="kd">throws</span> <span class="n">Exception</span> <span
class="o">{</span>
+
+ <span class="c1">// Create some imaginary persons.</span>
+ <span class="n">Person</span> <span class="n">p1</span> <span
class="o">=</span> <span class="k">new</span> <span
class="n">Person</span><span class="o">(</span><span class="k">new</span> <span
class="n">Long</span><span class="o">(</span><span class="mi">1</span><span
class="o">),</span> <span class="s">"Patrick"</span><span class="o">,</span>
<span class="s">"Lightbuddie"</span><span class="o">);</span>
+ <span class="n">Person</span> <span class="n">p2</span> <span
class="o">=</span> <span class="k">new</span> <span
class="n">Person</span><span class="o">(</span><span class="k">new</span> <span
class="n">Long</span><span class="o">(</span><span class="mi">2</span><span
class="o">),</span> <span class="s">"Jason"</span><span class="o">,</span>
<span class="s">"Carrora"</span><span class="o">);</span>
+ <span class="n">Person</span> <span class="n">p3</span> <span
class="o">=</span> <span class="k">new</span> <span
class="n">Person</span><span class="o">(</span><span class="k">new</span> <span
class="n">Long</span><span class="o">(</span><span class="mi">3</span><span
class="o">),</span> <span class="s">"Alexandru"</span><span class="o">,</span>
<span class="s">"Papesco"</span><span class="o">);</span>
+ <span class="n">Person</span> <span class="n">p4</span> <span
class="o">=</span> <span class="k">new</span> <span
class="n">Person</span><span class="o">(</span><span class="k">new</span> <span
class="n">Long</span><span class="o">(</span><span class="mi">4</span><span
class="o">),</span> <span class="s">"Jay"</span><span class="o">,</span> <span
class="s">"Boss"</span><span class="o">);</span>
+
+ <span class="c1">// Store people in our dataSource list (normally they
would come from a database).</span>
+ <span class="n">myList</span> <span class="o">=</span> <span
class="k">new</span> <span class="n">ArrayList</span><span
class="o"><</span><span class="n">Person</span><span class="o">>();</span>
+ <span class="n">myList</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span><span class="n">p1</span><span
class="o">);</span>
+ <span class="n">myList</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span><span class="n">p2</span><span
class="o">);</span>
+ <span class="n">myList</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span><span class="n">p3</span><span
class="o">);</span>
+ <span class="n">myList</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span><span class="n">p4</span><span
class="o">);</span>
+
+ <span class="c1">// Normally we would provide a pre-compiled .jrxml
file</span>
+ <span class="c1">// or check to make sure we don't compile on every
request.</span>
+ <span class="k">try</span> <span class="o">{</span>
+ <span class="n">JasperCompileManager</span><span
class="o">.</span><span class="na">compileReportToFile</span><span
class="o">(</span>
+ <span
class="s">"S2_WEBAPP/jasper/our_jasper_template.jrxml"</span><span
class="o">,</span>
+ <span
class="s">"S2_WEBAPP/jasper/our_compiled_template.jasper"</span><span
class="o">);</span>
+ <span class="o">}</span> <span class="k">catch</span> <span
class="o">(</span><span class="n">Exception</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="k">return</span> <span class="n">ERROR</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="k">return</span> <span class="n">SUCCESS</span><span
class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="kd">public</span> <span class="n">List</span><span
class="o"><</span><span class="n">Person</span><span class="o">></span>
<span class="n">getMyList</span><span class="o">()</span> <span
class="o">{</span>
+ <span class="k">return</span> <span class="n">myList</span><span
class="o">;</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</code></pre>
+</div>
+
+<p>Our JasperAction creates a list of several People. The JasperCompileManager
compiles the jrxml template to a .jasper file.</p>
+
+<blockquote>
+ <p>Again, don’t use this in production code. You should of course either
provide compiled templates, or do some sort
+of checking to avoid compiling the template on every request. But for our
demonstration, or development, this suits
+our needs just fine.</p>
+</blockquote>
+
+<h1 id="our-jasper-template">Our Jasper template</h1>
+
+<p>JR uses XML configuration to define templates which are compiled to .jasper
files. These templates define the resulting
+report. This is a handwritten version - for more complex versions I seriously
suggest taking a look a the various GUI designers.</p>
+
+<p><strong>our_jasper_template.jrxml</strong></p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="cp"><?xml version="1.0"?></span>
+<span class="cp"><!DOCTYPE jasperReport PUBLIC "-//JasperReports//DTD
Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd"></span>
+<span class="nt"><jasperReport</span> <span class="na">name=</span><span
class="s">"jasper_test"</span><span class="nt">></span>
+ <span class="c"><!-- Our fields from the Person class. --></span>
+ <span class="nt"><field</span> <span class="na">name=</span><span
class="s">"name"</span> <span class="na">class=</span><span
class="s">"java.lang.String"</span><span class="nt">/></span>
+ <span class="nt"><field</span> <span class="na">name=</span><span
class="s">"lastName"</span> <span class="na">class=</span><span
class="s">"java.lang.String"</span><span class="nt">/></span>
+ <span class="nt"><title></span>
+ <span class="nt"><band</span> <span class="na">height=</span><span
class="s">"50"</span><span class="nt">></span>
+ <span class="nt"><staticText></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"0"</span> <span class="na">y=</span><span
class="s">"0"</span> <span class="na">width=</span><span class="s">"180"</span>
<span class="na">height=</span><span class="s">"15"</span><span
class="nt">/></span>
+ <span class="nt"><textElement/></span>
+ <span class="nt"><text></span><span
class="cp"><![CDATA[Struts 2 JasperReports Sample]]></span><span
class="nt"></text></span>
+ <span class="nt"></staticText></span>
+ <span class="nt"></band></span>
+ <span class="nt"></title></span>
+ <span class="nt"><pageHeader></span>
+ <span class="nt"><band/></span>
+ <span class="nt"></pageHeader></span>
+ <span class="nt"><columnHeader></span>
+ <span class="nt"><band</span> <span class="na">height=</span><span
class="s">"20"</span><span class="nt">></span>
+ <span class="nt"><staticText></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"180"</span> <span
class="na">y=</span><span class="s">"0"</span> <span
class="na">width=</span><span class="s">"180"</span> <span
class="na">height=</span><span class="s">"20"</span><span
class="nt">/></span>
+ <span class="nt"><textElement></span>
+ <span class="nt"><font</span> <span
class="na">isUnderline=</span><span class="s">"true"</span><span
class="nt">/></span>
+ <span class="nt"></textElement></span>
+ <span class="nt"><text></span><span
class="cp"><![CDATA[NAME]]></span><span class="nt"></text></span>
+ <span class="nt"></staticText></span>
+ <span class="nt"><staticText></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"360"</span> <span
class="na">y=</span><span class="s">"0"</span> <span
class="na">width=</span><span class="s">"180"</span> <span
class="na">height=</span><span class="s">"20"</span><span
class="nt">/></span>
+ <span class="nt"><textElement></span>
+ <span class="nt"><font</span> <span
class="na">isUnderline=</span><span class="s">"true"</span><span
class="nt">/></span>
+ <span class="nt"></textElement></span>
+ <span class="nt"><text></span><span
class="cp"><![CDATA[LASTNAME]]></span><span
class="nt"></text></span>
+ <span class="nt"></staticText></span>
+ <span class="nt"></band></span>
+ <span class="nt"></columnHeader></span>
+ <span class="nt"><detail></span>
+ <span class="nt"><band</span> <span class="na">height=</span><span
class="s">"20"</span><span class="nt">></span>
+ <span class="nt"><textField></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"180"</span> <span
class="na">y=</span><span class="s">"0"</span> <span
class="na">width=</span><span class="s">"180"</span> <span
class="na">height=</span><span class="s">"15"</span><span
class="nt">/></span>
+ <span class="nt"><textElement/></span>
+ <span class="nt"><textFieldExpression></span><span
class="cp"><![CDATA[$F{name}]]></span><span
class="nt"></textFieldExpression></span>
+ <span class="nt"></textField></span>
+ <span class="nt"><textField></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"360"</span> <span
class="na">y=</span><span class="s">"0"</span> <span
class="na">width=</span><span class="s">"180"</span> <span
class="na">height=</span><span class="s">"15"</span><span
class="nt">/></span>
+ <span class="nt"><textElement/></span>
+ <span class="nt"><textFieldExpression></span><span
class="cp"><![CDATA[$F{lastName}]]></span><span
class="nt"></textFieldExpression></span>
+ <span class="nt"></textField></span>
+ <span class="nt"></band></span>
+ <span class="nt"></detail></span>
+ <span class="nt"><columnFooter></span>
+ <span class="nt"><band/></span>
+ <span class="nt"></columnFooter></span>
+ <span class="nt"><pageFooter></span>
+ <span class="nt"><band</span> <span class="na">height=</span><span
class="s">"15"</span><span class="nt">></span>
+ <span class="nt"><staticText></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"0"</span> <span class="na">y=</span><span
class="s">"0"</span> <span class="na">width=</span><span class="s">"40"</span>
<span class="na">height=</span><span class="s">"15"</span><span
class="nt">/></span>
+ <span class="nt"><textElement/></span>
+ <span class="nt"><text></span><span
class="cp"><![CDATA[Page:]]></span><span class="nt"></text></span>
+ <span class="nt"></staticText></span>
+ <span class="nt"><textField></span>
+ <span class="nt"><reportElement</span> <span
class="na">x=</span><span class="s">"40"</span> <span class="na">y=</span><span
class="s">"0"</span> <span class="na">width=</span><span class="s">"100"</span>
<span class="na">height=</span><span class="s">"15"</span><span
class="nt">/></span>
+ <span class="nt"><textElement/></span>
+ <span class="nt"><textFieldExpression</span> <span
class="na">class=</span><span class="s">"java.lang.Integer"</span><span
class="nt">></span><span
class="cp"><![CDATA[$V{PAGE_NUMBER}]]></span><span
class="nt"></textFieldExpression></span>
+ <span class="nt"></textField></span>
+ <span class="nt"></band></span>
+ <span class="nt"></pageFooter></span>
+ <span class="nt"><summary></span>
+ <span class="nt"><band/></span>
+ <span class="nt"></summary></span>
+<span class="nt"></jasperReport></span>
+</code></pre>
+</div>
+
+<p>Save this file in <code class="highlighter-rouge">S2_WEBAPP/jasper/</code>
as <code class="highlighter-rouge">our_jasper_template.jrxml</code>.</p>
+
+<p>Most important: we declared the fields name and lastName (two properties
from our <code class="highlighter-rouge">Person</code> class). This means we
will
+now be able to use these fields in our Jasper template.</p>
+
+<p>We define two columnheaders (NAME and LASTNAME), and then add our fields to
the detail band (for a better explanation,
+look at the JR tutorial). This ‘detail’ band will iterate over our List of
People. This is the default behaviour of JR -
+so if you want to display more information from the Person, add them to this
band.</p>
+
+<p>In the detail band we use the <code
class="highlighter-rouge">$F{name}</code> expression. JasperReports will ask
Struts to retrieve the <code class="highlighter-rouge">name</code> field value
+from a <code class="highlighter-rouge">Person</code> object; the <code
class="highlighter-rouge">lastName</code> field is handled the same way.</p>
+
+<p>The rest is markup to define the layout.</p>
+
+<blockquote>
+ <p>Use a logger (commons-logging, log4j, …) to watch <code
class="highlighter-rouge">org.apache.struts2.views.jasperreports</code> in
debug mode,
+if you have any troubles.</p>
+</blockquote>
+
+<h2 id="registering-the-action">Registering the Action</h2>
+
+<p>Using the JasperReports plugin requires adding the JasperReports result
type as well as normal action configuration.</p>
+
+<p><strong>struts.xml</strong></p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><package</span> <span class="na">name=</span><span
class="s">"default"</span> <span class="na">namespace=</span><span
class="s">"/"</span> <span class="na">extends=</span><span
class="s">"jasperreports-default"</span><span class="nt">></span>
+ <span class="nt"><action</span> <span class="na">name=</span><span
class="s">"myJasperTest"</span> <span class="na">class=</span><span
class="s">"com.acme.test.action.JasperAction"</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">"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>/jasper/our_compiled_template.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>myList<span class="nt"></param></span>
+ <span class="nt"><param</span> <span
class="na">name=</span><span class="s">"format"</span><span
class="nt">></span>PDF<span class="nt"></param></span>
+ <span class="nt"></result></span>
+ <span class="nt"></action></span>
+ ...
+<span class="nt"></package></span>
+</code></pre>
+</div>
+
+<p>To use the JasperReports result type we must either (a) extend the <code
class="highlighter-rouge">jasperreports-default</code> package that defines it
+or (b) manually define the JasperReport <code
class="highlighter-rouge">jasper</code> result type ourselves.</p>
+
+<p>In the above example we extend the <code
class="highlighter-rouge">jasperreports-default</code> package; we can define
the <code class="highlighter-rouge">jasper</code> result type manually
+by defining it the same way the JasperReport plugin does:</p>
+
+<p><strong>Manually defining the “jasper” result type</strong></p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><result-types></span>
+ <span class="nt"><result-type</span> <span class="na">name=</span><span
class="s">"jasper"</span> <span class="na">class=</span><span
class="s">"org.apache.struts2.views.jasperreports.JasperReportsResult"</span><span
class="nt">/></span>
+<span class="nt"></result-types></span>
+</code></pre>
+</div>
+
+<p>We configure our JasperAction with the name <code
class="highlighter-rouge">myJasperTest</code> - this means that we can execute
this Action by sending
+a request to <code class="highlighter-rouge">myJasperTest.action</code> in our
browser.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><action</span> <span class="na">name=</span><span
class="s">"myJasperTest"</span> <span class="na">class=</span><span
class="s">"com.acme.test.action.JasperAction"</span><span class="nt">></span>
+</code></pre>
+</div>
+
+<p>When our JasperAction executes correctly, we will use the Result type
registered with the name <code class="highlighter-rouge">jasper</code>. As
discussed
+above the <code class="highlighter-rouge">jasper</code> result type is
available from either extending the <code
class="highlighter-rouge">jasperreports-default</code> package or by defining
+the result type manually.</p>
+
+<div class="highlighter-rouge"><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>
+</code></pre>
+</div>
+
+<p>The <code class="highlighter-rouge">location</code> parameter defines the
location of the compiled jasper file, which will be filled by Struts 2 with our
dataSource:</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><param</span> <span class="na">name=</span><span
class="s">"location"</span><span
class="nt">></span>/jasper/our_compiled_template.jasper<span
class="nt"></param></span>
+</code></pre>
+</div>
+
+<p>The <code class="highlighter-rouge">dataSource</code> parameter defines the
action property containing the collection of objects to use in our report.
+In this case it’s the <code class="highlighter-rouge">myList</code> property
which we manually filled with some <code
class="highlighter-rouge">Person</code> objects.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><param</span> <span class="na">name=</span><span
class="s">"dataSource"</span><span class="nt">></span>myList<span
class="nt"></param></span>
+</code></pre>
+</div>
+
+<p>The <code class="highlighter-rouge">format</code> parameter specifies the
output format of the report. Possible values include PDF, CSV, XLS and HTML.</p>
+
+<div class="highlighter-rouge"><pre class="highlight"><code><span
class="nt"><param</span> <span class="na">name=</span><span
class="s">"format"</span><span class="nt">></span>PDF<span
class="nt"></param></span>
+</code></pre>
+</div>
+
+<h2 id="conclusion">Conclusion</h2>
+
+<p>You should now be able to execute <a
href="http://localhost:8080/YOUR_WEBAPP/myJasperTest.action";>http://localhost:8080/YOUR_WEBAPP/myJasperTest.action</a>
+- and you should see a nice list of names.</p>
+
+<p>Struts provides probably the most elegant way to deal with JasperReport
files; specify the location of the .jasper file,
+specify what dataSource you want to use, and there you go.</p>
+
+ </section>
+</article>
+
+
+<footer class="container">
+ <div class="col-md-12">
+ Copyright © 2000-2016 <a href="http://www.apache.org/";>The Apache
Software Foundation </a>.
+ All Rights Reserved.
+ </div>
+ <div class="col-md-12">
+ Apache Struts, Struts, Apache, the Apache feather logo, and the Apache
Struts project logos are
+ trademarks of The Apache Software Foundation.
+ </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>
+
+
+<script>
+$(function() {
+ return $("h2, h3, h4, h5, h6").each(function(i, el) {
+ var $el, id;
+ $el = $(el);
+ id = $el.attr('id');
+ if (id) {
+ $el.removeAttr('id');
+ return $el.before($("<a />").addClass('anchor').attr('name', id));
+ }
+ });
+});
+</script>
+
+</body>
+</html>
--
To stop receiving notification emails like this one, please contact
['"commits@struts.apache.org" <commits@struts.apache.org>'].
![https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"](https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"){kind=link}