<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation-cloud</artifactId>
<version>23.12</version>
</dependency>
copied!  
compile(group: 'com.groupdocs', name: 'groupdocs-annotation-cloud', version: '23.12')
copied!  
<dependency org="com.groupdocs" name="groupdocs-annotation-cloud" rev="23.12">
 <artifact name="groupdocs-annotation-cloud" ext="jar"/>
</dependency>
copied!  
libraryDependencies += "com.groupdocs" % "groupdocs-annotation-cloud" % "23.12"
copied!  

文档注释Java云REST API

产品 文档 演示 Swagger UI 样例 博客 支持 试用

GroupDocs.Annotation Cloud SDK for Java 帮助您构建无需安装任何第三方软件的云文档注释Java应用程序。它是 GroupDocs.Annotation Cloud REST API 的包装器。


系统要求

  • Java版本: 构建API客户端库需要Java 1.7+。
  • 构建工具: Maven用于管理依赖项并构建项目。

前提条件

  • GroupDocs Cloud账户: 要使用GroupDocs.Annotation Cloud SDK for Java,您需要在 GroupDocs Cloud 注册一个账户。
  • 客户端ID和客户端密钥: 注册后,您需要在 Cloud Dashboard 上查找或创建您的客户端ID和客户端密钥。
  • 免费配额: GroupDocs Cloud 为新用户提供免费配额。有关更多详情,您应查看 GroupDocs Cloud Pricing

从Maven安装GroupDocs.Annotation-Cloud

要安装GroupDocs.Annotation Cloud SDK for Java,您需要将GroupDocs Cloud存储库添加到应用程序的 pom.xml 文件中:

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

从源代码安装

要从源代码安装API客户端库,请按照以下步骤操作:

  • 安装到本地Maven存储库: 要将库安装到您的本地Maven存储库,只需在终端中执行以下命令:
mvn clean install
  • 部署到远程Maven存储库: 如果您希望将其部署到远程Maven存储库,请配置存储库设置并执行以下命令:
mvn clean deploy

有关部署到远程存储库的更多详情,请参考 OSSRH Guide

Maven用户

如果您是Maven用户,可以在项目的 pom.xml 文件中将GroupDocs.Annotation Cloud SDK for Java添加为依赖项:

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

快速入门

要快速入门使用GroupDocs.Annotation Cloud SDK for Java,请按以下步骤操作:

  1. 安装SDK: 按照上述步骤(使用Maven或从源代码安装)安装SDK。
  2. 配置: 使用从GroupDocs Cloud Dashboard获得的客户端ID和客户端密钥设置配置。
  3. 示例代码: 在您的应用程序中实现示例代码,以添加注释、提取文档信息或管理文件和文件夹。
  4. 文档: 参考快速入门说明和API文档,了解详细的使用示例和其他信息。

授权与认证

GroupDocs.Annotation Cloud SDK for Java使用OAuth 2.0进行授权和认证。以下提供了相关详情:

  • 授权类型: OAuth 2.0
  • 流程: 基于应用程序的授权
  • 授权URL: https://api.groupdocs.cloud/connect/token
  • 令牌有效期: 默认情况下为1天

JWT

GroupDocs.Annotation Cloud SDK使用JSON Web Tokens (JWT) 进行安全的API访问:

  • 令牌类型: OAuth 2.0 JWT (JSON Web Token)
  • 授权URL: 使用 https://api.groupdocs.cloud/connect/token 端点生成令牌。
  • 令牌过期: 默认令牌有效期为1天,确保对API的安全和时间限制访问。

这些详情为设置和使用GroupDocs.Annotation Cloud SDK for Java提供了全面的指南,涵盖了基本要求、安装步骤和安全配置。

以下是从提供的内容中提取的两个最具销售力的代码片段。这些片段展示了对于希望将注释功能集成到其应用程序中的潜在用户而言的基本功能。

添加点注释的云Java示例代码

该代码片段演示了如何使用GroupDocs.Annotation Cloud SDK for Java向文档添加点注释。点注释对于用评论或注释标记文档中的特定点非常有用。

// 获取完整的示例和数据文件,请访问 https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // 从 https://dashboard.groupdocs.cloud 获取AppKey和AppSID
String MyAppSid = ""; // 从 https://dashboard.groupdocs.cloud 获取AppKey和AppSID

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

// 创建注释。
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("这是一个点注释");
annotations[0].setCreatorName("Anonym A.");

// 创建请求对象。
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方法。
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: 点注释已添加: " + result.getTitle());

添加文本高亮注释的云Java示例代码

该代码片段展示了如何向文档添加文本高亮注释。文本高亮在审查过程中是一个常见的注释任务,这个片段展示了如何以编程方式实现这一点。

// 获取完整的示例和数据文件,请访问 https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // 从 https://dashboard.groupdocs.cloud 获取AppKey和AppSID
String MyAppSid = ""; // 从 https://dashboard.groupdocs.cloud 获取

AppKey和AppSID

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

// 创建注释。
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("此文本已高亮显示");
annotations[0].setCreatorName("Anonym A.");

// 创建请求对象。
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方法。
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: 文本高亮注释已添加: " + result.getTitle());

产品 文档 演示 Swagger UI 样例 博客 支持 试用

VersionRelease Date
23.122023年12月27日
23.42023年4月14日
22.22022年2月7日
18.42022年1月25日
18.72022年1月25日
21.22022年1月25日
21.62022年1月25日
20.102020年10月14日
19.52019年5月15日