jasper report

I will show you step by step how to use Dynamic Jasper Report with custom query. I won’t show how to use static reportable in Domain because there are lots of tutorial like this one

Installing Plugins
It is as simple typing

grails install-plugin dynamic-jasper

Generating Domains step
We create 2 domains name: Book and Author simply type

grails create-domain-class Book
grails create-domain-class Author

and add some field on the domains :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

class Book {
    String name ; 
    String barcode ;
    String summary;
    Author author; 
 
    static belongsTo = [author:Author];
 
    static constraints = {
        name(nullable:false, blank:false);
        barcode(nullable:false, blank:false);
        summary(nullable:false, blank:false);
    }
 
    String toString() {
        "${name}"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

class Author {
    String name ;
    String summary ;
 
    static hasMany = [books:Book];
 
    static constraints = {
        name(nullable:false, blank:false);
        summary(nullable:false, blank:true);
    }
 
    String toString() {
        "${name}";
    }
}

Create a controller for displaying the Jasper

grails create-controller Report

Here we want to create an excel report so we fill ReportController with this :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

import net.sf.jasperreports.engine.*;
import net.sf.jasperreports.engine.data.*;
import net.sf.jasperreports.engine.export.*;
import net.sf.jasperreports.engine.util.*;
import net.sf.jasperreports.view.*;
 
import ar.com.fdvs.dj.domain.DynamicReport;
import ar.com.fdvs.dj.domain.builders.FastReportBuilder;
import ar.com.fdvs.dj.core.DynamicJasperHelper;
import ar.com.fdvs.dj.core.layout.ClassicLayoutManager;
import ar.com.fdvs.dj.output.*;
 
 
 
class ReportController {
 
    def index = { 
        FastReportBuilder drb = new FastReportBuilder();
        drb = drb.addColumn("Book Name","name",String.class.getName(),30);
        drb = drb.addColumn("Barcode","barcode",String.class.getName(),20);
        drb = drb.addColumn("Author","author.name",String.class.getName(),30);
        drb = drb.addColumn("Author Summary","author.summary",String.class.getName(),70);
        DynamicReport dr = drb.setTitle("My tester ").setUseFullPageWidth(true).build();
 
        JRDataSource ds = new JRBeanCollectionDataSource(Book.list());   
        JasperPrint jp = DynamicJasperHelper.generateJasperPrint(dr, 
                new ClassicLayoutManager(), ds);
 
 
        def reportFormat = 'XLS';
        def reportFileName = "myReport";
        ReportWriter reportWriter = ReportWriterFactory.getInstance().getReportWriter(jp, reportFormat, [(JRHtmlExporterParameter.IMAGES_URI): "${request.contextPath}/report/image?image=".toString()]);
        if (reportFileName) {
            response.addHeader('content-disposition', "attachment; filename=${reportFileName}.${reportFormat.toLowerCase()}")
        }
        reportWriter.writeTo(response)
    }
}

FastReportBuilder will create columns and do what the jrxml does.
DynamicReport will build the report for you (i think it identical with compiling jrxml to .jasper)

You fill data of the report using JRBeanCollectionDataSource. here we use simple query Book.list(). You might try it using Criteria as well.

To display the report in the browser, we just tell the browser about the header and its content by this code :

ReportWriter reportWriter = ReportWriterFactory.getInstance().getReportWriter(jp, reportFormat, [(JRHtmlExporterParameter.IMAGES_URI): "${request.contextPath}/report/image?image=".toString()]);
        if (reportFileName) {
            response.addHeader('content-disposition', "attachment; filename=${reportFileName}.${reportFormat.toLowerCase()}")
        }
        reportWriter.writeTo(response)</blockquote>

done … that’s so easy.

dynamic jasper result in excel format

more information about dynamice jasper visit:
http://dynamicjasper.sourceforge.net/

on
this web

Few weeks ago, I found that Grails has Liquibase plugin (there are 2, liquibase and autobase). I tried both plugins and autobase won my heart because the simplicity they offer (not using XML is the biggest advantages, for me at least). Liquibase however build as stand alone java application that you can run with any operating system that support java.

Here I will show you how to configure and using Liquibase on command line, so you can apply whether you are using php, python, or others programming language/framework

• First, download and extract Liquibase files from www.liquibase.org
• Create a file named liquibase.properties
• Write the following, you can modify it to suit your needs

  1 2 3 4 5 6 7

  classpath: ../;lib/mysql-connector-java-5.1.6-bin.jar changeLogFile=changelogs/root.changelog.xml username=root password= url=jdbc:mysql://localhost/tester driver=com.mysql.jdbc.Driver logLevel=SEVERE

  * you must download mysql-connector-java-5.xxxx.jar (mysql jdbc driver) from www.mysql.com

• Create a directory changelogs
• Inside, create root.changelog.xml and write the following

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

  <?xml version="1.0" encoding="UTF-8"?>   <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog/1.7" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog/1.7 http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-1.7.xsd"> <preConditions> <dbms type="mysql"/> <sqlCheck expectedResult="1">select 1</sqlCheck> <runningAs username="root"/> </preConditions>   <changeSet id="1" author="nvoxland"> <comment> You can add comments to changeSets. They can even be multiple lines if you would like. They aren't used to compute the changeSet MD5Sum, so you can update them whenever you want without causing problems. </comment> <createTable tableName="person"> <column name="id" type="int" autoIncrement="true"> <constraints primaryKey="true" nullable="false"/> </column> <column name="firstname" type="varchar(50)"/> <column name="lastname" type="varchar(50)"> <constraints nullable="false"/> </column> </createTable> </changeSet> <changeSet id="2" author="nvoxland"> <comment>Add a username column so we can use "person" for authentication</comment> <addColumn tableName="person"> <column name="usernae" type="varchar(8)"/> </addColumn> </changeSet> <changeSet id="3" author="nvoxland"> <comment>Fix misspelled "username" column</comment> <renameColumn tableName="person" oldColumnName="usernae" newColumnName="username" columnDataType="varchar(8)"/> </changeSet> </databaseChangeLog>

• When you finished, go to command line and type :
  

  java -jar liquibase-1.9.0.jar migrate

• This command will create databasechangelog and databasechangeloglock first. Databasechangelog contains record migration that you have done in the past. If you delete one record, next time you run migrate, it will re-run again

Now I will explain what is inside the changelog

1
2
3
4
5
6
7
8
9
10
11
12
13

<?xml version="1.0" encoding="UTF-8"?>
 
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog/1.7"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog/1.7 http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-1.7.xsd">
    <preConditions>
        <dbms type="mysql"/>
        <sqlCheck expectedResult="1">select 1</sqlCheck>
        <runningAs username="root"/>
    </preConditions>
..... 
</databaseChangeLog>

It is the header of changelog that you need to have.
There are preConditions tag that will help you to know whether the database is mysql or not.

next :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<changeSet id="1" author="nvoxland">
        <comment>
            You can add comments to changeSets.
            They can even be multiple lines if you would like.
            They aren't used to compute the changeSet MD5Sum, so you can update them whenever you want without causing
            problems.
        </comment>
        <createTable tableName="person">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="firstname" type="varchar(50)"/>
            <column name="lastname" type="varchar(50)">
                <constraints nullable="false"/>
            </column>
        </createTable>
    </changeSet>

This change set will generate a table Person for you. having column firstname and lastName

next:

1
2
3
4
5
6

<changeSet id="2" author="nvoxland">
        <comment>Add a username column so we can use "person" for authentication</comment>
        <addColumn tableName="person">
            <column name="usernae" type="varchar(8)"/>
        </addColumn>
    </changeSet>

The second update will add “usernae” (typo mistakes is on purpose) with width 8 characters

next: we need to fix the usernae become username

1
2
3
4

    <changeSet id="3" author="nvoxland">
        <comment>Fix misspelled "username" column</comment>
        <renameColumn tableName="person" oldColumnName="usernae" newColumnName="username" columnDataType="varchar(8)"/>
    </changeSet>

They are lots of command that you can use on Liquibase, just make sure you read the manual first on http://www.liquibase.org/manual/

So here is how you can trap all errors and displayed on your screen (without using firebug).

This example works on grails main layout (but you can use this tips on any programming language, just put this code on main layout). My code using Jquery and JQalert to display the error

1
2
3
4
5
6
7

$(document).ready(function(){
                $(document).ajaxError(function(event, request, setting){
                    var re = /<br\/>|<br>/g; // for replacing all <br/> with empty string in error 404
                    var txt = request.responseText.replace(re,"");
                    jqalert(txt,"Server Error");
                });
});