Spring Boot 结合 Tess4J 可以实现高效的本地与远程图片处理功能。Tess4J 是一个 Java 封装的 Tesseract OCR 引擎，它提供了方便的接口来进行光学字符识别（OCR）。本文将通过一个具体的技术博客的形式，详细介绍如何在 Spring Boot 项目中集成 Tess4J，并实现对本地及远程图片的OCR处理。

首先，我们需要在项目中引入必要的依赖。对于 Spring Boot 项目，我们可以在 pom.xml 文件中添加以下依赖项：

<dependencies>
    <!-- Spring Boot Starter Web 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Tess4J 依赖 -->
    <dependency>
        <groupId>net.sourceforge.tess4j</groupId>
        <artifactId>tess4j</artifactId>
        <version>4.5.6</version>
    </dependency>

    <!-- Commons IO 用于处理文件流 -->
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.11.0</version>
    </dependency>

    <!-- Optional: 使用 Spring Boot DevTools 加快开发迭代 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>

    <!-- Test Dependencies -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

接下来，我们需要准备 Tesseract OCR 引擎所需的语言包。可以从 Tesseract OCR 官网 下载对应的语言包，然后将其放置在一个合适的位置，比如项目的 resources 目录下。

配置 OCR 引擎

在 Spring Boot 中，我们可以通过创建一个配置类来初始化 Tesseract OCR 引擎：

import net.sourceforge.tess4j.Tesseract;
import net.sourceforge.tess4j.TesseractException;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.io.File;

@Configuration
public class OcrConfig {
   

    @Bean
    public Tesseract tesseract() {
   
        Tesseract instance = new Tesseract();
        instance.setLanguage("eng"); // 设置语言包，这里使用英语
        instance.setDatapath("src/main/resources/tessdata"); // 设置语言包路径
        return instance;
    }
}

图片处理服务

接下来，我们创建一个服务类来处理图片：

import net.sourceforge.tess4j.Tesseract;
import net.sourceforge.tess4j.TesseractException;
import org.apache.commons.io.IOUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.stereotype.Service;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;

@Service
public class ImageOcrService {
   

    private final Tesseract tesseract;
    private final ResourceLoader resourceLoader;

    @Autowired
    public ImageOcrService(Tesseract tesseract, ResourceLoader resourceLoader) {
   
        this.tesseract = tesseract;
        this.resourceLoader = resourceLoader;
    }

    /**
     * 从本地文件路径读取图片并进行 OCR 处理
     * @param imagePath 图片文件路径
     * @return OCR 结果文本
     */
    public String ocrLocalImage(String imagePath) throws IOException, TesseractException {
   
        Resource imageResource = resourceLoader.getResource(imagePath);
        BufferedImage image = ImageIO.read(imageResource.getInputStream());
        return tesseract.doOCR(image);
    }

    /**
     * 从远程 URL 获取图片并进行 OCR 处理
     * @param imageUrl 图片 URL
     * @return OCR 结果文本
     */
    public String ocrRemoteImage(String imageUrl) throws IOException, TesseractException {
   
        byte[] imageData = IOUtils.toByteArray(new ByteArrayInputStream(IOUtils.toByteArray(imageUrl)));
        BufferedImage image = ImageIO.read(new ByteArrayInputStream(imageData));
        return tesseract.doOCR(image);
    }
}

控制器

最后，我们需要创建一个控制器来接收 HTTP 请求，并调用服务层的方法来处理图片：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.IOException;
import java.net.URL;

@RestController
public class OcrController {
   

    private final ImageOcrService imageOcrService;

    @Autowired
    public OcrController(ImageOcrService imageOcrService) {
   
        this.imageOcrService = imageOcrService;
    }

    @GetMapping("/ocr/local")
    public ResponseEntity<String> ocrLocalImage(@RequestParam("path") String imagePath) throws IOException, TesseractException {
   
        String result = imageOcrService.ocrLocalImage(imagePath);
        return ResponseEntity.ok(result);
    }

    @GetMapping("/ocr/remote")
    public ResponseEntity<String> ocrRemoteImage(@RequestParam("url") String imageUrl) throws IOException, TesseractException {
   
        String result = imageOcrService.ocrRemoteImage(imageUrl);
        return ResponseEntity.ok(result);
    }
}

测试

为了测试我们的服务是否正常工作，我们可以运行 Spring Boot 应用，并使用 Postman 或类似的工具发送 GET 请求到 /ocr/local 和 /ocr/remote 端点。例如：

• 本地图片处理：http://localhost:8080/ocr/local?path=file:/path/to/image.jpg
• 远程图片处理：http://localhost:8080/ocr/remote?url=https://example.com/path/to/image.jpg

总结

通过以上步骤，我们成功地在 Spring Boot 项目中集成了 Tess4J，并实现了本地和远程图片的 OCR 处理功能。这种方法不仅可以应用于文本识别场景，还可以扩展到其他图像处理任务中。希望本文能够帮助你更好地理解如何在 Spring Boot 中使用 Tess4J 进行 OCR 处理，为你的项目增添更多实用的功能。