Java PDF 注釈: GroupDocs.Annotation for Java を使用して注釈と返信を作成および管理する

導入

PDF文書内の注釈管理は、特にデジタル文書の普及が進むにつれて、煩雑になりがちです。このチュートリアルでは、Java AnnotatorとGroupDocs.Annotationを使用して、文書へのコメントやフィードバックの追加と管理を効率化する方法を説明します。

学習内容:

Java プロジェクトで GroupDocs.Annotation ライブラリを初期化します。
注釈管理用のユーザープロファイルを作成します。
PDF ドキュメントに領域注釈を設定して適用します。
共同フィードバックのために注釈に返信を添付します。
GroupDocs.Annotation 機能を使用して、注釈付き PDF を効率的に保存します。

始める前に、セットアッププロセスをスムーズに進めるための前提条件をいくつか確認しましょう。

前提条件

必要なライブラリと依存関係

開発を容易にするために、システムにJavaとIntelliJ IDEAやEclipseなどのIDEがインストールされていることを確認してください。また、依存関係を管理するためにビルドツールとしてMavenも必要です。

環境設定要件

Java Development Kit (JDK) 8 以降をインストールします。
好みの IDE で Maven プロジェクトを設定します。

知識の前提条件

JavaプログラミングとPDF注釈の基礎知識があれば役立ちますが、必須ではありません。始めるために必要なことはすべて網羅しています。

Java 用の GroupDocs.Annotation の設定

GroupDocs.Annotation for Java を使用するには、必要な依存関係を含めるように Maven を構成します。

Mavenの設定

次のリポジトリと依存関係の設定を pom.xml ファイル：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/annotation/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

ライセンス取得手順

GroupDocsは、機能をお試しいただける無料トライアルを提供しています。長期間ご利用いただくには、一時ライセンスのお申し込み、またはプロジェクトに長期的なコミットメントが必要な場合はライセンスのご購入をご検討ください。

無料トライアル: ライブラリをダウンロードするには GroupDocs リリースページそして実験を始めます。
一時ライセンス: 一時ライセンスを申請するには GroupDocs 購入ページ.
購入： フルアクセスをご希望の場合は、 GroupDocs 購入ページ.

基本的な初期化とセットアップ

JavaアプリケーションでGroupDocs.Annotationを初期化するには、次のインスタンスを作成します。 Annotator 入力PDFファイル:

import com.groupdocs.annotation.Annotator;

public class InitializeAnnotation {
    public static void main(String[] args) {
        String inputFile = "YOUR_DOCUMENT_DIRECTORY/input.pdf";
        final Annotator annotator = new Annotator(inputFile);
    }
}

実装ガイド

実装プロセスを個別の機能に分解してみましょう。

機能1: アノテーターの初期化

概要： この機能は、JavaアプリケーションをGroupDocs.Annotationで動作するように設定し、 Annotator 物体。

ステップバイステップの実装

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public static void main(String[] args) {
        String inputFile = "YOUR_DOCUMENT_DIRECTORY/input.pdf"; // 入力PDFパスを定義する
        final Annotator annotator = new Annotator(inputFile); // 入力ファイルで Annotator を初期化する
    }
}

説明： この手順は、指定された PDF ドキュメントをメモリに読み込み、GroupDocs.Annotation と対話するようにアプリケーションを設定するため、非常に重要です。

機能2: ユーザーの作成

概要： ユーザープロファイルを作成すると、注釈や返信を効率的に管理できます。各ユーザーにドキュメント内のコメントや返信を割り当てることができます。

ステップバイステップの実装

import com.groupdocs.annotation.models.User;
import java.util.Calendar;

public class Feature2 {
    public static void main(String[] args) {
        User user1 = new User();
        user1.setId(1);
        user1.setName("Tom");
        user1.setEmail("somemail@mail.com");

        User user2 = new User();
        user2.setId(2);
        user2.setName("Jack");
        user2.setEmail("somebody@mail.com");

        User user3 = new User();
        user3.setId(3);
        user3.setName("Mike");
        user3.setEmail("somemike@mail.com");
    }
}

説明： この機能は、注釈の管理に必要なユーザープロファイルを設定します。各 User オブジェクトは、ID、名前、電子メールで初期化されます。

機能3: エリア注釈の作成と設定

概要： この手順では、PDF ドキュメントに領域注釈を作成して、セクションを効果的に強調表示します。

ステップバイステップの実装

import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.PenStyle;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;
import java.util.Calendar;

public class Feature3 {
    public static void main(String[] args) {
        AreaAnnotation area = new AreaAnnotation();
        area.setBackgroundColor(65535);
        area.setBox(new Rectangle(100, 100, 100, 100)); // 注釈の位置とサイズを指定する
        area.setCreatedOn(Calendar.getInstance().getTime());
        area.setMessage("This is an area annotation");
        area.setOpacity(0.7); // 不透明度レベルを設定する
        area.setPageNumber(0);
        area.setPenColor(65535);
        area.setPenStyle(PenStyle.DOT);
        area.setPenWidth((byte) 3);
    }
}

説明： ここで、 AreaAnnotation オブジェクトを作成し、背景色、サイズなどのプロパティを設定します（Rectangle）、不透明度、ペンのスタイルなどを設定して、注釈の外観をカスタマイズできます。

機能4: 注釈への返信を作成する

概要： 注釈に返信を添付すると、ユーザーは注釈が付けられた領域内に直接コメントやフィードバックを追加できます。

ステップバイステップの実装

import com.groupdocs.annotation.models.Reply;
import com.groupdocs.annotation.models.User;
import java.util.ArrayList;
import java.util.Calendar;

public class Feature4 {
    public static void main(String[] args) {
        User user1 = new User();
        user1.setId(1);

        User user2 = new User();
        user2.setId(2);

        ArrayList<Reply> replies = new ArrayList<>();
        
        Reply reply1 = new Reply();
        reply1.setId(1);
        reply1.setComment("First comment");
        reply1.setRepliedOn(Calendar.getInstance().getTime());
        reply1.setUser(user1);

        Reply reply2 = new Reply();
        reply2.setId(2);
        reply2.setComment("Second comment");
        reply2.setRepliedOn(Calendar.getInstance().getTime());
        reply2.setUser(user2);

        replies.add(reply1);
        replies.add(reply2);
    }
}

説明： この機能はリンク Reply オブジェクトを注釈に追加して、ユーザーがコメントを残すことができる。 Reply ユーザーに関連付けられ、タイムスタンプが付けられます。

機能5: 返信を添付し、注釈付きドキュメントを保存する

概要： 注釈が準備できたら、返信とともに保存して、共同で注釈を付けたドキュメントを作成できます。

ステップバイステップの実装

import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;
import java.util.Arrays;

public class Feature5 {
    public static void main(String[] args) {
        Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input.pdf"); // PDFファイルで初期化する
        
        AreaAnnotation area = new AreaAnnotation();
        area.setBackgroundColor(65535);
        area.setBox(new Rectangle(100, 100, 100, 100));
        area.setMessage("This is an area annotation");
        area.setOpacity(0.7);
        area.setPageNumber(0);
        area.setPenColor(65535);
        area.setPenStyle(PenStyle.DOT);
        area.setPenWidth((byte) 3);

        User user1 = new User();
        user1.setId(1);

        ArrayList<Reply> replies = new ArrayList<>();
        
        Reply reply1 = new Reply();
        reply1.setId(1);
        reply1.setComment("First comment");
        reply1.setRepliedOn(Calendar.getInstance().getTime());
        reply1.setUser(user1);

        replies.add(reply1);

        area.setReplies(replies);
        annotator.add(area);
        
        annotator.save("YOUR_DOCUMENT_DIRECTORY/output.pdf"); // 注釈付き文書を保存する
    }
}

説明： この最後のステップでは、注釈に返信を添付し、注釈付きのPDFを保存する方法を説明します。入力ファイルと出力ファイルのパスが正しく設定されていることを確認してください。