Belge Notlandırma Java Bulut REST API

GroupDocs.Annotation Cloud SDK for Java Java için bulut tabanlı Belge Notlandırma Uygulamaları oluşturmanıza yardımcı olur ve üçüncü taraf herhangi bir yazılım yüklemeden çalışır. Bu, GroupDocs.Annotation Cloud REST API’lerinin etrafında bir sarmalayıcıdır.

Gereksinimler

• Java Sürümü: API istemci kitaplığını oluşturmak için Java 1.7+ gereklidir.
• Yapı Aracı: Maven, bağımlılıkları yönetmek ve projeyi oluşturmak için gereklidir.

Ön Koşullar

• GroupDocs Bulut Hesabı: GroupDocs.Annotation Cloud SDK for Java’yı kullanmak için GroupDocs Bulut ile bir hesap oluşturmanız gerekmektedir.
• Müşteri Kimliği & Müşteri Sırrı: Kaydolduktan sonra, Bulut Panosundan Müşteri Kimliğinizi ve Müşteri Sırrınızı bulmanız veya oluşturmanız gerekecektir.
• Ücretsiz Kota: GroupDocs Bulut, yeni kullanıcılar için ücretsiz bir kota sunar. Daha fazla bilgi için GroupDocs Bulut Fiyatlandırması kontrol edilmelidir.

Maven’den GroupDocs.Annotation-Cloud’u Yükleme

GroupDocs.Annotation Cloud SDK for Java’yı yüklemek için, GroupDocs Bulut deposunu uygulamanızın pom.xml dosyasına eklemeniz gerekir:

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

Kaynaktan Yükleme

API istemci kitaplığını kaynak koddan yüklemek için şu adımları izleyin:

• Yerel Maven Deposuna Yükleyin: Kitaplığı yerel Maven deposuna yüklemek için terminalde şu komutu yürütün:

mvn clean install

• Uzak Maven Deposuna Dağıtın: Eğer uzak bir Maven deposuna dağıtmak istiyorsanız, depo ayarlarını yapılandırın ve şu komutu yürütün:

mvn clean deploy

Uzak bir depoya dağıtma hakkında daha fazla bilgi için OSSRH Kılavuzu başvurulmalıdır.

Maven Kullanıcıları

Maven kullanıcısıysanız, GroupDocs.Annotation Cloud SDK for Java’yı projenizin pom.xml dosyasına bağımlılık olarak ekleyebilirsiniz:

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

Başlangıç

GroupDocs.Annotation Cloud SDK for Java ile başlamak için şu adımları izleyin:

1. SDK’yı Yükleyin: Maven kullanarak veya kaynaktan yükleyerek yukarıda belirtilen adımları izleyin.
2. Yapılandırma: GroupDocs Bulut Panosu’ndan aldığınız Müşteri Kimliği ve Müşteri Sırrınızı kullanarak yapılandırmayı ayarlayın.
3. Örnek Kod: Uygulamanızda notlar eklemek, belge bilgilerini çıkarmak veya dosyaları ve klasörleri yönetmek için örnek kodu uygulayın.
4. Dokümantasyon: Detaylı kullanım örnekleri ve ek bilgiler için Hızlı Başlangıç talimatlarına ve API dokümantasyonuna başvurun.

Yetkilendirme ve Kimlik Doğrulama

GroupDocs.Annotation Cloud SDK for Java, yetkilendirme ve kimlik doğrulama için OAuth 2.0 kullanır. Aşağıdaki detaylar sağlanmıştır:

• Yetkilendirme Türü: OAuth 2.0
• Akış: Uygulama tabanlı yetkilendirme
• Yetkilendirme URL’si: https://api.groupdocs.cloud/connect/token
• Token Süresi: 1 gün (varsayılan olarak)

JWT

GroupDocs.Annotation Cloud SDK, API’ye güvenli erişim sağlamak için JSON Web Token’leri (JWT) kullanır:

• Token Türü: OAuth 2.0 JWT (JSON Web Token)
• Yetkilendirme URL’si: Token’ler https://api.groupdocs.cloud/connect/token uç noktası kullanılarak oluşturulur.
• Token Geçerlilik Süresi: Varsayılan token süresi 1 gündür, bu da API’ye güvenli, zaman sınırlı erişim sağlar.

Bu detaylar, GroupDocs.Annotation Cloud SDK for Java’nın kurulumu ve kullanımı hakkında kapsamlı bir rehber sunar, temel gereksinimleri, kurulum adımlarını ve güvenlik yapılandırmalarını kapsar.

İşte sağlanan içerikten alınmış, en çok satan iki kod snippet’i. Bu snippet’ler, uygulamalarına not ekleme yeteneklerini entegre etmek isteyen potansiyel kullanıcılara hitap edecek temel işlevselliği sergiler.

Nokta Notu Eklemek için Örnek Bulut Java Kodu

Bu snippet, GroupDocs.Annotation Cloud SDK for Java kullanarak bir belgeye nokta notu eklemenin nasıl yapılacağını gösterir. Nokta notları, belgede belirli noktaları yorumlar veya notlarla işaretlemek için kullanışlıdır.

// Tam örnekler ve veri dosyaları için lütfen https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples adresine gidin  
String MyAppKey = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın  
String MyAppSid = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın

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

// Notları oluşturun.  
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("Bu bir nokta notudur");  
annotations[0].setCreatorName("Anonym A.");

// İstek nesnesini oluşturun.  
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);

// API yöntemini yürütme.  
AnnotationApiLink result = apiInstance.annotate(request);  
System.out.println("AddPointAnnotation: Nokta Notu eklendi: " + result.getTitle());

Metin Vurgulama Notu Eklemek için Örnek Bulut Java Kodu

Bu kod snippet’i, bir belgeye metin vurgulama notu eklemenin nasıl yapılacağını gösterir. Metni vurgulamak, özellikle inceleme süreçlerinde yaygın bir notlandırma görevidir ve bu snippet, bunun programlı olarak nasıl yapılabileceğini gösterir.

// Tam örnekler ve veri dosyaları için lütfen https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples adresine gidin  
String MyAppKey = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın  
String MyAppSid = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın

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

// Notları oluşturun.  
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("Bu metin vurgulanmıştır");  
annotations[0].setCreatorName("Anonym A.");

// İstek nesnesini oluşturun.  
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);

// API yöntemini yürütme.  
AnnotationApiLink result = apiInstance.annotate(request);  
System.out.println("AddTextHighlightAnnotation: Metin Vurgulama Notu eklendi: " + result.getTitle());