Child pages
  • JasperReports Tutorial
Skip to end of metadata
Go to start of metadata

The Struts 2 JasperReports plugin is a bridge from Struts 2 to JasperReports and does not include JasperReports itself, which must be downloaded separately.

JasperReports is one of the leading open-source Java reporting libraries. It compiles .jrxml (XML source) to .jasper (compiled) files, which in turn can be transformed into several output types including PDF, HTML, CSV, and XLS.

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 Person objects, and our JasperReports Result will use this list to fill our template, and return the PDF.

Our Person class

We start by defining a simple Person POJO class.

com.acme.test.Person.java

JasperReports libraries

Before we can continue, we need to add the JR libraries to our classpath. You can download the JR project here: http://www.sourceforge.net/projects/jasperreports
Save the jasperreports-X-project.zip to your harddisk, and extract the files.

We need the following files:

  • dist/jasperreports-X.jar
  • lib/commons-*.jar (all the commons - except maybe for commons-logging)
  • lib/itext-X.jar
  • lib/jdt-compiler.jar

Copy these jars over to your S2_WEBAPP/WEB-INF/lib directory, and add them to your classpath.

Creating the Action

com.acme.test.action.JasperAction

Our JasperAction creates a list of several People. The JasperCompileManager compiles the jrxml template to a .jasper file.

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.

Our Jasper template

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.

our_jasper_template.jrxml

Save this file in S2_WEBAPP/jasper/ as 'our_jasper_template.jrxml'.

Most important: we declared the fields name and lastName (two properties from our Person class). This means we will now be able to use these fields in our Jasper template.

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.

In the detail band we use the

expression. JasperReports will ask Struts to retrieve the name field value from a Person object; the lastName field is handled the same way.

The rest is markup to define the layout.

Use a logger (commons-logging, log4j, ...) to watch org.apache.struts2.views.jasperreports in debug mode, if you have any troubles.

Registering the Action

Using the JasperReports plugin requires adding the JasperReports result type as well as normal action configuration.

struts.xml

To use the JasperReports result type we must either (a) extend the jasperreports-default package that defines it or (b) manually define the JasperReport jasper result type ourselves.

In the above example we extend the jasperreports-default package; we can define the jasper result type manually by defining it the same way the JasperReport plugin does:

Manually defining the "jasper" result type

We configure our JasperAction with the name 'myJasperTest' - this means that we can execute this Action by sending a request to myJasperTest.action in our browser.

When our JasperAction executes correctly, we will use the Result type registered with the name 'jasper'. As discussed above the "jasper" result type is available from either extending the "jasperreports-default" package or by defining the result type manually.

The "location" parameter defines the location of the compiled jasper file, which will be filled by Struts 2 with our dataSource:

The "dataSource" parameter defines the action property containing the collection of objects to use in our report. In this case it's the myList property which we manually filled with some Person objects.

The "format" parameter specifies the output format of the report. Possible values include PDF, CSV, XLS and HTML.

Conclusion

You should now be able to execute http://localhost:8080/YOUR_WEBAPP/myJasperTest.action - and you should see a nice list of names.
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.

Back to Tutorials

  • No labels

2 Comments

  1. Anonymous

    I gone through the whole steps as i mentioned .
    but is it required to define result and param tag somewhere
    because it is not generating the PDF file.
    And In Log file it genertatin error like:
    2008-Sep-15 18:19:23,015 ERROR Digester - Parse Error at line 1085 column 46: Element type "result" must be declared.
    org.xml.sax.SAXParseException: Element type "result" must be declared.
    similar error for param tag.

    I want to know what should i do to sort out this error.

    Thanxs
    kajal sinha
    kajal@adastraconsultants.com

    1. Please ask questions on the struts user mailing list.

      That said, make sure the jasper result type is correctly registered and that you actually have the jasper reports plugin in your classpath. For more info, see Result Types