Search icon
Cart icon
Close icon
You have no products in your basket yet
Save more on your purchases!
Savings automatically calculated. No voucher code required
Arrow left icon
All Products
Best Sellers
New Releases
Learning Hub
Free Learning
Arrow right icon
Over 7,000 tech titles at $9.99 each with AI-powered learning assistants on new releases
JasperReports for Java Developers
JasperReports for Java Developers

JasperReports for Java Developers:

$28.99 $9.99
Book Aug 2006 344 pages 1st Edition
$28.99 $9.99
$15.99 Monthly
$28.99 $9.99
$15.99 Monthly

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Buy Now
Table of content icon View table of contents Preview book icon Preview Book

JasperReports for Java Developers

Chapter 1. An Overview of JasperReports

This chapter presents an overview of JasperReports and explains its capabilities and features. Here is a brief outline of the topics covered in this chapter:

  • A brief history of JasperReports
  • What JasperReports is, and what it can do for us
  • A brief discussion of the JasperReports open-source license
  • The features of JasperReports
  • JasperReports' class library dependencies
  • A brief overview of the steps required to generate reports with JasperReports
  • Where to get support for JasperReports

Brief History of JasperReports

JasperReports was started by Teodor Danciu, in 2001, when he was faced with the task of evaluating reporting tools for a project he was working on. The existing solutions that he found were too expensive for his project's budget. Therefore, he decided to write his own reporting tool. The project for which he was evaluating reporting tools got canceled; but, nevertheless, he started working on JasperReports in his spare time. He registered the project on in September, 2001. Shortly after, he started getting emails from interested potential users even though he had not yet released any code.

JasperReports version 0.1.5 was released in November, 2001. Since then, JasperReports has become immensely popular, and is currently one of the most popular (if not the most popular) Java reporting tools available. As a testament to JasperReports' enormous popularity, a Google search for java reporting tool returns the JasperReports website as its first result.

Until recently, JasperReports was basically a one-man project, with Teodor working on it in his spare time. In April 2005, a company called JasperSoft was formally launched at the MySQL User Conference in California. JasperSoft sponsors JasperReports' development, allowing Teodor and other JasperSoft developers to work full-time on JasperReports. JasperSoft also provides commercial support and services for JasperReports and related products, including the iReport Visual Designer for JasperReports. In addition to providing support for JasperReports and iReport, JasperSoft sells commercial applications incorporating JasperReports.

JasperSoft has raised over 8 million dollars in venture capital funding, no small feat in these post-dotcom days. This investment is a clear indication that venture capitalists have confidence in the success of JasperSoft, and, by extension, in the success of JasperReports. According to JasperSoft, JasperReports has been downloaded over 300,000 times, and gets over 20,000 downloads a month. It has been deployed in over 10,000 companies and Independent Software Vendors (ISVs).

What is JasperReports?

JasperReports is an open-source Java class library designed to aid developers with the task of adding reporting capabilities to Java applications. Since it is not a standalone tool, it cannot be installed on its own. Instead, it is embedded into Java applications by including its library in the application's CLASSPATH. JasperReports is a Java class library, and is not meant for end users, but rather is targeted towards Java developers who need to add reporting capabilities to their applications.

Although JasperReports is primarily used to add reporting capabilities to web-based applications via the Servlet API, it has absolutely no dependencies on the Servlet API or any other Java EE library. It is, therefore, by no means limited to web applications. There is nothing stopping us from creating standalone desktop or command-line Java applications to generate reports with JasperReports. After all, JasperReports is nothing but a Java class library providing an API to facilitate the ability to generate reports from any kind of Java application.

JasperReports requires a Java Development Kit (JDK) 1.3 or newer in order to successfully compile applications incorporating the JasperReports Java class library, and a Java Runtime Environment 1.3 or newer to successfully execute these applications. Older versions of JasperReports required a JDK to successfully execute JasperReports applications (strictly speaking, JasperReports required tools.jar to be in the CLASSPATH, and tools.jar is included in the JDK, not the JRE). However, from version 0.6.4, JasperReports is bundled with the Eclipse Java Development Tools (JDT) compiler, and no longer needs a JDK to execute deployed applications. Examples in this book are developed using JDK 1.5, but should compile and execute successfully with any JDK or JRE supported by JasperReports.

The JasperReports Open-Source License

JasperReports is licensed under the Lesser GNU Public License (LGPL). This license was chosen for JasperReports since, unlike the GPL, it allows JasperReports to be used in both open-source and closed-source applications. Applications linking to the JasperReports Java class library do not need to be open-source. However, if you consider making modifications to the existing JasperReports source code, then your modifications will have to be released under the LGPL. See for the complete license.

Features of JasperReports

In addition to textual data, JasperReports is capable of generating professional reports including images, charts, and graphs. Some of the major JasperReports features include:

  • It has flexible report layout.
  • It is capable of presenting data textually or graphically.
  • It allows developers to supply data in multiple ways.
  • It can accept data from multiple datasources.
  • It can generate watermarks.
  • It can generate subreports.
  • It is capable of exporting reports to a variety of formats.

Each of these features is briefly described in the next few sections.

Flexible Report Layout

JasperReports allows us to separate data into optional report sections. These sections include:

  • The report title, which will appear once at the top of the report.
  • A page header, which will appear at the top of every page.
  • A detail section, which typically contains the primary report data.
  • A page footer, which will appear at the bottom of every page.
  • A summary section, which will appear at the end of the report.

All of these and other report sections are discussed in detail in Chapter 6. In addition to allowing us to define report sections, JasperReports allows the creation of elaborate dynamic layouts based on the contents of the report. For example, depending on the value of a report field, data can be hidden or displayed in a report, or data can be grouped into logical sections. Say, we are creating a report about cars. JasperReports allows us to group the data by make, model, year, or a combination of these or any other piece of data displayed on the report. Data grouping allows us to better control the layout of the report. Data-group definitions can also be used to calculate subtotal values based on a subset of the report data. Groups are also used to define datasets for charts and graphs. Data grouping is discussed in detail in Chapter 6.

Multiple Ways to Present Data

JasperReports provides the ability to display report data textually or graphically via charts. JasperReports allows us to use report expressions to generate reports that display dynamic data. That is, data that is not directly passed to the report or stored anywhere, but is calculated from the data contained in the datasource and/or report parameters.

Multiple Ways to Supply Data

JasperReports allows developers to pass data to a report by passing it report parameters. Report parameters can be instances of any Java class.

Data can also be passed to a report by using special classes called datasources. Report parameters and datasources can be combined for maximum flexibility.

Multiple Datasources

JasperReports can generate reports using any relational database system supported by JDBC. However, it is not limited to database reports only. It can generate reports from a number of datasources, including XML files, Plain Old Java Objects (POJOs), any class implementing the java.util.Map interface, and any class implementing the javax.swing.TableModel interface.

JasperReports also supports empty datasources, which are used for simple reports that have no dynamic data displayed. If we need to create a report from a datasource, not directly supported by JasperReports, it allows us to create our own custom datasources. JDBC datasources are discussed in detail in Chapter 4. Other datasource types, including custom datasources, are discussed in detail in Chapter 5.


JasperReports is capable of generating background images or text on the reports it generates. These background images can serve as a sort of 'watermark' for the report. A watermark is like a secondary image that is laid over the primary image.

Watermarks can be used for branding reports and for security purposes, since they make it difficult to forge reports. All report pages have the same watermark, which gives them a consistent look and feel.


Another feature of JasperReports is that it allows us to create subreports, or reports within reports. Subreports simplify report design significantly by allowing us to extract complex report sections into a separate report, and incorporating that separate report into a master report.

Exporting Capabilities

Reports generated with JasperReports can be exported to a number of formats, including PDF (Portable Document Format), XLS (Excel), RTF (Rich Text Format, a format readable and editable by most word processors, including, but certainly not limited to, Microsoft Word, Writer, StarOffice Writer, and WordPerfect), HTML (HyperText Markup Language), XML (Extensible Markup Language), CSV (Comma-separated Values), and plain text. Exporting reports to these formats is discussed in detail in Chapter 9. There is also a third-party library to export JasperReports' reports to the OpenDocument Format (ODF). The OpenDocument Format is a standard XML-based file format specification for office applications developed by the Organization for the Advancement of Structured Information Standards (OASIS). version 2.0 uses ODF as its default format.


The JasperReports OpenDocument Format exporter was developed in the summer of 2005, as a part of Google's Summer of Code program. More information about the JasperReports OpenDocument Format exporter can be found at

The screenshot overleaf demonstrates some of the features of JasperReports, including data grouping, adding images and watermarks to a report, and exporting to a PDF:

Exporting Capabilities

When creating the report given in the screenshot, we took advantage of the data-grouping capabilities of JasperReports to group data by country, state, and city. This grouping allowed us to display the data in a logical, easy-to-follow way. We also took advantage of JasperReports' ability to display images and added a watermark and a logo in the report heading. The report font was modified in the header section to display it in a bigger font and in bold. Text was laid out in an easy-to-follow format.

In the screenshot, the freely available Evince document viewer was used to display the PDF report. Of course, reports exported to PDF can be viewed with any PDF viewer, including Adobe Acrobat, Foxit, and xPDF.

Class Library Dependencies

JasperReports leverages other open-source Java libraries to implement some of their functionality. Some of the libraries JasperReports builds on include:

  • iText: iText is a PDF generation and manipulation library. It also has the ability to generate and manupulate RTF, XML, and HTML documents. JasperReports takes advantage of iText for exporting reports to PDF and RTF. More information about iText can be found at
  • JFreeChart: JFreeChart is a Java library for producing various charts, including pie charts, bar charts, line and area charts, and the like. JasperReports takes advantage of JFreeChart to implement its built-in charting functionality. More information about JFreeChart can be found at
  • Jakarta POI: Jakarta POI is a Java class library to create and manipulate various Microsoft Office formats based on Microsoft's OLE 2 Compound Document format. JasperReports takes advantage of Jakarta POI for exporting reports to XLS (Microsoft Excel) format. More information about Jakarta POI can be found at
  • JAXP: JAXP refers to the Java API for parsing and transforming XML documents. It is used by JasperReports to parse XML files and is included in Java SE 5.0. It has to be downloaded separately when using earlier versions of Java SE. More information about JAXP can be found at
  • Jakarta Commons: Jakarta Commons is a collection of Java libraries providing a large number of reusable components. JasperReports takes advantage of the Digester, BeanUtils, and Logging components of Jakarta Commons to complement JAXP for XML parsing. More information about Jakarta Commons can be found at


URLs are provided for informational purposes only. The JasperReports class library already includes the required JAR files listed here. There is no need for us to download them to take advantage of their functionality within JasperReports.

Typical Workflow

The flow chart overleaf illustrates the typical workflow while creating reports with JasperReports:

Typical Workflow

When working with JasperReports, the first step is to create a report template as an XML file. XML report templates can be hand-coded or generated by a graphical report designer. Even though JasperReports' report templates are XML files, template filenames are given an extension of .jrxml. JasperReports XML templates are commonly referred to as JRXML files, which is the term we will use for them in this book.

Here is what a typical JRXML file looks like. We will discuss JRXML files in detail in Chapter 4.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN" "">
<jasperReport name="simple_template">
<band height="50">
<band height="50">
<band height="30">
<band height="100">
<band height="30">
<band height="50">
<band height="50">
<band height="50">

The JRXML file here mostly illustrates the main elements of a JRXML file. All elements in the file are optional except for the root<jasperReport> element. The above JRXML file, when compiled and filled, will generate an empty report; not very useful in its own right, but it can be used as a template for creating more useful reports. As can be seen in the above example, each main element of the JRXML file contains a<band> element as its only child element. Bands contain the data that is displayed in the report. In the above example, all bands are empty. In real JRXML files, bands contain child elements that are used to position, format, and display the actual report data, both textual and graphical. There are commercial and open-source visual design tools that can aid in the development of JRXML files. iReport, the official JasperReports graphical report designer, is covered in detail in Chapter 10.

JRXML files are compiled into a JasperReports native binary template, either programmatically by calling the appropriate methods on the JasperReports class library (compileReportToFile()), or by using a custom ANT task (used to compile multiple XML report design files in a single operation, by specifying the root directory that contains those files or by selecting them using file patterns) provided by JasperReports. The resulting compiled template is commonly known as the Jasper file, and is typically saved to disk with a .jasper extension. The Jasper file is then used to generate the final report, by providing it with its required data. This process is known as filling the report. A JRXML file has to be compiled only once. The generated Jasper file can be filled as many times as necessary to create and display reports.

Filled reports can be saved to disk in a JasperReports native format. Reports saved in this format are known as JasperPrint files. JasperPrint file names have a .jrprint extension. JasperPrint files can only be viewed with a JasperReports-specific viewer. JasperPrint files can be exported to other formats so that they can be opened with commonly available tools like PDF viewers and word processors. Exporting to other formats is discussed in detail in Chapter 9.

Where to Get Help?

JasperReports has official online forums and a mailing list where questions can be asked. Both the forums and the mailing list archives can be found at the JasperReports site at

The JasperReports website contains tips, tricks, JavaDoc API documentation, and a quick reference for JRXML elements. We won't repeat this information in this book, since it is readily available online. The JasperReports website can be found at

Commercial support and training is offered by JasperSoft and other third-party companies.


In this chapter we were introduced to JasperReports. We discussed the evolution of JasperReports from a small one-man project to a project backed and funded by a company that has raised millions of dollars in venture capital. We also had an overview of JasperReports, where we discussed that JasperReports is not a standalone reporting solution. Instead, it is a Java library that allows us to add reporting capabilities to our applications.

Next on the line was the JasperReports' open-source license (LGPL). The chapter provided us with a brief explanation of the features of JasperReports, including flexibility in report layout, the ability to display report data textually or graphically, and the ability to group report data. The JasperReports' class library dependencies were also discussed along with the typical workflow followed when designing reports. The chapter also provided us with the official online forums and mailing lists from where we can seek help.

Left arrow icon Right arrow icon

Key benefits

  • Get started with JasperReports, and develop the skills to get the most from it
  • Create, design, format, and export reports
  • Generate report data from a wide range of datasources
  • Integrate Jasper Reports with Spring, Hibernate, Java Server Faces, or Struts


JasperReports is the world's most popular embeddable Java open source reporting library, providing Java developers with the power to easily create rich print and web reports. This book shows you exactly how to get started, and develop the skills to get the most from JasperReports. The book steers you through each point of report setup, to creating, designing, formatting, and exporting reports with data from a wide range of datasources, and integrating JasperReports with other Java frameworks. Starting with the basics of adding reporting capabilities to your application, and creating report templates you will first see how to produce your reports through the use of JRXML files, custom ANT targets, and then see preview them in both the browser and the native browser of JasperReports. Getting data into your reports is the next step, and you will see how to get data from a range of datasources, not only databases, but XML files, and Java Objects, among others. You will create better looking reports with formatting and grouping, as well as adding graphical elements to the report. You will export your reports to a range of different formats, including PDF and XML. Creating reports will be made even easier with a walkthrough of the iReport Designer visual designing tool. To round things off, you will see how to integrate your reports with other Java frameworks, using Spring or Hibernate to get data for the report, and Java Server Faces or Struts for presenting the report.

What you will learn

Overview of JasperReports, and what it can do for you Adding reporting capabilities to your application Creating and formatting reports Report layout and design Working with database datasources Working with other types of datasource such as arrays, collections, TableModels and XML Creating subreports Adding charts and graphics to a report Working with the iReport report designer Exporting reports to PDF, Excel spreadsheet or Word document format Integrating JasperReports with other Java frameworks like Spring, Java Server Faces, Struts, and Hibernate

Product Details

Country selected

Publication date : Aug 4, 2006
Length 344 pages
Edition : 1st Edition
Language : English
ISBN-13 : 9781904811909
Vendor :
Category :
Languages :

What do you get with eBook?

Product feature icon Instant access to your Digital eBook purchase
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Buy Now

Product Details

Publication date : Aug 4, 2006
Length 344 pages
Edition : 1st Edition
Language : English
ISBN-13 : 9781904811909
Vendor :
Category :
Languages :

Table of Contents

13 Chapters
Preface Chevron down icon Chevron up icon
1. An Overview of JasperReports Chevron down icon Chevron up icon
2. Adding Reporting Capabilities to Java Applications Chevron down icon Chevron up icon
3. Creating Your First Report Chevron down icon Chevron up icon
4. Creating Dynamic Database Reports Chevron down icon Chevron up icon
5. Working with Other Datasources Chevron down icon Chevron up icon
6. Report Layout and Design Chevron down icon Chevron up icon
7. Adding Charts and Graphics to Reports Chevron down icon Chevron up icon
8. Other JasperReports Features Chevron down icon Chevron up icon
9. Exporting to Other Formats Chevron down icon Chevron up icon
10. Graphical Report Design with iReport Chevron down icon Chevron up icon
11. Integrating JasperReports with other Frameworks Chevron down icon Chevron up icon
Index Chevron down icon Chevron up icon

Customer reviews

Top Reviews
Rating distribution
Empty star icon Empty star icon Empty star icon Empty star icon Empty star icon 0
(0 Ratings)
5 star 0%
4 star 0%
3 star 0%
2 star 0%
1 star 0%
Filter icon Filter
Top Reviews

Filter reviews by

No reviews found
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial


How do I buy and download an eBook? Chevron down icon Chevron up icon

Where there is an eBook version of a title available, you can buy it from the book details for that title. Add either the standalone eBook or the eBook and print book bundle to your shopping cart. Your eBook will show in your cart as a product on its own. After completing checkout and payment in the normal way, you will receive your receipt on the screen containing a link to a personalised PDF download file. This link will remain active for 30 days. You can download backup copies of the file by logging in to your account at any time.

If you already have Adobe reader installed, then clicking on the link will download and open the PDF file directly. If you don't, then save the PDF file on your machine and download the Reader to view it.

Please Note: Packt eBooks are non-returnable and non-refundable.

Packt eBook and Licensing When you buy an eBook from Packt Publishing, completing your purchase means you accept the terms of our licence agreement. Please read the full text of the agreement. In it we have tried to balance the need for the ebook to be usable for you the reader with our needs to protect the rights of us as Publishers and of our authors. In summary, the agreement says:

  • You may make copies of your eBook for your own use onto any machine
  • You may not pass copies of the eBook on to anyone else
How can I make a purchase on your website? Chevron down icon Chevron up icon

If you want to purchase a video course, eBook or Bundle (Print+eBook) please follow below steps:

  1. Register on our website using your email address and the password.
  2. Search for the title by name or ISBN using the search option.
  3. Select the title you want to purchase.
  4. Choose the format you wish to purchase the title in; if you order the Print Book, you get a free eBook copy of the same title. 
  5. Proceed with the checkout process (payment to be made using Credit Card, Debit Cart, or PayPal)
Where can I access support around an eBook? Chevron down icon Chevron up icon
  • If you experience a problem with using or installing Adobe Reader, the contact Adobe directly.
  • To view the errata for the book, see and view the pages for the title you have.
  • To view your account details or to download a new copy of the book go to
  • To contact us directly if a problem is not resolved, use
What eBook formats do Packt support? Chevron down icon Chevron up icon

Our eBooks are currently available in a variety of formats such as PDF and ePubs. In the future, this may well change with trends and development in technology, but please note that our PDFs are not Adobe eBook Reader format, which has greater restrictions on security.

You will need to use Adobe Reader v9 or later in order to read Packt's PDF eBooks.

What are the benefits of eBooks? Chevron down icon Chevron up icon
  • You can get the information you need immediately
  • You can easily take them with you on a laptop
  • You can download them an unlimited number of times
  • You can print them out
  • They are copy-paste enabled
  • They are searchable
  • There is no password protection
  • They are lower price than print
  • They save resources and space
What is an eBook? Chevron down icon Chevron up icon

Packt eBooks are a complete electronic version of the print edition, available in PDF and ePub formats. Every piece of content down to the page numbering is the same. Because we save the costs of printing and shipping the book to you, we are able to offer eBooks at a lower cost than print editions.

When you have purchased an eBook, simply login to your account and click on the link in Your Download Area. We recommend you saving the file to your hard drive before opening it.

For optimal viewing of our eBooks, we recommend you download and install the free Adobe Reader version 9.