public interface PdfTimeStampService
PdfTimeStampFactory
により生成されるPDFタイムスタンプサービスのインスタンスから修飾子とタイプ | メソッドと説明 |
---|---|
void |
generate()
PDFに対して文書タイムスタンプを付与します。
|
void |
generateLtv()
PDFに対して延長タイムスタンプを付与します。
|
PdfDocument |
getPdfDocument()
PDFの情報を取得します。
|
void |
jpgtopdf()
画像ファイル(JPG)をPDFに変換します。
|
void |
setHashAlgorithm(PdfTimeStampConst.HASH_ALGORITHM alg)
タイムスタンプトークンの取得に使用するハッシュアルゴリズムを設定します。
|
void |
setInputJpgList(java.lang.String[] inputJpgList)
変換対象のJPGファイルパス(フルパス)の配列を設定します。
|
void |
setInputPdf(java.lang.String pdffilepath,
java.lang.String secpasswd)
処理対象のPDFファイルパス(フルパス)、及び権限パスワードを設定します。
|
void |
setOutputPdf(java.lang.String pdffilepath)
処理結果PDFの出力先ファイルパス(フルパス)を設定します。
|
void |
setPolicy(PdfTimeStampConst.POLICY policy)
タイムスタンプトークンの取得に使用するタイムスタンプ局のポリシーを指定します。
|
void |
setResolution(int resolution)
画像ファイル(JPG)をPDFに変換する際の解像度を設定します。
|
void |
setSecurity128(java.lang.String openpasswd,
java.lang.String secpasswd,
PdfTimeStampConst.PDF_SECURITY_128_PRINT print,
PdfTimeStampConst.PDF_SECURITY_128_ACCESSBILITY edit,
PdfTimeStampConst.PDF_SECURITY_128_COPY copy,
PdfTimeStampConst.PDF_SECURITY_128_CHANGE addnote)
処理対象PDFに対してRC4 128ビットセキュリティを設定します。
|
void |
setSecurity40(java.lang.String openpasswd,
java.lang.String secpasswd,
PdfTimeStampConst.PDF_SECURITY_40_PRINT print,
PdfTimeStampConst.PDF_SECURITY_40_EDIT edit,
PdfTimeStampConst.PDF_SECURITY_40_COPY copy,
PdfTimeStampConst.PDF_SECURITY_40_ADDNOTE addnote)
処理対象PDFに対してRC4 40ビットセキュリティを設定します。
|
void |
setTsaUrl(java.lang.String tsaurl)
タイムスタンプ局の接続先URLを設定します。
|
void |
setTsaUser(java.lang.String id,
java.lang.String passwd)
タイムスタンプ局接続時の接続ID、パスワードを設定します。
|
int |
validate()
PDFのタイムスタンプを検証します。
|
PdfTimeStamp[] |
validateTs()
PDFのタイムスタンプを検証し、各タイムスタンプ情報に検証結果を設定します。
|
void generate() throws PdfTimeStampException
設定内容 | 必須 | 備考 |
---|---|---|
ハッシュアルゴリズム < setHashAlgorithm > |
〇 | タイムスタンプトークンの取得に使用するハッシュアルゴリズムを指定します。 |
ポリシー < setPolicy > |
〇 | タイムスタンプトークンの取得に使用するタイムスタンプ局のポリシーを指定します。 |
タイムスタンプ局接続先URL < setTsaUrl > |
〇 | タイムスタンプトークンの取得先となるタイムスタンプ局のURLを指定します。 |
タイムスタンプ局接続ID、パスワード < setTsaUser > |
〇 | タイムスタンプ局への接続に使用するユーザーID、パスワードを指定します。 |
処理対象PDFファイル(フルパス)、及び権限パスワード < setInputPdf > |
〇 | 文書タイムスタンプを付与するPDFのフルパス、権限パスワードを指定します。 |
処理結果PDFファイル出力先(フルパス) < setOutputPdf > |
〇 | 文書タイムスタンプを付与したPDFの出力先をフルパスで指定します。 |
RC4 40ビットセキュリティ < setSecurity40 > |
− | 文書タイムスタンプを付与したPDFに対するRC4 40ビットセキュリティを指定します。 40ビットセキュリティ、128ビットセキュリティの両方が指定されている場合、128ビットセキュリティが適用されます。 |
RC4 128ビットセキュリティ < setSecurity128 > |
− | 文書タイムスタンプを付与したPDFに対するRC4 128ビットセキュリティを指定します。 40ビットセキュリティ、128ビットセキュリティの両方が指定されている場合、128ビットセキュリティが適用されます。 |
setInputPdf
で設定した処理対象PDFファイルの情報をタイムスタンプ付与後PDFの情報に置き換えます。PdfTimeStampException
- 文書タイムスタンプの付与に失敗した場合、以下のエラーを例外で通知します。エラーコード | エラー内容 |
---|---|
PTS_CODE_ERROR_FILE_NOT_FOUND
(-101) |
タイムスタンプを付与するPDFが存在しません。 |
PTS_CODE_ERROR_FILE_READ_FAILURE
(-102) |
タイムスタンプを付与するPDFの読み込みに失敗しました。 |
PTS_CODE_ERROR_FILE_OUTPUT_FAILURE
(-103) |
タイムスタンプを付与したPDFの出力に失敗しました。 |
PTS_CODE_ERROR_TSA_CONNECT_FAILURE
(-104) |
タイムスタンプ局への接続に失敗しました。 |
PTS_CODE_ERROR_TOKEN_GET_FAILURE
(-105) |
タイムスタンプトークンの取得に失敗しました。 |
PTS_CODE_ERROR_TOKEN_EMBED_FAILURE
(-106) |
タイムスタンプトークンの埋め込みに失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_OTHER_FORMAT
(-114) |
処理対象外の形式のタイムスタンプが付与されています。 |
PTS_CODE_ERROR_TIMESTAMP_SERVICE
(-115) |
PDFタイムスタンプサービスのリモートサーバーへの接続に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPDIR
(-116) |
一時ディレクトリの作成に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPFILE
(-117) |
一時ファイルの作成に失敗しました。 |
PTS_CODE_ERROR_SECURITY
(-118) |
PDFセキュリティの付与に失敗しました。 |
PTS_CODE_ERROR_REQUIRED_PARAM
(-120) |
必須パラメータが設定されていません。 |
PTS_CODE_ERROR_UNEXPECTED
(-999) |
予期しないエラーが発生しました。 |
void generateLtv() throws PdfTimeStampException
設定内容 | 必須 | 備考 |
---|---|---|
ハッシュアルゴリズム < setHashAlgorithm > |
〇 | タイムスタンプトークンの取得に使用するハッシュアルゴリズムを指定します。 |
ポリシー < setPolicy > |
〇 | タイムスタンプトークンの取得に使用するタイムスタンプ局のポリシーを指定します。 |
タイムスタンプ局接続先URL < setTsaUrl > |
〇 | タイムスタンプトークンの取得先となるタイムスタンプ局のURLを指定します。 |
タイムスタンプ局接続ID、パスワード < setTsaUser > |
〇 | タイムスタンプ局への接続に使用するユーザーID、パスワードを指定します。 |
処理対象PDFファイル(フルパス)、及び権限パスワード < setInputPdf > |
〇 | 延長タイムスタンプを付与するPDFのフルパス、権限パスワードを指定します。 |
処理結果PDFファイル出力先(フルパス) < setOutputPdf > |
〇 | 延長タイムスタンプを付与したPDFの出力先をフルパスで指定します。 |
setInputPdf
で設定した処理対象PDFファイルの情報を延長タイムスタンプ付与後PDFの情報に置き換えます。PdfTimeStampException
- 延長タイムスタンプの付与に失敗した場合、以下のエラーを例外で通知します。PdfDocument getPdfDocument() throws PdfTimeStampException
設定内容 | 必須 | 備考 |
---|---|---|
処理対象PDFファイル(フルパス)、及び権限パスワード < setInputPdf > |
〇 | 情報を取得するPDFのフルパス、権限パスワードを指定します。 |
PdfTimeStampException
- 情報の取得に失敗した場合、以下のエラーを例外で通知します。エラーコード | エラー内容 |
---|---|
PTS_CODE_ERROR_FILE_NOT_FOUND
(-101) |
情報を取得するPDFが存在しません。 |
PTS_CODE_ERROR_FILE_READ_FAILURE
(-102) |
情報を取得するPDFの読み込みに失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_GET_FAILURE
(-108) |
タイムスタンプの取得に失敗しました。 |
PTS_CODE_ERROR_INFO_GET_FAILURE
(-113) |
PDF情報の取得に失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_OTHER_FORMAT
(-114) |
処理対象外の形式のタイムスタンプが付与されています。 |
PTS_CODE_ERROR_TIMESTAMP_SERVICE
(-115) |
PDFタイムスタンプサービスのリモートサーバーへの接続に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPDIR
(-116) |
一時ディレクトリの作成に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPFILE
(-117) |
一時ファイルの作成に失敗しました。 |
PTS_CODE_ERROR_REQUIRED_PARAM
(-120) |
必須パラメータが設定されていません。 |
PTS_CODE_ERROR_UNEXPECTED
(-999) |
予期しないエラーが発生しました。 |
int validate() throws PdfTimeStampException
設定内容 | 必須 | 備考 |
---|---|---|
処理対象PDFファイル(フルパス)、及び権限パスワード < setInputPdf > |
〇 | タイムスタンプの検証を行うPDFのフルパス、権限パスワードを指定します。 |
コード | 検証結果 |
---|---|
PTS_CODE_VALIDATE_SUCCESS
(0) |
付与されているタイムスタンプは有効です。 |
PTS_CODE_VALIDATE_TIMESTAMP_EXPIRATION
(1) |
付与されているタイムスタンプの有効期限が切れています。 |
PTS_CODE_VALIDATE_TIMESTAMP_CHANGED
(2) |
付与されているタイムスタンプのデータが改竄されています。 |
PTS_CODE_VALIDATE_TIMESTAMP_REVOCATION
(3) |
付与されているタイムスタンプが失効しています。 |
PdfTimeStampException
- タイムスタンプの検証に失敗した場合、以下のエラーを例外で通知します。エラーコード | エラー内容 |
---|---|
PTS_CODE_ERROR_FILE_NOT_FOUND
(-101) |
検証対象のPDFが存在しません。 |
PTS_CODE_ERROR_FILE_READ_FAILURE
(-102) |
検証対象のPDFの読み込みに失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_MISSING
(-107) |
タイムスタンプが付与されていません。 |
PTS_CODE_ERROR_TIMESTAMP_GET_FAILURE
(-108) |
タイムスタンプの取得に失敗しました。 |
PTS_CODE_ERROR_CRL_DISTRIBUTION_POINT_CONNECT_FAILURE
(-110) |
CRL配布ポイントへの接続に失敗しました。 |
PTS_CODE_ERROR_CRL_GET_FAILURE
(-111) |
CRLの取得に失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_OTHER_FORMAT
(-114) |
処理対象外の形式のタイムスタンプが付与されています。 |
PTS_CODE_ERROR_TIMESTAMP_SERVICE
(-115) |
PDFタイムスタンプサービスのリモートサーバーへの接続に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPDIR
(-116) |
一時ディレクトリの作成に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPFILE
(-117) |
一時ファイルの作成に失敗しました。 |
PTS_CODE_ERROR_VALIDATE_FAILED
(-119) |
タイムスタンプの検証に失敗しました。 |
PTS_CODE_ERROR_REQUIRED_PARAM
(-120) |
必須パラメータが設定されていません。 |
PTS_CODE_ERROR_UNEXPECTED
(-999) |
予期しないエラーが発生しました。 |
PdfTimeStamp[] validateTs() throws PdfTimeStampException
getValidateResult
>設定内容 | 必須 | 備考 |
---|---|---|
処理対象PDFファイル(フルパス)、及び権限パスワード < setInputPdf > |
〇 | タイムスタンプの検証を行うPDFのフルパス、権限パスワードを指定します。 |
PdfTimeStampException
- タイムスタンプの検証に失敗した場合、以下のエラーを例外で通知します。エラーコード | エラー内容 |
---|---|
PTS_CODE_ERROR_FILE_NOT_FOUND
(-101) |
検証対象のPDFが存在しません。 |
PTS_CODE_ERROR_FILE_READ_FAILURE
(-102) |
検証対象のPDFの読み込みに失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_MISSING
(-107) |
タイムスタンプが付与されていません。 |
PTS_CODE_ERROR_TIMESTAMP_GET_FAILURE
(-108) |
タイムスタンプの取得に失敗しました。 |
PTS_CODE_ERROR_CRL_DISTRIBUTION_POINT_CONNECT_FAILURE
(-110) |
CRL配布ポイントへの接続に失敗しました。 |
PTS_CODE_ERROR_CRL_GET_FAILURE
(-111) |
CRLの取得に失敗しました。 |
PTS_CODE_ERROR_TIMESTAMP_OTHER_FORMAT
(-114) |
処理対象外の形式のタイムスタンプが付与されています。 |
PTS_CODE_ERROR_TIMESTAMP_SERVICE
(-115) |
PDFタイムスタンプサービスのリモートサーバーへの接続に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPDIR
(-116) |
一時ディレクトリの作成に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPFILE
(-117) |
一時ファイルの作成に失敗しました。 |
PTS_CODE_ERROR_VALIDATE_FAILED
(-119) |
タイムスタンプの検証に失敗しました。 |
PTS_CODE_ERROR_REQUIRED_PARAM
(-120) |
必須パラメータが設定されていません。 |
PTS_CODE_ERROR_UNEXPECTED
(-999) |
予期しないエラーが発生しました。 |
void setHashAlgorithm(PdfTimeStampConst.HASH_ALGORITHM alg)
alg
- ハッシュアルゴリズム(PdfTimeStampConst.HASH_ALGORITHM
)void setInputPdf(java.lang.String pdffilepath, java.lang.String secpasswd)
pdffilepath
- PDFファイルパス(フルパス)secpasswd
- 権限パスワード
参照パスワードのみが設定されている場合は参照パスワードを指定します。
パスワードが設定されていない場合はnullを指定してください。
void setOutputPdf(java.lang.String pdffilepath)
pdffilepath
- PDFファイルパス(フルパス)void setPolicy(PdfTimeStampConst.POLICY policy)
policy
- ポリシー(PdfTimeStampConst.POLICY
)void setSecurity128(java.lang.String openpasswd, java.lang.String secpasswd, PdfTimeStampConst.PDF_SECURITY_128_PRINT print, PdfTimeStampConst.PDF_SECURITY_128_ACCESSBILITY edit, PdfTimeStampConst.PDF_SECURITY_128_COPY copy, PdfTimeStampConst.PDF_SECURITY_128_CHANGE addnote)
openpasswd
- 参照パスワードsecpasswd
- 権限パスワードprint
- 印刷セキュリティ設定(PdfTimeStampConst.PDF_SECURITY_128_PRINT
)edit
- アクセスセキュリティ設定(PdfTimeStampConst.PDF_SECURITY_128_ACCESSBILITY
)copy
- コピーセキュリティ設定(PdfTimeStampConst.PDF_SECURITY_128_COPY
)addnote
- 文書変更セキュリティ設定(PdfTimeStampConst.PDF_SECURITY_128_CHANGE
)void setSecurity40(java.lang.String openpasswd, java.lang.String secpasswd, PdfTimeStampConst.PDF_SECURITY_40_PRINT print, PdfTimeStampConst.PDF_SECURITY_40_EDIT edit, PdfTimeStampConst.PDF_SECURITY_40_COPY copy, PdfTimeStampConst.PDF_SECURITY_40_ADDNOTE addnote)
openpasswd
- 参照パスワードsecpasswd
- 権限パスワードprint
- 印刷セキュリティ設定(PdfTimeStampConst.PDF_SECURITY_40_PRINT
)edit
- 編集セキュリティ設定(PdfTimeStampConst.PDF_SECURITY_40_EDIT
)copy
- コピーセキュリティ設定(PdfTimeStampConst.PDF_SECURITY_40_COPY
)addnote
- 注釈追記セキュリティ設定(PdfTimeStampConst.PDF_SECURITY_40_ADDNOTE
)void setTsaUrl(java.lang.String tsaurl)
tsaurl
- 接続先URLvoid setTsaUser(java.lang.String id, java.lang.String passwd)
id
- 接続IDpasswd
- パスワードvoid setInputJpgList(java.lang.String[] inputJpgList)
inputJpgList
- JPGファイルパス(フルパス)の配列void setResolution(int resolution)
resolution
- 解像度void jpgtopdf() throws PdfTimeStampException
設定内容 | 必須 | 備考 |
---|---|---|
変換対象のJPGファイルパス(フルパス)の配列 < setInputJpgList > |
〇 | PDFに変換するJPGファイルパス(フルパス)の配列を指定します。 |
解像度 < setResolution > |
〇 | 画像ファイル(JPG)をPDFに変換する際の解像度を指定します。 解像度を指定することで画像ファイル(JPG)がPDFになった際の用紙サイズを調整することができます。 ※解像度を指定することで画素数が低下することはありません。 例 2,338画素×1,654画素=約387万画素 の画像ファイル(JPG)をPDF変換 ↓ 解像度 200dpiを設定 ↓ PDFの用紙サイズが 297mm×210mmのA4サイズ相当になります 撮影される際の写真の画素数設定ルールと、 PDFになった際にどれくらいの用紙サイズにしたいか、 を考えて解像度を設定ください。 電子帳簿保存法でスマートフォン/デジカメ対応をされる場合には、 総画素数の定めはありますが、解像度/用紙サイズの定めはありません。 撮影時の総画素数が387万画素以上になっていることだけが必須です。 撮影する機材の性能によりA4にすべて合わせるようなことは不可能なため、 dpiをいくつにするかを過剰に気にする必要はありません。 |
処理結果PDFファイル出力先(フルパス) < setOutputPdf > |
〇 | 画像ファイル(JPG)をPDFに変換する際の出力先をフルパスで指定します。 |
setInputJpgList
で設定した画像ファイルをPDFに変換します。PdfTimeStampException
- 画像ファイル(JPG)のPDFへの変換に失敗した場合、以下のエラーを例外で通知します。エラーコード | エラー内容 |
---|---|
PTS_CODE_ERROR_CREATE_TEMPDIR
(-116) |
一時ディレクトリの作成に失敗しました。 |
PTS_CODE_ERROR_CREATE_TEMPFILE
(-117) |
一時ファイルの作成に失敗しました。 |
PTS_CODE_ERROR_REQUIRED_PARAM
(-120) |
必須パラメータが設定されていません。 |
PTS_CODE_ERROR_IMGFILE_EXTENSION_INVALID
(-121) |
変換元の画像ファイルの拡張子が「.jpg」か「.jpeg」と異なります。 |
PTS_CODE_ERROR_IMGFILE_NOT_FOUND
(-122) |
変換元の画像ファイル(JPG)が存在しません。 |
PTS_CODE_ERROR_IMGFILE_READ_FAILURE
(-123) |
変換元の画像ファイル(JPG)の読み込みに失敗しました。 |
PTS_CODE_ERROR_JPGTOPDF_RESOLUSION_INVALID
(-124) |
解像度に0以下が設定されています。 |
PTS_CODE_ERROR_JPGTOPDF_FAILURE
(-125) |
画像ファイル(JPG)のPDF変換に失敗しました。 |
PTS_CODE_ERROR_JPGTOPDF_FILE_OUTPUT_FAILURE
(-126) |
画像ファイル(JPG)を変換したPDFの出力に失敗しました。 |
PTS_CODE_ERROR_UNEXPECTED
(-999) |
予期しないエラーが発生しました。 |