当前位置：首页 > news >正文

TextIn ParseX文档解析SDK工具新增Java版本

news 2024/11/6 14:07:14

SDK功能介绍

SDK使用方法

SDK使用示例

TextIn ParseX通用文档解析是一款大模型友好的解析工具，支持将pdf文档、jpg、img图像等文件快速转换为markdown格式，支持各类表格、公式解析，帮助大语言模型的数据清洗和文档问答任务。此前，为了让用户获得文档解析引擎返回的丰富版面元素，我们推出了一系列的sdk函数（+link），包括目录树、公式、表格、图片、全文markdown等结果的获取函数；同时开源了前端可视化组件（+link），满足用户个性化的校对使用需求。

近日，为便于使用Java语言的开发者调用文档解析引擎，TextIn ParseX SDK工具新增Java版本。

SDK工具Java版地址：https://github.com/intsig-textin/parsex-sdk/tree/main/java

SDK功能介绍

这是一套标准的多平台支持的Java SDK，帮助开发者解析pdf_to_markdownRestful API返回结果，获取对应的版面元素的数据结构。

开发者只需下载jar包，并导入到自己的项目中即可使用。

SDK使用方法

在项目中引入jar包后即可使用。

# 以下为gradle的配置方式
implementation 'io.github.supperai:parse_sdk:1.0.1'# 以下为maven的配置方式
<dependency><groupId>io.github.supperai</groupId><artifactId>parse_sdk</artifactId><version>1.0.1</version>
</dependency>

SDK使用示例

示例展示了如何使用TextInParseX SDK来解析PDF文件并提取其中的各种元素。完整示例代码请访问上方Github链接，查看TextInParseX/src/test/TestSDK.java。

初始化

首先，导入必要的包并初始化 ParseXClient：

import com.textinparsex.ParseXClient;
import com.textinparsex.model.*;
import org.opencv.core.Mat;import java.util.List;public class TextInParseXExample {public static void main(String[] args) throws Exception {// 加载 OpenCV 库System.load("/path/to/opencv/library.so");// 初始化 ParseXClientParseXClient parseXClient = new ParseXClient("your_app_id_here", "your_secret_code_here");// 指定要分析的 PDF 文件路径String pdfFilePath = "/path/to/your/document.pdf";// 指定解析的api url，请参考api文档确定参数String apiUrl = "https://api.textin.com/ai/service/v1/pdf_to_markdown?markdown_details=1&apply_document_tree=1&page_details=1&get_image=both";// 开始分析文档Document result = parseXClient.beginAnalyzeDocumentFromUrl(pdfFilePath, apiUrl);// ... 后续代码}
}

获取 Markdown 内容

提取并打印文档的Markdown格式内容：

System.out.println("Markdown content:");
System.out.println(result.getAllMarkdown());

提取所有文本

获取并打印文档中的所有文本内容：

System.out.println("\nAll text in document:");
parseXClient.printAllElements(result.getAllText(), 0, 1000);

处理表格

获取并打印文档中的所有表格：

System.out.println("\nTotal tables in document:");
List<Table> tables = result.getAllTables();
for (int i = 0; i < tables.size(); i++) {System.out.println("Table " + (i + 1) + ":");parseXClient.printAllElements(tables.get(i));
}

处理段落和文本行

获取并打印文档中的所有段落和文本行：

System.out.println("\nTotal paragraphs in document:");
List<Paragraph> paragraphs = result.getAllParagraphs();
for (int pIdx = 0; pIdx < paragraphs.size(); pIdx++) {Paragraph paragraph = paragraphs.get(pIdx);System.out.println("\n--- Paragraph " + (pIdx + 1) + "/" + paragraphs.size() + " ---");System.out.println("Paragraph position: " + paragraph.getPos());List<Object> lines = paragraph.getLines();for (int lIdx = 0; lIdx < lines.size(); lIdx++) {Object line = lines.get(lIdx);System.out.println("  Line " + (lIdx + 1) + "/" + lines.size());if (line instanceof ContentTextLine) {ContentTextLine textLine = (ContentTextLine) line;System.out.println("    Line position: " + textLine.getPos());System.out.println("    Line text: " + textLine.getText());}}
}

处理图片

获取并打印文档中的所有图片信息：

System.out.println("\nTotal images in document:");
List<ContentImage> images = result.getAllImages();
for (int i = 0; i < images.size(); i++) {System.out.println("Image " + (i + 1) + ":");parseXClient.printAllElements(images.get(i));
}

处理 OpenCV Mat 图片

获取并打印文档中所有图片的OpenCV Mat对象：

System.out.println("\nTotal images (as OpenCV Mat) in document:");
List<Mat> cvImages = result.getAllImagesCvMat();
for (int i = 0; i < cvImages.size(); i++) {System.out.println("Image " + (i + 1) + " (as OpenCV Mat):");parseXClient.printAllElements(cvImages.get(i));
}

处理和保存带注释的图像

以下示例展示了如何处理文档中的每一页，为表格、图像、段落和文本行添加边界框，并保存结果图像：

public void processAndSaveImages() {String downloadImageUrl = "https://api.textin.com/ocr_image/download?";for (Page page : priDocument.getPages()) {Mat pageImg = downloadImageFromUrl(downloadImageUrl, page.getImageId());if (pageImg == null) continue;for (Table table : page.getTables()) {for (TableCell cell : table.getCells()) {Imgproc.rectangle(pageImg, new Point(cell.getPos().get(0), cell.getPos().get(1)),new Point(cell.getPos().get(4), cell.getPos().get(5)),new Scalar(0, 0, 255), 1);}}for (ContentImage image : page.getImages()) {Imgproc.rectangle(pageImg,new Point(image.getPos().get(0), image.getPos().get(1)),new Point(image.getPos().get(4), image.getPos().get(5)),new Scalar(0, 255, 255), 1);}for (Paragraph paragraph : page.getParagraphs()) {Imgproc.rectangle(pageImg,new Point(paragraph.getPos().get(0), paragraph.getPos().get(1)),new Point(paragraph.getPos().get(4), paragraph.getPos().get(5)),new Scalar(0, 255, 0), 5);for (Object line : paragraph.getLines()) {if (line instanceof ContentTextLine) {ContentTextLine textLine = (ContentTextLine) line;Imgproc.rectangle(pageImg,new Point(textLine.getPos().get(0), textLine.getPos().get(1)),new Point(textLine.getPos().get(4), textLine.getPos().get(5)),new Scalar(255, 0, 0), 1);}}}Imgcodecs.imwrite("image_result_" + page.getPageId() + ".jpg", pageImg);}
}

这个方法会为每个页面下载图像，然后在图像上绘制矩形来标注表格单元格（红色）、图像（黄色）、段落（绿色）和文本行（蓝色）。处理后的图像会以 "image_result_[页码].jpg" 的格式保存。

处理表格并保存为Excel

List<Table> tableList = result.getAllTables();
parseXClient.saveTablesAsExcel(tableList, "/your/path/to/example.xlsx");

这个方法会将表格转换为excel文件，并保存到指定路径。如果有多个表格，会生成多个sheet。

注意事项

使用此示例时，请确保：

替换 your_app_id_here 和 your_secret_code_here 为您的实际API ID和密钥。
更新 System.load() 中的路径，指向正确的OpenCV库文件。如果有完整OpenCV环境，可以使用System.loadLibrary(Core.NATIVE_LIBRARY_NAME)。
将 /path/to/your/document.pdf 替换为要分析的PDF文件的实际路径。

这个示例展示了如何使用TextIn ParseX SDK的主要功能，包括提取Markdown内容、文本、表格、段落、图片信息等。您可以根据需要修改这个示例，以适应您的具体使用场景。

如果没有OpenCV环境或版本不匹配，操作方法详细请见Github主页。