チュートリアル¶
目次
前提条件¶
このチュートリアルでは、 JavaEE開発モデル におけるプログラミングの方法について説明します。このチュートリアルでは、直接印刷機能（利用するAPI は jp.co.iothe.pdfdirectprint パッケージ）のサンプルを作成します。このチュートリアルで作成したプログラムは、C:\temp\sample.pdf ファイルをサンプルデータとして利用しますので、サンプルデータを作成してください。プリンタ名は環境に合わせて指定ください。
用語解説¶
環境¶
チュートリアルを学ぶための環境です。このドキュメント内では、ここで示す環境を前提として解説しています。
IM-PDFDirectPrint for Accel Platform 環境¶
サーバには IM-PDFDirectPrint for Accel Platform が正しくインストールされ、APIが正常に動作している状態であることが前提です。サーバは Windows Server 2012 で動作しているものとして説明をします。また、Java はOracle JDK がインストールされているものとします。
サンプルプログラムの場所¶
document/tutorial/DirectPrintSample.jspにサンプルプログラムを用意しておりますので参照してください。
サンプルデータの用意¶
C:\temp\sample.pdf ファイルを用意ください。
JSPプログラムの作成¶
このサンプルでは、JSPから IM-PDFDirectPrint for Accel Platform の 直接印刷機能を呼び出します。テキストエディタを起動して、以下のプログラムを記述します。この時、ファイル名の大文字・小文字は厳密な意味を持ちますので、注意してください。作成した JSPファイルは、以下のフォルダに保存してください。
ファイル名 保存場所 DirectPrintSample.jsp %RESIN_HOME%/webapps/{アプリケーション名}/
<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ page import="java.util.Date" %>
<%@ page import="java.text.ParseException" %>
<%@ page import="java.text.SimpleDateFormat" %>
<%@ page import="jp.co.iothe.pdfdirectprint.DirectPrint" %>
<%@ page import="jp.co.iothe.pdfdirectprint.intra_mart.IMDirectPrintFactory" %>
<%@ page import="jp.co.iothe.pdfdirectprint.PaperOrientation" %>
<%
// 環境に合ったインスタンスを生成
DirectPrint directPrint = IMDirectPrintFactory.createDirectPrint();
//DirectPrint directPrint = IMDirectPrintFactory.createDirectPrint("http://localhost:8080/pdfdirectprint/webapi/directprint", 60, 600);
// 印刷対象PDFファイル
String fileName = "C:\\temp\\sample.pdf";
String printerName = "PrinterName";
String password = "";
String resultMessage = "";
// 印刷部数
directPrint.setCopies(1); // 部数を指定
// 部単位でまとめて印刷する
directPrint.setCollate(false); // 部単位で印刷しない
directPrint.setCollate(true); // 部単位で印刷する
// 印刷ページ範囲
directPrint.setPrintRange("1,2"); // 1ページ、2ページ
directPrint.setPrintRange("1-5"); // 1ページ目から5ページ目
directPrint.setPrintRange("1-5,10-"); // 1ページ目から5ページ目、10ページ目から最終ページまでを印刷
directPrint.setPrintRange("*"); // 全ページ
// プリンタ名
directPrint.setPrinterName("def"); // デフォルトプリンタ（環境設定で指定されているプリンタ）
directPrint.setPrinterName(printerName); // プリンタ指定
// 用紙サイズ
directPrint.setPaperSize("A2"); // A2 : A2 420×594mm
directPrint.setPaperSize("A3"); // A3 : A3 297×420mm
directPrint.setPaperSize("A4"); // A4 : A4 210×297mm
directPrint.setPaperSize("A5"); // A5 : A5 148×210mm
directPrint.setPaperSize("A6"); // A6 : A6 105×148mm
directPrint.setPaperSize("B4"); // B4 : B4 257×364mm
directPrint.setPaperSize("B5"); // B5 : B5 182×257mm
directPrint.setPaperSize("legal"); // legal : リーガル 8 1/2×14インチ
directPrint.setPaperSize("letter"); // letter : レター 8 1/2×11インチ
directPrint.setPaperSize("def"); // def : 印刷するPDFファイルの用紙サイズ
// 用紙の向き
directPrint.setPaperOrientation(PaperOrientation.Landscape); // 横向き
directPrint.setPaperOrientation(PaperOrientation.Portrait); // 縦向き
directPrint.setPaperOrientation(PaperOrientation.Default); // 自動（PDFに合わせる）
// 縮尺率
directPrint.setScale("50"); // 50%
directPrint.setScale("100"); // 100%
directPrint.setScale("def"); // 用紙に合わせる
// 画像変換する
directPrint.setImage(false); // PDFファイルのまま印刷
directPrint.setImage(true); // 画像に変換してから印刷
// 中央配置する
directPrint.setCenter(false); // 用紙の端に配置
directPrint.setCenter(true); // 用紙の中央に配置
// 印刷処理実行
int ret = directPrint.print(fileName, password);
if(ret != 0) {
Exception e = directPrint.getException();
if(e != null) {
resultMessage = e.getMessage();
}
}
else{
resultMessage = "Success !!";
}
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 //EN">
<HTML>
<HEAD>
<TITLE>My sample</TITLE>
</HEAD>
<BODY bgcolor="WhiteSmoke">
<DIV align="center" style="center; padding-top: 25px;">
<P><FONT size="+2">Sample(IM-PDFDirectPrint)</FONT></P>
<CENTER>
<TABLE border="1">
<TR>
<TH align="right" style="padding: 5px 10px;" nowrap>PDF File</TH>
<TD align="left" style="padding: 5px 10px;" nowrap><%= fileName %></TD>
</TR>
<TR>
<TH align="right" style="padding: 5px 10px;" nowrap>Printer</TH>
<TD align="left" style="padding: 5px 10px;" nowrap><%= printerName %></TD>
</TR>
<TR>
<TH align="right" style="padding: 5px 10px;" nowrap>Result Code</TH>
<TD align="left" style="padding: 5px 10px;" nowrap><%= ret %></TD>
</TR>
<TR>
<TH align="right" style="padding: 5px 10px;" nowrap>Message</TH>
<TD align="left" style="padding: 5px 10px;" nowrap><%= resultMessage %></TD>
</TR>
</TABLE>
</CENTER>
</DIV>
</BODY>
<HTML>
コラム
プリンタ名は環境に合わせて指定ください。
プログラム実行¶
準備¶
実行させるための準備の手順を説明します。
メニュー設定¶
テナント管理者でログインし、以下のメニューを設定します。
[テナント管理]-[メニュー]画面を開きます。
フォルダを作成します。
URLに、DirectPrintSample.jsp を設定し、メニューを追加します。
メニュー設定は完了です。
プログラム実行¶
メニューで『DirectPrintSample』を選択してください。作成したJSPファイルが実行されます。JSP の実行エラー（コンパイルエラー）になってしまった場合には、エラーメッセージの内容に従いJSP プログラムを修正してください。JSP プログラムが正しく動作しているにも関わらず実行時エラーになってしまう場合は、エラーの内容にしたがって環境を正しく構築してください（環境を変更した場合は、サーバの再起動が必要になる場合があります）。
コラム
PDFファイルを画像に変換してから印刷する機能（setImage）は、特殊な図面やプリンタ向けの機能です。通常は設定不要です。