Document Annotation Java Cloud REST API

GroupDocs.Annotation Cloud SDK untuk Java membantu Anda membangun aplikasi Annotator Dokumen Cloud Java yang bekerja tanpa menginstal perangkat lunak pihak ketiga apa pun. Ini adalah pembungkus di sekitar GroupDocs.Annotation Cloud REST APIs.

Persyaratan

• Versi Java: Membangun pustaka klien API memerlukan Java 1.7+.
• Alat Pembangun: Maven diperlukan untuk mengelola ketergantungan dan membangun proyek.

Prasyarat

• Akun GroupDocs Cloud: Untuk menggunakan GroupDocs.Annotation Cloud SDK untuk Java, Anda perlu mendaftar akun dengan GroupDocs Cloud.
• ID Klien & Rahasia Klien: Setelah mendaftar, Anda perlu mencari atau membuat ID Klien dan Rahasia Klien di Dashboard Cloud.
• Kuota Gratis: GroupDocs Cloud menawarkan kuota gratis untuk pengguna baru. Untuk informasi lebih lanjut, Anda harus memeriksa Harga GroupDocs Cloud.

Instal GroupDocs.Annotation-Cloud dari Maven

Untuk menginstal GroupDocs.Annotation Cloud SDK untuk Java, Anda perlu menambahkan repositori GroupDocs Cloud ke file pom.xml aplikasi Anda:

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

Instal dari Sumber

Untuk menginstal pustaka klien API dari kode sumber, ikuti langkah-langkah berikut:

• Instal ke Repositori Maven Lokal: Untuk menginstal pustaka ke repositori Maven lokal Anda, cukup jalankan perintah berikut di terminal:

mvn clean install

• Deploy ke Repositori Maven Jarak Jauh: Jika Anda ingin mendistribusikannya ke repositori Maven jarak jauh, konfigurasikan pengaturan repositori dan jalankan perintah berikut:

mvn clean deploy

Untuk informasi lebih lanjut tentang penerapan ke repositori jarak jauh, lihat Panduan OSSRH.

Pengguna Maven

Jika Anda adalah pengguna Maven, Anda dapat menambahkan GroupDocs.Annotation Cloud SDK untuk Java sebagai dependensi dalam file pom.xml proyek Anda:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation-cloud</artifactId>
    <version>22.2</version>
    <type>pom</type>
</dependency>

Memulai

Untuk memulai dengan GroupDocs.Annotation Cloud SDK untuk Java, ikuti langkah-langkah berikut:

1. Instal SDK: Instal SDK dengan mengikuti langkah-langkah yang diuraikan di atas (menggunakan Maven atau menginstal dari sumber).
2. Konfigurasi: Atur konfigurasi menggunakan ID Klien dan Rahasia Klien yang diperoleh dari Dashboard GroupDocs Cloud.
3. Kode Contoh: Implementasikan kode contoh dalam aplikasi Anda untuk menambahkan anotasi, mengekstrak informasi dokumen, atau mengelola file dan folder.
4. Dokumentasi: Rujuk ke petunjuk Memulai Cepat dan dokumentasi API untuk contoh penggunaan terperinci dan informasi tambahan.

Otorisasi & Otentikasi

GroupDocs.Annotation Cloud SDK untuk Java menggunakan OAuth 2.0 untuk otorisasi dan otentikasi. Detail berikut disediakan:

• Jenis Otorisasi: OAuth 2.0
• Alur: Otorisasi berbasis aplikasi
• URL Otorisasi: https://api.groupdocs.cloud/connect/token
• Masa Berlaku Token: 1 hari (secara default)

JWT

GroupDocs.Annotation Cloud SDK menggunakan JSON Web Tokens (JWT) untuk akses API yang aman:

• Jenis Token: OAuth 2.0 JWT (JSON Web Token)
• URL Otorisasi: Token dihasilkan menggunakan endpoint https://api.groupdocs.cloud/connect/token.
• Kedaluwarsa Token: Masa berlaku token default adalah 1 hari, memastikan akses yang aman dan terikat waktu ke API.

Detail ini memberikan panduan komprehensif untuk menyiapkan dan menggunakan GroupDocs.Annotation Cloud SDK untuk Java, mencakup persyaratan penting, langkah-langkah instalasi, dan konfigurasi keamanan.

Berikut adalah dua cuplikan kode paling dapat dijual yang diekstrak dari konten yang disediakan. Cuplikan ini menunjukkan fungsionalitas penting yang akan menarik bagi calon pengguna yang ingin mengintegrasikan kemampuan anotasi ke dalam aplikasi mereka.

Kode Contoh Cloud Java untuk Menambahkan Anotasi Titik

Cuplikan ini menunjukkan cara menambahkan anotasi titik ke dokumen menggunakan GroupDocs.Annotation Cloud SDK untuk Java. Anotasi titik berguna untuk menandai titik tertentu dalam dokumen dengan komentar atau catatan.

// Untuk contoh lengkap dan file data, silakan kunjungi https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Buat anotasi.
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Point pt = new Point();
pt.setX(1.0);
pt.setY(1.0);
annotations[0].setAnnotationPosition(pt);

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(200.0);
r.setHeight(100.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.POINT);
annotations[0].setText("Ini adalah anotasi titik");
annotations[0].setCreatorName("Anonym A.");

// Buat objek perm

intaan.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\one-page.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/one-page-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Menjalankan metode API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Anotasi Titik ditambahkan: " + result.getTitle());

Kode Contoh Cloud Java untuk Menambahkan Anotasi TextHighlight

Cuplikan kode ini menunjukkan cara menambahkan anotasi sorotan teks ke dokumen. Menyoroti teks adalah tugas anotasi umum, terutama dalam proses tinjauan, dan cuplikan ini mengilustrasikan bagaimana hal itu dapat dilakukan secara programatis.

// Untuk contoh lengkap dan file data, silakan kunjungi https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Buat anotasi.
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(300.0);
r.setHeight(50.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.TEXT_HIGHLIGHT);
annotations[0].setText("Teks ini disorot");
annotations[0].setCreatorName("Anonym A.");

// Buat objek permintaan.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\sample.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/sample-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Menjalankan metode API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Anotasi Sorotan Teks ditambahkan: " + result.getTitle());