Java용 GroupDocs.Signature를 사용하여 사용자 지정 이미지 서명을 구현하는 방법

소개

오늘날의 디지털 세상에서 전자 문서 서명은 여러 비즈니스 프로세스에 필수적입니다. 전문적인 느낌을 유지하면서도 문서의 원하는 위치에 서명이 정확하게 표시되도록 하는 것은 어려울 수 있습니다. Java용 GroupDocs.Signature 전자 서명을 애플리케이션에 원활하게 통합하기 위한 강력한 사용자 정의 옵션을 제공합니다.

이 튜토리얼에서는 Java용 GroupDocs.Signature를 설정하는 방법을 안내하고, 크기, 정렬, 모양 조정, 테두리 사용자 지정 등 다양한 구성을 사용하여 이미지 서명의 위치 지정, 정렬, 스타일 지정 등의 주요 기능을 살펴봅니다. 이 튜토리얼을 마치면 다음 작업 방법을 알게 될 것입니다.

  • 서명 위치 및 크기 설정
  • 서명을 여백에 맞추기
  • 이미지 모양 설정 조정
  • 이미지 테두리 사용자 지정

시작해 볼까요!

필수 조건

시작하기에 앞서 다음과 같은 필수 조건이 준비되어 있는지 확인하세요.

  1. 자바 개발 키트(JDK): 시스템에 JDK 8 이상이 설치되어 있는지 확인하세요.
  2. 통합 개발 환경(IDE): Java 개발을 위해 IntelliJ IDEA나 Eclipse와 같은 IDE를 사용하세요.
  3. GroupDocs.Signature 라이브러리: 프로젝트에 GroupDocs.Signature를 종속성으로 추가합니다.

필수 라이브러리 및 종속성

GroupDocs.Signature를 포함하려면 Maven이나 Gradle을 사용할 수 있습니다.

메이븐

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

그래들

implementation 'com.groupdocs:groupdocs-signature:23.12'

또는 최신 버전을 다음에서 직접 다운로드하세요. Java 릴리스용 GroupDocs.Signature.

환경 설정

IDE가 외부 라이브러리를 포함하도록 구성되어 있는지 확인하고 입력 문서, 서명 이미지, 출력 서명 문서에 대한 디렉터리가 있는 프로젝트를 설정하세요.

지식 전제 조건

  • Java 프로그래밍에 대한 기본적인 이해.
  • Java 애플리케이션에서 파일 경로를 처리하는 데 익숙함.

Java용 GroupDocs.Signature 설정

GroupDocs.Signature를 사용하려면 다음 설정 단계를 따르세요.

  1. 종속성 추가: 제공된 Maven 또는 Gradle 구성을 사용하여 라이브러리를 포함합니다.
  2. 라이센스 취득: 무료 평가판을 다운로드하여 시작하세요. 그룹닥스 필요한 경우 라이센스 구매를 고려하세요.

기본 초기화

Java 애플리케이션에서 GroupDocs.Signature를 초기화하는 방법은 다음과 같습니다.

import com.groupdocs.signature.Signature;

public class Main {
    public static void main(String[] args) throws Exception {
        String filePath = "path/to/your/document.docx";
        Signature signature = new Signature(filePath);
        
        // 추가 설정 및 사용 방법은 여기를 참조하세요.
    }
}

구현 가이드

다양한 이미지 서명을 사용자 정의하기 위한 기능의 구현 과정을 살펴보겠습니다.

서명 위치 및 크기 설정

개요: 이 기능을 사용하면 서명이 문서에 나타나는 위치와 크기를 지정하여 문서 전체의 일관성을 보장할 수 있습니다.

단계별 구현

  1. 서명 객체 초기화: 인스턴스를 생성합니다. Signature 문서 경로가 있는 클래스입니다.
  2. ImageSignOptions 구성: 크기와 위치를 포함한 이미지 서명에 대한 옵션을 설정합니다.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;

public class SignWithImagePosition {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignaturePosition.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 문서에 서명 위치 설정
        options.setLeft(100);  // 픽셀 단위의 X 좌표
        options.setTop(100);   // 픽셀 단위의 Y 좌표

        // 서명 사각형의 크기를 설정하세요
        options.setWidth(100);  // 픽셀 단위의 너비
        options.setHeight(30);  // 픽셀 단위의 높이
        
        // 문서에 서명하고 저장하세요
        signature.sign(outputFilePath, options);
    }
}

서명 정렬 및 여백 설정

개요: 정렬을 조정하면 문서의 여러 섹션에 걸쳐 일관된 배치가 보장됩니다. 여백은 다른 콘텐츠와 잘리거나 겹치는 것을 방지하는 데 도움이 됩니다.

단계별 구현

  1. 수직 및 수평 정렬 정의: 원하는 정렬에 열거형 값을 사용합니다.
  2. 패딩을 사용하여 여백 구성: 정확한 위치 지정을 위해 여백을 지정합니다.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.enums.HorizontalAlignment;
import com.groupdocs.signature.domain.enums.VerticalAlignment;
import com.groupdocs.signature.domain.Padding;

public class SignWithImageAlignment {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureAlignment.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 서명의 수직 정렬을 설정합니다.
        options.setVerticalAlignment(VerticalAlignment.Bottom);
        
        // 서명의 수평 정렬을 설정합니다.
        options.setHorizontalAlignment(HorizontalAlignment.Right);
        
        // 서명 위치 지정을 위한 여백 패딩 구성
        Padding padding = new Padding();
        padding.setBottom(20);  // 픽셀 단위의 하단 여백
        padding.setRight(20);   // 오른쪽 여백(픽셀)
        options.setMargin(padding);

        // 문서에 서명하고 저장하세요
        signature.sign(outputFilePath, options);
    }
}

회색조 및 밝기 조정으로 이미지 모양 설정

개요: 이미지 모양을 사용자 지정하면 시각적인 매력을 높일 수 있습니다. 회색조 적용이나 밝기 조정 등의 옵션이 있습니다.

단계별 구현

  1. 이미지 모양 설정 구성: 사용 ImageAppearance 문서에 이미지가 표시되는 방식을 조정합니다.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.appearances.ImageAppearance;

public class SignWithImageAppearance {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureAppearance.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 이미지 모양 설정 만들기 및 구성
        ImageAppearance imageAppearance = new ImageAppearance();
        
        // 이미지에 회색조 효과 적용
        imageAppearance.setGrayscale(true);
        
        // 이미지의 밝기 수준을 조정합니다
        imageAppearance.setBrightness(0.9f);  // 밝기 수준(범위: 0.0~1.0)
        
        options.setAppearance(imageAppearance);

        // 문서에 서명하고 저장하세요
        signature.sign(outputFilePath, options);
    }
}

스타일 및 투명도로 이미지 테두리 설정

개요: 테두리를 사용자 정의하면 서명의 전문성을 높일 수 있습니다.

단계별 구현

  1. 테두리 옵션 구성: 사용 Border 스타일과 투명도를 정의하는 설정입니다.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.ImageSignOptions;
import com.groupdocs.signature.domain.Border;

public class SignWithImageBorder {
    public static void run() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/document.docx";
        String imagePath = "YOUR_DOCUMENT_DIRECTORY/signature.png";
        String outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignatureBorder.docx";

        Signature signature = new Signature(filePath);
        ImageSignOptions options = new ImageSignOptions(imagePath);

        // 이미지에 대한 테두리 설정을 만들고 구성합니다.
        Border border = new Border();
        border.setColor(java.awt.Color.BLACK);  // 테두리 색상 설정
        border.setWidth(2);                    // 테두리 너비를 픽셀 단위로 설정하세요
        border.setDashStyle(com.groupdocs.signature.domain.enums.DashStyle.DashDot);
        
        options.setBorder(border);

        // 문서에 서명하고 저장하세요
        signature.sign(outputFilePath, options);
    }
}