SpringBoot实现电子文件签字+合同系统

news2024/11/18 18:43:57

博客主页: 南来_北往

系列专栏：Spring Boot实战

在现代企业中，合同管理和电子文件签字已成为日常运营不可或缺的一部分。为了提升效率和安全性，我们可以使用SpringBoot框架来实现一个电子文件签字和合同管理系统。本文将详细介绍如何通过SpringBoot实现这一系统。

一、系统概述

电子文件签字和合同管理系统主要涵盖两大核心功能：电子签章功能和合同管理功能。电子签章功能用于确保文件的真实性、完整性和不可否认性，而合同管理功能则用于管理合同的创建、审批、签署和存储。

二、技术选型

后端框架：SpringBoot
前端技术：Vue.js（可选，本文不详细讨论前端实现）
数据库：MySQL
依赖库：Apache POI（用于Word和PDF转换）、OpenPDF（用于PDF操作）、iText（用于PDF签名和水印）

三、系统设计与实现

1. 项目结构

项目使用Maven进行依赖管理，SpringBoot作为后端框架。项目结构通常包括以下几个主要模块：

Controller：负责处理HTTP请求。
Service：业务逻辑层。
Mapper：数据访问层，与数据库交互。
Model：实体类，与数据库表对应。

2. 依赖引入

在pom.xml中引入必要的依赖，例如Apache POI和OpenPDF：

<dependency>  
    <groupId>org.apache.poi</groupId>  
    <artifactId>poi</artifactId>  
    <version>4.1.2</version>  
</dependency>  
<dependency>  
    <groupId>org.apache.poi</groupId>  
    <artifactId>poi-ooxml</artifactId>  
    <version>4.1.2</version>  
</dependency>  
<dependency>  
    <groupId>com.lowagie</groupId>  
    <artifactId>itext</artifactId>  
    <version>2.1.7</version>  
</dependency>

3. 电子签章功能实现

电子签章功能包括在PDF文件上添加签名和盖章。可以使用iText库来实现这一功能。

实现水印和签名接口：通过实现PdfPageEvent接口，可以在PDF的每一页上添加水印和签名。

public class Signature implements PdfPageEvent {  
    private static final int FONT_SIZE = 14;  
    private static final int IMAGE_SIZE = 100;  
    private final String imagePath;  
    private final String signatureText;  
  
    public Signature(String imagePath, String signatureText) {  
        this.imagePath = imagePath;  
        this.signatureText = signatureText;  
    }  
  
    @Override  
    public void onEndPage(PdfWriter writer, Document document) {  
        try {  
            Image image = Image.getInstance(imagePath);  
            image.scaleAbsolute(IMAGE_SIZE, IMAGE_SIZE);  
            image.setAbsolutePosition((document.getPageSize().getWidth() - image.getScaledWidth()) / 2,  
                (document.getPageSize().getHeight() - image.getScaledHeight()) / 2);  
  
            PdfContentByte canvas = writer.getDirectContent();  
            BaseFont font = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);  
            canvas.beginText();  
            canvas.setFontAndSize(font, FONT_SIZE);  
            canvas.showTextAligned(Element.ALIGN_CENTER, signatureText,  
                document.getPageSize().getWidth() - 80, 120, 0);  
            canvas.endText();  
            canvas.addImage(image);  
        } catch (IOException | BadElementException e) {  
            throw new RuntimeException(e);  
        }  
    }  
}

将Word文档转换为PDF并添加签名：使用Apache POI将Word文档转换为PDF，然后使用iText添加签名。

4. 合同管理功能实现

合同管理功能包括合同的创建、审批、签署和存储。以下是部分核心功能的实现逻辑：

合同模板管理：允许用户创建和编辑合同模板，以及管理签章位置信息。

@PostMapping("/templates")  
public ResponseEntity<String> createTemplate(@RequestBody ContractTemplateDTO templateDTO) {  
    // 创建合同模板并保存到数据库  
    ContractTemplate template = new ContractTemplate();  
    template.setName(templateDTO.getName());  
    template.setType(templateDTO.getType());  
    template.setContent(templateDTO.getContent());  
    contractTemplateService.save(template);  
    return ResponseEntity.ok("Template created successfully");  
}

合同审批：员工发起合同审批，管理员进行审核。

@PostMapping("/audit")  
public ResponseEntity<String> auditContract(@RequestParam String id, @RequestParam String status) {  
    Contract contract = contractService.getById(id);  
    if (contract == null) {  
        return ResponseEntity.badRequest().body("Contract not found");  
    }  
    contract.setAuditStatus(status);  
    contract.setAuditTime(LocalDateTime.now());  
    contract.setAuditUser(getCurrentUser().getNickname());  
    contractService.saveOrUpdate(contract);  
    return ResponseEntity.ok("Contract audited successfully");  
}

合同签署：允许用户对处于待签署状态的合同进行签署操作，并记录签署历程。

@PostMapping("/sign")  
public ResponseEntity<String> signContract(@RequestParam String id) {  
    Contract contract = contractService.getById(id);  
    if (contract == null || !contract.getStatus().equals("待签署")) {  
        return ResponseEntity.badRequest().body("Contract not ready for signing");  
    }  
    contract.setSignStatus("已签署");  
    contract.setSignTime(LocalDateTime.now());  
    contract.setSignUser(getCurrentUser().getNickname());  
    contractService.saveOrUpdate(contract);  
    // 记录签署历程  
    signHistoryService.recordSignHistory(contract);  
    return ResponseEntity.ok("Contract signed successfully");  
}