Java を使用して PDF にバーコード署名を作成する方法

このチュートリアルでは、Java と GroupDocs.Signature を使用して PDF ファイルに バーコード署名 を作成する方法を学びます。バーコード署名は、機械読み取り可能な識別子を埋め込み、改ざん防止かつスキャンが容易です—契約書、証明書、請求書、そして信頼できる検証が必要なあらゆる文書に最適です。

クイック回答

バーコード署名とは何ですか？ PDF に埋め込まれたバーコードで、構造化データを保存し、スキャナーやソフトウェアで読み取れます。
どのバーコードタイプがおすすめですか？ Code128。英数字データをコンパクトに扱えるためです。
ライセンスは必要ですか？ テスト用の無料トライアルで動作しますが、本番環境ではフルライセンスが必要です。
任意のページサイズにバーコードを配置できますか？ はい—パーセンテージベースの位置指定を使用すれば自動スケーリングが可能です。
バーコードはベクター形式ですか？ はい、PDF に数キロバイトしか追加せず、どの解像度でも鮮明です。

バーコード署名が PDF に重要な理由

おそらく直面したことがある課題です：機械読み取り可能で改ざん防止のユニークな識別子を PDF に追加する必要がある。文書管理システムで証明書を処理したり、後で検証が必要な契約書を扱ったりしているかもしれません。

そこでバーコード署名が便利になります。単なるテキストスタンプとは異なり、バーコードはスキャナー（および自社ソフトウェア）が即座に読み取れる構造化データを埋め込めます。さらに、GroupDocs.Signature for Java を介した PDF 署名と組み合わせることで、複雑なデータベース参照を追加せずに文書の追跡と検証が可能になる強力な手段が手に入ります。

このガイドでは、Java PDF にバーコード署名を実装する方法を、基本設定から本番環境向けコード、柔軟な位置指定まで正確に学べます。請求書システム、証明書ジェネレータ、契約管理プラットフォームを構築する場合でも、最後まで必要なすべてが揃います。

習得できること:

数分で GroupDocs.Signature for Java をセットアップする方法
Code128 バーコード署名の作成（なぜこれが最適な選択肢になるのか）
任意の PDF サイズで機能するパーセンテージベースのレイアウトによるバーコードの位置指定
開発者が陥りやすい一般的な落とし穴の回避策
実装の適切なテスト方法

開始前に必要なもの

以下の必須項目を用意してください：

必要なライブラリ:

GroupDocs.Signature for Java（バージョン 23.12 以降推奨）

開発環境:

JDK 8 以上がインストール済み
お好みの IDE（IntelliJ IDEA、Eclipse、または Java 拡張機能付き VS Code）
依存関係管理のための Maven または Gradle

スキルレベル: 基本的な Java 文法に慣れていて、ファイル操作ができれば問題ありません。簡単な Java クラスを作成し、例外処理ができれば準備完了です。

プロジェクトへの GroupDocs.Signature の設定

ライブラリをプロジェクトに組み込むのは簡単です。使用するビルドツールを選んでください：

Maven ユーザー向け、pom.xml に以下を追加します:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

Gradle を使用していますか？ build.gradle にこの行を追加します:

implementation 'com.groupdocs:groupdocs-signature:23.12'

手動セットアップを好む場合、GroupDocs.Signature for Java releases から JAR を直接ダウンロードし、クラスパスに追加してください。

ライセンスの取得

本番環境に移行する前に、ライセンスの取り扱いを行う必要があります：

Free Trial: テストに最適—GroupDocs のウェブサイトから取得し、コア機能を試せます
Temporary License: 評価期間を延長したいですか？30 日間の一時ライセンスを申請してください
Full License: 本番運用の準備ができましたか？無制限に使用できるライセンスを購入してください

すべてが正常に動作するか簡単に確認するコードです:

import com.groupdocs.signature.Signature;

public class QuickTest {
    public static void main(String[] args) {
        try {
            Signature signature = new Signature("test-document.pdf");
            System.out.println("GroupDocs.Signature is ready to go!");
        } catch (Exception e) {
            System.err.println("Setup issue: " + e.getMessage());
        }
    }
}

エラーなく実行できたら、準備完了です！

Java でバーコード署名を作成する方法

さあ楽しいパートです—バーコードで PDF に署名しましょう。各ステップを分かりやすく分解して説明します。

手順 1: Signature オブジェクトの初期化

まず、対象の PDF を GroupDocs に伝える必要があります:

String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf";
Signature signature = new Signature(filePath);

ここで何が起きているか: Signature オブジェクトが PDF をメモリに読み込み、変更の準備をします。ファイルパスが正しいことを確認してください—Windows でバックスラッシュをエスケープせずに使用するとエラーになることが多いです（\\ を使うか、クロスプラットフォームで動作するスラッシュ / を使用してください）。

手順 2: バーコードオプションの設定（バーコードの追加方法）

次に、データを使ってバーコード署名を作成します:

import com.groupdocs.signature.options.sign.BarcodeSignOptions;
import com.groupdocs.signature.domain.barcodes.BarcodeTypes;

BarcodeSignOptions options = new BarcodeSignOptions("12345678");
options.setEncodeType(BarcodeTypes.Code128);

分解すると:

"12345678" はバーコードに埋め込むデータです—注文 ID、証明書番号、または任意の識別子に利用できます
Code128 はエンコーディングタイプです（適切なタイプの選び方は下記参照）

プロのコツ: Code128 は数字と文字の両方を扱えるため、ほとんどのユースケースで汎用性が高いです。数字だけで良い場合は Code39 でも構いませんが、Code128 の方が柔軟性があります。

手順 3: バーコードの位置指定（PDF にバーコードで署名する方法）

ここが GroupDocs の強みです—パーセンテージベースの位置指定により、どの PDF サイズでもバーコードが見栄え良く表示されます:

import com.groupdocs.signature.domain.enums.MeasureType;
import com.groupdocs.signature.domain.Padding;

// Use percentages instead of fixed pixels
options.setLocationMeasureType(MeasureType.Percents);
options.setLeft(5);  // 5% from the left edge
options.setTop(5);   // 5% from the top

// Size it proportionally too
options.setSizeMeasureType(MeasureType.Percents);
options.setWidth(10);  // 10% of page width
options.setHeight(5);  // 5% of page height

// Add some breathing room with margins
Padding margins = new Padding();
margins.setLeft(1);
margins.setTop(1);
margins.setRight(1);
options.setMargin(margins);

パーセンテージが重要な理由: A4 文書とリーガルサイズの用紙の両方に署名すると想像してください。パーセンテージ指定なら、バーコードは自動的に両方で一貫した見た目になります。固定ピクセル値だと、大きな文書では小さすぎ、小さな文書では大きすぎてしまいます。

実例: A4 ページ（595 × 842 ポイント）で幅 10% のバーコードは約 60 ポイントになります。リーガルページ（612 × 1008 ポイント）では約 61 ポイント—自動的に比例します。

手順 4: 文書に署名して保存する（PDF にバーコードを追加する方法）

いよいよ署名を適用し、ファイルを保存します:

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignWithPercents/sample_signed.pdf";
signature.sign(outputFilePath, options);

重要な注意点: 出力ディレクトリは事前に存在している必要があります。GroupDocs は自動でネストされたディレクトリを作成しないので、事前に作成するかコード内で処理してください:

Path outputPath = Paths.get(outputFilePath);
Files.createDirectories(outputPath.getParent());
signature.sign(outputFilePath, options);

何か問題が起きたら？ 以下のように try‑catch ブロックで囲みます:

try {
    signature.sign(outputFilePath, options);
    System.out.println("PDF signed successfully at: " + outputFilePath);
} catch (Exception e) {
    System.err.println("Signing failed: " + e.getMessage());
    e.printStackTrace();
}

ニーズに合ったバーコードタイプの選び方（code128 pdf バーコード）

GroupDocs は複数のバーコード形式をサポートしており、適切なものを選ぶことが重要です。実用的な比較を示します。

Code128（デフォルト選択）:

Best for: 英数字が混在するデータ（例: “INV2024-001”）
Capacity: 最大 128 文字の ASCII
Why it wins: コンパクトで広くサポートされ、文字と数字の両方を扱える
Use when: 柔軟性が必要で、エンコードするデータの種類が不明な場合

Code39:

Best for: シンプルな英数字コード
Capacity: 43 文字（A‑Z、0‑9、いくつかの記号）
Why consider it: 古いスキャナーでの互換性が高いことが多い
Use when: レガシーシステムと連携する場合や、データ密度よりシンプルさが重要な場合

QR Code:

Best for: 大量のデータ（URL、JSON ペイロード）
Capacity: 最大約 3 KB のデータ
Why it’s powerful: 複雑なデータ構造やエラー訂正を内蔵できる
Use when: 構造化データや URL を埋め込みたい場合

EAN/UPC:

Best for: 商品識別
Capacity: 固定長の数字コード（8‑13 桁）
Use when: 小売や在庫管理システムで使用する場合

クイック決定ガイド:

英字と数字が必要 → Code128
数字だけでシンプルに → Code39
大量データや URL → QR Code
小売・商品コード → EAN/UPC

よくある落とし穴と回避策

開発者が最も頻繁に直面する問題をまとめました（あなたが回避できるように）。

問題 1: バーコードの位置がずれる

症状: バーコードが予期しない場所に表示されたり、切り取られたりする。

一般的な原因:

異なるページサイズでピクセル値を使用している
PDF の座標系は左下が原点であることを忘れている（上左ではない）
マージンがコンテンツを可視領域外に押し出している

解決策:
一貫性のため常にパーセンテージベースの位置指定を使用してください:

options.setLocationMeasureType(MeasureType.Percents);
options.setLeft(5);  // 5% from left works on any page width

問題 2: バーコードのテキストが読めない

症状: エンコードされたテキストは表示されるが、スキャナーが読み取れない。

原因:

データ量に対してバーコードが小さすぎる
データに合わないエンコーディングタイプを使用している
解像度が低い、またはコントラストが不十分

解決策:
データ長に合わせてバーコードサイズを調整します。Code128 で 10‑15 文字の場合、ページ幅の 8‑10% 以上を目安にしてください:

options.setWidth(10);  // Give it room to breathe
options.setHeight(5);  // Maintain proper aspect ratio

問題 3: ファイルパス例外

症状: FileNotFoundException などのエラーが発生する。

原因:

Windows のパスを単一バックスラッシュでハードコーディングしている
出力ディレクトリが存在しない
ファイル権限の問題

解決策:
スラッシュ（/）を使用するとどこでも動作します。また、ディレクトリは事前に作成してください:

String filePath = "documents/sample.pdf";  // Works on Windows, Mac, Linux
Files.createDirectories(Paths.get("output/signed"));

問題 4: 大きな PDF のメモリ問題

症状: 大容量文書を処理するとメモリ不足エラーが発生する。

解決策:
処理が終わったら Signature オブジェクトを閉じてリソースを解放します:

try (Signature signature = new Signature(filePath)) {
    signature.sign(outputFilePath, options);
} // Automatically closes and releases memory

バーコード実装のテスト

デプロイ前に、バーコードが実際に機能することを確認してください。実用的なテストチェックリストを示します。

1. ビジュアル検査テスト

署名済み PDF を開いて以下を確認します:

バーコードは見える位置に正しく配置されているか
ぼやけていないか、ピクセル化していないか（鮮明か）
周囲に十分な余白があるか

2. スキャンテスト

スマートフォンのバーコードスキャナーアプリ（例: “Barcode Scanner” や “QR & Barcode Reader”）で検証します:

スキャナーがバーコードを読み取れるか
デコードされたデータがエンコードした内容と一致するか
異なる角度や距離でも読み取れるか

3. クロスプラットフォームテスト

異なるデバイスで PDF を開きます:

Windows（Adobe Reader、Chrome）
Mac（Preview、Chrome）
モバイルデバイス（iOS、Android）

すべての環境でバーコードが正しく表示されることを確認してください。

4. 自動テストコード

以下のシンプルなテストを実行できます:

import org.junit.Test;
import static org.junit.Assert.*;

public class BarcodeSignatureTest {
    
    @Test
    public void testBarcodeSigning() {
        String testPdf = "test-data/sample.pdf";
        String output = "test-output/signed.pdf";
        
        try (Signature signature = new Signature(testPdf)) {
            BarcodeSignOptions options = new BarcodeSignOptions("TEST123");
            options.setEncodeType(BarcodeTypes.Code128);
            
            signature.sign(output, options);
            
            // Verify output file exists
            assertTrue(new File(output).exists());
            
            // Verify file size increased (signature was added)
            long originalSize = new File(testPdf).length();
            long signedSize = new File(output).length();
            assertTrue(signedSize > originalSize);
            
        } catch (Exception e) {
            fail("Signing should not throw exception: " + e.getMessage());
        }
    }
}

バーコード署名の実際のユースケース

本技術が本番システムで真価を発揮するシーンを見てみましょう。

1. 証明書の生成と検証

シナリオ: 研修プラットフォームで修了証を発行する。
実装: ユニークな証明書 ID（例: “CERT‑2024‑00123”）を生成し、右下隅に Code128 バーコードとして埋め込む。バーコードをスキャンすると API が即座に証明書情報を取得でき、手入力が不要になる。

2. 請求書追跡システム

シナリオ: 月間数千件の請求書を処理する。
実装: 請求書番号と支払期限を QR コードとして配置し、スキャン装置が自動で読み取って仕分けできるようにする。これにより処理時間が数時間から数分に短縮される。

3. 法務契約管理

シナリオ: 法律事務所が契約書のバージョンと改訂履歴を追跡する必要がある。
実装: 各契約バージョンにユニークなバーコード識別子（契約 ID、バージョン番号、署名日）を付与。監査時にスキャンすると全履歴が自動で取得できる。

4. 医療記録のセキュリティ

シナリオ: 病院が不正アクセスを防止したい。
実装: 患者 ID と記録作成タイムスタンプをバーコードに埋め込む。認証済みデバイスだけがデコードでき、スキャンごとに監査ログが残るためコンプライアンスが向上する。

パフォーマンス最適化のヒント

多数の PDF に署名する場合、パフォーマンスは重要です。以下のポイントでスムーズに処理できます。

バッチ処理戦略

1 件ずつ署名する代わりに、バッチでまとめて処理します:

List<String> pdfFiles = Arrays.asList("doc1.pdf", "doc2.pdf", "doc3.pdf");

for (String pdfFile : pdfFiles) {
    try (Signature signature = new Signature(pdfFile)) {
        BarcodeSignOptions options = createBarcodeOptions(); // Reuse options
        signature.sign(getOutputPath(pdfFile), options);
    }
}

この方法の利点: オプションオブジェクトを再利用し、リソースを適切にクローズすることでメモリリークを防げます。

メモリ管理

サイズが大きい PDF（50 MB 超）を扱う場合:

複数同時にロードせず、順次処理する
try‑with‑resources を使って確実にクリーンアップする
ヒープサイズを監視し、必要に応じて JVM パラメータを調整する（例: -Xmx2g）

キャッシュ戦略

同一バーコードを繰り返し使用する場合はキャッシュを活用します:

// Create options once, reuse many times
BarcodeSignOptions templateOptions = createStandardBarcodeOptions();

// For each document, clone and customize
BarcodeSignOptions documentOptions = templateOptions.clone();
documentOptions.setText(uniqueDocumentId);

バーコード署名を使用すべき時（使用すべきでない時）

最適なシナリオ:

機械読み取り可能な文書識別子が必要
文書が自動スキャンや処理の対象になる
デジタル証明書なしで改ざん防止の追跡が欲しい
既存のバーコードインフラと統合したい

使用を控えるべきケース:

法的に有効なデジタル署名が必要（その場合はデジタル証明書を使用）
人間が読むだけの文書（テキストウォーターマークで十分）
非常に小さな文書でバーコードがページを支配してしまう場合
暗号化が必須で、バーコードは誰でもスキャン可能なため不適切

アプローチの併用は可能ですか？ はい！多くのシステムで、追跡用にバーコード署名、法的有効性のためにデジタル署名の両方を利用しています。

よくある質問

Q: 同じ PDF に異なるバーコードタイプを使用できますか？
A: はい！signature.sign() を複数回呼び出し、各バーコードに異なる BarcodeSignOptions を指定すれば実現できます。重なり合わないように注意してください。

Q: 特殊文字を含むバーコードはどう扱いますか？
A: Code128 はほとんどの ASCII 文字に対応しています。Unicode や複雑なデータの場合は QR コードに切り替えると UTF‑8 エンコードが利用可能です。

Q: Code128 バーコードに格納できる最大データ量は？
A: 理論上は 128 文字までですが、30‑40 文字を超えると可読性が大幅に低下します。大量データは QR コードをご検討ください。

Q: バーコードを追加すると PDF のサイズは大幅に増えますか？
A: 目立った増加はありません—バーコードはベクターグラフィックで、サイズや複雑さにもよりますが通常 5‑20 KB 程度の増加です。

Q: バーコードを回転させたり縦向きに配置できますか？
A: はい！options.setRotationAngle(90) を使用すれば、余白やマージンに合わせて回転させられます。

Q: 複数ページの PDF 全体にバーコードを付与したい場合は？
A: ページをループして各ページに署名を適用します。対象ページの制御は GroupDocs の PagesSetup クラスで行えます。

Q: スキャナーが生成されたバーコードを読めない場合は？
A: まずスキャナーが対象のバーコードタイプをサポートしているか確認し、次にバーコードサイズを大きくします。信頼できる読み取りには幅 1 インチ（約 2.54 cm）以上が目安です。

追加リソース

Documentation:

Downloads and Licensing:

Community and Support:

Support Forum - Active community with GroupDocs engineers

Last Updated: 2026-03-06
Tested With: GroupDocs.Signature 23.12 (Java)
Author: GroupDocs