JasperReports - Ortam Kurulumu

JasperReports, saf bir Java kitaplığıdır ve bağımsız bir uygulama değildir. Kendi başına çalışamaz, bu nedenle başka bir istemci veya sunucu tarafı Java uygulamasına katıştırılması gerekir. Java tabanlı olduğu için Java'yı destekleyen herhangi bir platformda (JDK 1.3 ve üzeri) çalıştırılabilir. JasperReport'un tüm işlevleri tek bir JAR dosyasında, jasperreports-xxxjar'da toplanmıştır. Bu JAR, gerekli ve isteğe bağlı kitaplıklar (.ZIP dosyası) ile birlikte siteden indirilebilir: JasperReport Kitaplık Bağlantısı . Bu bağlantıdan en son sürümü indirin.

ZIP dosyası, JasperReports JAR dosyasını, JasperReports kaynak kodunu, bağımlı JAR'ları ve JasperReport'un işlevlerini gösteren birçok örneği içerir.

JasperReport Ortamı

Raporları oluşturmaya başlamak için ortamı hazır hale getirmemiz gerekiyor. İndirilen JasperReport.ZIP dosyasını herhangi bir konuma çıkarın (bizim durumumuzda, onu C: \ tools \ jasperreports-5.0.1'e çıkardık). Çıkarılan dosyanın dizin yapısı aşağıda gösterilenle aynıdır -

İşte tüm dizinlerin detayı -

build - Derlenmiş JasperReport sınıf dosyalarını içerir.
demo - JasperReports işlevselliğinin çeşitli yönlerini gösteren çeşitli örnekler içerir.
dist - jasperreports-xxxjar dosyasını içerir. JasperReports'tan yararlanmak için bu JAR dosyasını CLASSPATH'ımıza ekleyeceğiz.
docs - JasperReports belgelerinin yerel bir kopyasını içerir.
lib - Hem JasperReports oluşturmak hem de uygulamalarımızda kullanmak için gereken tüm JAR'ları içerir.
src - JasperReports kaynak kodunu içerir.
build.xml - JasperReports kaynak kodunu oluşturmak için bir ANT yapı dosyası. JasperReports'u değiştirmek niyetinde değilsek, JasperReports derlenmiş biçimde dağıtıldığı için bu dosyayı kullanmamıza gerek yoktur.
changes.txt - JasperReports sınıf kitaplığının mevcut ve önceki sürümleri arasındaki farkları açıklayan bir metin belgesi.
license.txt - LGPL (Daha Az Genel Kamu Lisansı) lisansının tam metnini içeren bir metin belgesi.
readme.txt - Sağlanan örneklerin nasıl oluşturulup çalıştırılacağına ilişkin talimatları içeren bir metin belgesi.

Temel olarak, rapor oluşturmak için sadece dist altında jasperreports-xxxjar ve lib dizini altındaki JARs'ı kullanıyoruz . JasperReports, açık kaynak kodlu bir araç olduğundan, jasperreports-xxxjar'da yürütme sırasında herhangi bir kusur veya hata fark edilirse, bunu düzeltebilir ve build.xml dosyasını kullanarak JAR'ı yeniden oluşturabiliriz.

CLASSPATH'ı ayarlayın

JasperReport'u kullanmak için aşağıdaki dosyaları CLASSPATH'ımıza ayarlamamız gerekir -

jasperreports-xxxjar, burada xxx, JasperReports sürümüdür. Bu, C: \ tools \ jasperreports-xxx \ dist) dizininde bulunur.
Lib alt dizini altındaki tüm JAR dosyaları (C: \ tools \ jasperreports-xxx \ lib).

Kurulum sırasında JasperReport 5.0.1 sürümünü kullandık. 'Bilgisayarım'a sağ tıklayın ve' Özellikler'i seçin, 'Gelişmiş' sekmesi altındaki 'Ortam değişkenleri' düğmesine tıklayın. Şimdi bununla 'Yol' değişkenini güncelleyinC:\tools\jasperreports-5.0.1\dist\jasperreports-5.0.1.jar:C:\tools\jasperreports-5.0.1\lib. Artık raporlarınızı oluşturmaya hazırsınız.

Bu eğitimdeki tüm örneklerde, raporlar oluşturmak için ANT görevlerini kullandık. buildfile, raporlar oluşturmak için gerekli tüm JAR'ların içe aktarılmasıyla ilgilenir. Bu nedenle, CLASSPATH'ı yukarıda belirtildiği gibi ayarlamak yalnızca ANT kullanmadan rapor oluşturmak isteyenlere yardımcı olacaktır.

Kurulum Kurulumu

Bu eğitimdeki tüm örnekler -

basit Metin Düzenleyicisi kullanılarak yazılmıştır.
C: \ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspoint dizini altına kaydedilmiştir.
Apache ANT kullanılarak komut isteminden derlenmiş ve çalıştırılmıştır. KullanacağızbaseBuild.xml ANT olarak ithal edeceğimiz dosya build.xmlsonraki bölümlerde dosya. Bu dosyayı C: \ tools \ jasperreports-5.0.1 \ test konumuna kaydedin. BaseBuild.xml dosyasının içeriği aşağıdadır -

<?xml version = "1.0" encoding = "UTF-8"?>
<project name = "JasperReportExample" basedir = ".">
   <description>Previews our JasperReport XML Design</description>
   <property name = "file.name" value = "jasper_report_template" />
   
   <!-- Directory where the JasperReports project file was extracted
   needs to be changed to match the local environment -->
   <property name = "jasper.dir" value = "../" />
   <property name = "dist.dir" value = "${jasper.dir}/dist" />
   <property name = "lib.dir" value = "${jasper.dir}/lib" />
   <property name = "src.dir" value = "src" />
   <property name = "classes.dir" value = "classes" />
   <property name = "main-class" value = "com.tutorialspoint.HelpMe" />

   <path id = "classpath">
      <pathelement location = "./" />
      <pathelement location = "${classes.dir}" />
	  
      <fileset dir = "${lib.dir}">
         <include name = "**/*.jar" />
      </fileset>
	  
      <fileset dir = "${dist.dir}">
         <include name = "**/*.jar" />
      </fileset>
   </path>
   
   <target name = "compile" depends = "clean-sample">
      <mkdir dir = "${classes.dir}"/>
		
      <javac srcdir = "${src.dir}" destdir = "${classes.dir}" 
         classpathref = "classpath" />
   </target>
   
   <target name = "run" depends = "compile">
      <echo message = "Running class : ${main-class}"/>
	  
      <java fork = "true" classname = "${main-class}">
         <classpath>
            <path refid = "classpath" />
         </classpath>
      </java>
   </target>
   
   <target name = "clean-sample">
      <delete dir = "${classes.dir}" />
      <delete file = "./${file.name}.jasper" />
      <delete file = "./${file.name}.jrprint" />
   </target>
   
</project>

Bu dosya, dizinleri temizleme, java dosyalarını derleme ve sınıf dosyalarını yürütme gibi gerekli tüm hedeflere sahiptir.

Aşağıda, baseBuild.xml'deki çeşitli dizinlerde belirtilen ayrıntılar yer almaktadır. Geçerli dizinin C: \ tools \ jasperreports-5.0.1 \ test olduğunu varsayarsak) -

jasper.dir - C: \ tools \ jasperreports-5.0.1 dizini
lib.dir - C: \ tools \ jasperreports-5.0.1 \ lib dizinidir
src.dir - C: \ tools \ jasperreports-5.0.1 \ test \ src şeklindedir
classes.dir - C: \ tools \ jasperreports-5.0.1 \ test \ classes
ana sınıf - com.tutorialspoint.HelpMe. Bu sınıf, komut satırından hiçbir sınıf dosyası adı geçmediğinde yürütülen basit bir sınıftır. Bu dosyayı C: \ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspoint'e kaydedin.

package com.tutorialspoint;

public class HelpMe {
   public static void main(String[] args) {
      System.out.println("This is the default class executed."
         + "Please pass the fully qualified class" + " name to be executed as command line"
         + " parameter, for example," + " com.tutorialspoint.HelpMe ");
   }
}

Jasper Yöneticileri Sınıfları

Bir JRXML rapor tasarımını derlemek, bir raporu doldurmak, bir raporu yazdırmak, PDF, HTML ve XML dosyalarına dışa aktarmak, oluşturulan raporları görüntülemek ve rapor tasarımı için kullanılacak çok sayıda sınıf vardır.

Bu sınıfların listesi -

net.sf.jasperreports.engine.JasperCompileManager - JRXML rapor şablonunu derlemek için kullanılır.
net.sf.jasperreports.engine.JasperFillManager - Bir raporu veri kaynağındaki verilerle doldurmak için kullanılır.
net.sf.jasperreports.engine.JasperPrintManager - JasperReports kitaplığı tarafından oluşturulan belgeleri yazdırmak için kullanılır.
net.sf.jasperreports.engine.JasperExportManager - Rapor doldurma işlemi ile üretilen belgeler için PDF, HTML veya XML içeriği elde etmek için kullanılır.
net.sf.jasperreports.view.JasperViewer - Raporları yükleyip görüntüleyebilen basit bir Java Swing uygulamasını temsil eder.
net.sf.jasperreports.view.JasperDesignViewer - Tasarım zamanında rapor şablonlarını önizlemek için kullanılır.

Apache ANT'yi kurma

Apache ANT kullanarak tüm örnekleri oluşturacağız. Bu nedenle, Apache ANT'yi sisteminize kurmak için lütfen ANT - Ortam Kurulumu bölümüne bakın.