←前へ 目次↑ 次へ→

3.2. CTIP 1.0 インターフェースの特徴

Copper PDF 2.1.0からは、より強力なインターフェース(CTIP 2.0)と、より手軽なHTTP/RESTインターフェースを使用可能です。 従来のインターフェースもサポートされていますが、新しいインターフェースの使用を検討してください。

3.2.1. 結果サイズの取得

HTTPのContent-Lengthヘッダを送るためには、結果全体のデータのバイト数を事前に知る必要がありますが、 CTIP 1.0ではプログレスリスナをその目的に使用することができます。 プログレスリスナが要求した場合は、変換結果の先頭が得られる前に、結果全体のデータのバイト数が渡されます。

3.2.2. メッセージハンドラ(エラーハンドラ)の設定

エラーハンドラは、変換処理の過程で出力された警告やエラー、処理情報を受け取るためのインターフェースです (処理情報を受け取る機能は後で追加されたため「エラーハンドラ」という名前になっています)。 エラーハンドラが受け取ることができるメッセージは以下の4つに分類されます。

種類 コード 説明
警告 1 処理の続行が可能なエラーです。 入出力設定や、変換対象文書に問題がありますが、処理結果自体は得ることができます。
エラー 2 処理の続行が不可能になるか、出力結果を得られなくなるエラーです。 このエラーが発生した場合、正常な処理結果が得られることは期待できません(PDF等のデータが壊れている可能性があります)。
致命的エラー 3 通信障害など、システムの問題に起因する深刻なエラーです。 このエラーが発生した場合、正常な処理結果が得られることは期待できません(PDF等のデータが壊れている可能性があります)。
処理情報 4 これはエラーメッセージではありません。 出力済みのページ数、処理中の内容などの情報です。

以上のうち、コード4の処理情報は "カテゴリ:値" という形式で渡されます (Java版のドライバではカテゴリと値を別々に受け取ることもできます)。 カテゴリと値は、資料集のメッセージハンドラから取得できる情報を参照してください。

3.2.3. CTIP 1.0 プロトコルの仕様

プロトコルの仕様書は、以下のアドレスで公開しています。
http://sourceforge.jp/projects/copper/docs/ctip-v1


←前へ 目次↑ 次へ→
Copper PDF ©2012 Zamasoft. All rights reserved.