JasperReports 설치

다음은 JasperReports 설치 순서로서 다운로드와 설치 환경 그리고 Report Designer 설치 및 Sample Application 설치의 4가지 영역으로 구분하여 설명을 진행한다.
Spring MVC와 통합된 형태로 JasperReports 기능을 사용하므로 Anyframe Core의 Spring과 Anyframe Web의 Spring MVC가 이미 설치되었다는 가정 하에서 아래 설치 과정을 진행하도록 하겠다.
그러므로 Anyframe Web을 설치한 이후에 JasperReports를 설치하도록 한다.

다운로드

다음은 JasperReports 기능을 사용하기 위해서 다운로드 받아야 하는 기본적인 파일들이다.
파일명
설명
다운로드
JasperAssistant_3.0.0_Eclipse3.3.zip [필수] JasperReports Report Designer Eclipse Plugin 설치 파일(Download Evaluation Version)
Download
Anyframe-eMarketplace-3.1.1-SpringMVC-1.5.zip [필수] Anyframe 기반의 Sample Application인 eMarketSystem의 Source 포함(Spring MVC 버전)
Download
AdbeRdr80_ko_KR.exe [필수] PDF 파일 디스플레이를 위한 Adobe Reader 8 (한국어 버전) 설치 파일
Download
FontPack810_ko_KR.msi [필수] PDF 파일 내 한국어 디스플레이를 위한 폰트 팩 설치 파일
Download
jasperreports-3.1.2-project.zip [선택] JasperReports 설치 파일
Download

설치 환경

JasperReports를 활용한 Sample Application은 아래와 같은 환경에서 테스트되었다. 아래의 SW에 대한 설치 방법은 이 매뉴얼에서는 생략한다. 이 다음 단계를 진행하기 전에 아래 4가지는 모두 개발 환경에 설치되어야 한다. JDK 1.4에서도 JasperReports를 활용한 Sample Application이 테스트되었으므로 사용가능하다. 이 매뉴얼 내에서는 JDK 1.5 버전 기준으로 설명하고 있다.
  • JDK 1.5
  • Web Container - Tomcat 5.5
  • DataBase - HsqlDB 1.8.0.4
  • Eclipse 3.3.1
본 문서에서는 기본적으로 Tomcat5.5 및 eclipse 3.3.1 (WTP 포함)를 기준으로 설치 가이드를 진행한다.

이하 문서에서 [Eclipse Home] 이라함은 Anyframe에서 제공한 eclipse 기반 툴셋의 루트를 지칭한다. Tomcat5.5 서버는 적절한 위치에 설치한 후 Eclipse Server Runtime 으로 등록하여야 한다.
위의 다운로드 테이블의 내용 중 [필수]라고 표시된 파일들을 모두 다운로드 받았다면, AdbeRdr80_ko_KR.exe와 FontPack810_ko_KR.msi 파일을 실행시켜서 설치하도록 한다.

[선택]으로 표시된 파일 중 jasperreports-3.1.2-project.zip 파일은 JasperReports 단독 설치 파일로 압축을 풀게 되면 다음과 같이 크게 3가지로 구분된다. JasperReports 사용 시 자세한 내용을 알고 싶다면 이 파일 내의 내용을 참고하도록 한다.

구분
설명
1 JasperReports를 사용한 Sample 파일들(JRXML, build.xml, JAVA 코드 등이 들어있음)
2 JasperReports JavaDoc 파일과 배포 JAR 파일들
3 JasperReports Source Code 파일들

Report Designer 설치

JasperReports 보고서 XML 파일 작성을 용이하게 하기 위해서 여러 종류의 툴이 제공된다. 무료 툴(iReport)과 유료 툴(JasperAssistant) 등 여러가지가 있으므로 원하는 툴을 선택하여 작성할 수 있는데, 여기서는 JasperAssistant를 사용하는 것으로 한다.

[참고]

* iReport : http://jasperforge.org/sf/projects/ireport(free)
* JasperAssistant : http://www.jasperassistant.com (미 구매 시 21일 evaluation version 사용 가능)

현재 JasperAssistant Eclipse plugin 2.4.1 버전을 사용하고 있다. JasperAssistant의 버전 업데이트는 빈번하게 발생하고 있으므로 최신 버전을 다운로드 받아서 직접 설치를 수행하고자 한다면 아래 사이트를 참고한다.

* Homepage : http://www.jasperassistant.com
* Download : http://www.jasperassistant.com/download.html

JasperAssistant를 설치하기 위해서는 2가지 방법이 사용될 수 있다. 하나는 Eclipse Update Site 기능을 이용하는 방법이고, 나머지 하나는 직접 Eclipse Plugin 형태의 배포 파일을 다운로드 받아서 Eclipse에 복사해 넣는 방법이다. 여기서는 배포 파일을 다운로드 받아서 Eclipse에 복사해 넣는 방법으로 설치하는 방법을 설명하고 있다. Eclipse Update Site 기능을 이용하는 방법에 대해서는 하단에 있는 [Resources] 내용을 참조하도록 한다.

[Eclipse Home] 폴더 하위의 addins 폴더에 jasperassistant.zip 압축 파일을 풀어서 설치하도록 한다.(addins/jasperassistant/eclipse/features..)
Eclipse를 사용 중이었다면 종료시킨 후 재기동 시키도록 한다.

Configuration

Eclipse Plugin인 JasperAssistant를 설치한 후, 사용하기 위해서는 아래와 같이 몇 가지 Configuration 작업을 해야 한다.
Configuration 창을 열기 위해서는 Window ->Preferences ->JasperAssistant 메뉴를 선택한다.
  • License Information - 상용툴인 JasperAssistant를 구매하였다면, 이 화면에서 License Key를 입력해넣도록 한다.
  • Console - [Default 사용] JasperAssistant console 창 설정 변경
  • Designer - [Default 사용] Designer Editor 설정 변경
  • Data Sources - 필수 설정으로 반드시 Report Designer를 사용하기 전에 설정해야 한다. Report 대상 데이터 소스에 접근하기 위한 정보를 입력한다.
    이때, 총 4가지 타입의 데이터 소스(Empty Data Source, Database Data Source, XML Data Source, Custom Data Source) 형태를 제공하는데 이 매뉴얼에서는 Database Data Source 설정 방법에 대해서만 언급한다.
    HSQLDB에 접근하기 위해서 아래와 같이 Driver, URL, hsqldb jar 파일 위치 등의 정보를 입력하도록 한다.



  • Export - [Default 사용] Export 설정 변경(File > Report Export.. 기능 실행 시 사용됨)으로 Report Designer 사용 시 반드시 사용되지는 않지만, Export 기능을 사용하게 된다면 PDF, Excel, HTML 파일 등의 실행 파일의 위치를 명시해줘야 한다. 각각의 Preview 항목에 C:\Program Files\Adobe\Reader 8.0\Reader\AcroRd32.exe, C:\Program Files\Microsoft Office\OFFICE11\EXCEL.EXE, C:\Program Files\Internet Explorer\IEXPLORE.EXE으로 작성한다.

JasperAssistant의 설치는 완료되었다. JasperAssistant를 활용하여 Report 파일을 만드는 방법은 Report Designer 매뉴얼 부분을 참고하도록 한다.

Sample Application 설치

Anyframe의 Sample Application인 eMarketSystem(Spring MVC 버전)에 JasperReports 기능을 추가시켜놓았다. Sample Application을 설치하는 방법은 이곳을 참고하도록 한다.

Resources