java 파일 확장자 확인 – 문서 유형 감지 및 검증

문서를 처리하기 전에 java 파일 확장자 확인을 하는 것이 가장 일반적인 작업 중 하나입니다.

예상한 형식이 아니어서 애플리케이션이 충돌한 파일을 업로드한 적이 있나요? 당신만 그런 것이 아닙니다. Java에서 파일 형식을 감지하고 검증하는 것은 견고한 문서 처리 애플리케이션을 구축하는 데 필수적이지만, 파일 확장자를 확인하는 것보다 더 까다롭습니다(확장자는 쉽게 위조되거나 잘못될 수 있습니다).

이 가이드에서는 단순한 확장자 확인을 넘어서는 강력한 라이브러리인 GroupDocs.Signature를 사용하여 Java에서 파일 형식을 신뢰성 있게 감지하는 방법을 배웁니다. 문서 관리 시스템을 구축하든, 사용자 업로드를 검증하든, 클라우드 스토리지 서비스와 통합하든, 다양한 문서 유형을 자신 있게 처리할 수 있는 실용적인 기술을 발견하게 될 것입니다.

배우게 될 내용:

  • Java에서 지원되는 파일 형식을 프로그래밍 방식으로 검색하는 방법
  • 라이브러리 기반 감지를 언제 사용하고 Java 내장 방식을 언제 사용할지
  • 파일 유형을 검증할 때 흔히 발생하는 함정(및 회피 방법)
  • 실제 통합 시나리오와 성능 최적화 팁
  • 형식 감지 문제에 대한 트러블슈팅 전략

마지막까지 진행하면 바로 Java 애플리케이션에 삽입할 수 있는 작동하는 구현을 얻게 됩니다. 필요한 모든 것이 준비되었는지 확인하고 시작해봅시다.

빠른 답변

  • java 파일 확장자를 가장 빠르게 확인하는 방법은? Signature.getSupportedFileTypes()를 사용하여 전체 목록을 가져오고 파일의 확장자를 비교하십시오.
  • GroupDocs.Signature를 사용하려면 라이선스가 필요합니까? 무료 체험판은 개발에 사용할 수 있으며, 영구 라이선스는 모든 평가 제한을 제거합니다.
  • 전체 파일을 읽지 않고 업로드를 검증할 수 있나요? 예—GroupDocs.Signature는 파일 헤더만 검사하므로 전체 문서를 로드하는 것보다 훨씬 비용이 적게 듭니다.
  • GroupDocs.Signature가 지원하는 형식은 몇 개인가요? PDF, DOCX, XLSX, PPTX, JPG, PNG 등을 포함해 50개 이상의 입력 및 출력 형식을 지원합니다.
  • 형식 목록을 캐시하는 것이 필요할까요? 캐시를 사용하면 반복적인 리플렉션 오버헤드를 없애고 대량 서비스의 처리량을 향상시킵니다.

java 파일 확장자 확인이란?

java check file extension은 파일 이름 접미사만을 의존하지 않고 헤더와 메타데이터를 검사하여 파일의 실제 유형을 확인하는 과정을 의미합니다. 이를 통해 악의적으로 이름이 바뀐 파일을 조기에 감지하고, 위조된 확장자로 인한 보안 위협을 방지하며, 애플리케이션이 지원하는 문서 유형만 처리하도록 보장합니다.

사전 요구 사항

파일 형식 감지를 시작하기 전에 다음 필수 항목을 준비하십시오:

필요한 라이브러리 및 버전

  • GroupDocs.Signature Library: 버전 23.12 이상 (최신 안정 버전을 사용할 예정입니다)
  • Java Development Kit: JDK 1.8 이상 (성능 향상을 위해 JDK 11+ 권장)
  • 빌드 도구: Maven 3.x 또는 Gradle 6.x (의존성 관리용)

환경 설정 요구 사항

다음에 익숙해야 합니다:

  • 기본 Java 프로그래밍 개념(클래스, 루프, import)
  • Maven 또는 Gradle을 사용한 의존성 관리
  • IDE 또는 명령줄에서 Java 애플리케이션 실행

빠른 팁: 대용량 문서를 다루거나 파일을 동시에 처리할 계획이라면 JVM에 충분한 힙 메모리를 할당하십시오(최적화는 이후에 다룹니다).

GroupDocs.Signature for Java 설정

프로젝트에 GroupDocs.Signature를 추가하는 것은 간단합니다—선호하는 빌드 도구를 선택하고 따라오세요.

Maven 사용

pom.xml 파일에 다음 의존성을 추가하십시오:

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

의존성을 추가한 후, mvn clean install을 실행하여 라이브러리를 다운로드하십시오.

Gradle 사용

build.gradle 파일에 다음 줄을 포함하십시오:

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

그런 다음 Gradle 프로젝트를 동기화하거나 gradle build를 실행하십시오.

직접 다운로드 대안

빌드 도구를 사용하지 않나요? GroupDocs.Signature for Java releases에서 JAR 파일을 직접 다운로드하여 클래스패스에 수동으로 추가할 수 있습니다. (하지만 Maven이나 Gradle을 사용하면 나중에 번거로움을 줄일 수 있습니다.)

라이선스 획득 단계

GroupDocs.Signature는 유연한 라이선스 옵션을 제공합니다:

  • 무료 체험: 테스트에 적합—신용카드 없이 바로 시작
  • 임시 라이선스: 평가에 더 많은 시간이 필요합니까? 제한 없는 접근을 위해 30일 임시 라이선스를 요청하십시오
  • 구매: 프로덕션 준비가 되면 GroupDocs Purchase Page에서 영구 라이선스를 구매하십시오

프로 팁: 모든 기능을 탐색하려면 무료 체험부터 시작하십시오. 임시 라이선스는 평가 기간을 연장해야 할 경우 워터마크와 제한을 제거합니다.

Signature 클래스란?

Signature는 GroupDocs.Signature의 모든 작업에 대한 핵심 진입점입니다. 문서 로드, 형식 처리 및 서명 처리를 캡슐화합니다. 이 클래스는 문서를 열고, 지원되는 형식을 검색하며, 다양한 파일 유형에 대해 서명을 적용하거나 검증하는 메서드를 제공합니다.

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

import com.groupdocs.signature.Signature;

// Create an instance of Signature class
Signature signature = new Signature("sample.pdf");

이 코드는 지정된 문서에 대한 서명 객체를 생성합니다. 실제 문서를 다룰 때 이 패턴을 사용하지만, 지원되는 형식을 검색할 때는 특정 파일이 필요하지 않습니다(다음 섹션에서 보여드리겠습니다).

구현 가이드

이제 실전 단계입니다. 모든 지원 파일 형식을 검색하는 간단한 유틸리티를 구축할 것입니다—문서 처리 파이프라인을 위한 “호환성 검사기”를 만드는 것과 같습니다.

왜 중요한가

파일을 처리하기 전에 라이브러리가 지원하는 파일 유형을 알아야 합니다. 이 구현은 동적으로 해당 정보를 제공하므로:

  • 구식이 될 수 있는 파일 확장자 목록을 하드코딩하지 않음
  • 지원되는 형식에 대해 사용자 업로드를 쉽게 검증
  • UI에서 파일 유형 필터를 구축할 때 빠른 참고 자료

단계별 구현

1. 필요한 클래스 가져오기

FileType은 형식 감지의 관문으로, 지원되는 문서 유형에 대한 모든 메타데이터를 포함합니다. Signature.getSupportedFileTypes() 메서드는 라이브러리가 처리할 수 있는 모든 형식을 나타내는 FileType 객체 컬렉션을 반환합니다.

import com.groupdocs.signature.domain.documentpreview.FileType;
import java.util.List;

2. 검색 클래스 생성

다음은 전체 구현입니다:

public class GetSupportedFileFormats {
    public static void run() {
        // Retrieve a list of supported file types from the FileType utility.
        List<FileType> supportedFileTypes = FileType.getSupportedFileTypes();

        // Iterate over each FileType object and print its extension to the console.
        for (FileType fileType : supportedFileTypes) {
            System.out.print("\n" + fileType.getExtension());
        }
    }
}

여기서 일어나는 일:

  • Signature.getSupportedFileTypes()는 라이브러리 내부 레지스트리를 조회하고 지원되는 형식의 전체 목록을 FileType 객체로 반환합니다.
  • 루프는 각 형식을 순회하며 확장자(예: .pdf, .docx, .xlsx)를 출력합니다.
  • 각 FileType 객체는 추가 메타데이터도 포함하고 있어 접근할 수 있습니다(아래에서 살펴보겠습니다).

기본 확장자를 넘어

FileType 객체는 확장자 외에도 다양한 정보를 제공합니다. 다음을 통해 추가로 얻을 수 있습니다:

for (FileType fileType : supportedFileTypes) {
    System.out.println("Extension: " + fileType.getExtension());
    System.out.println("Format: " + fileType.getFileFormat());
    // Additional properties available depending on version
}

필요에 따라 사용자 친화적인 형식 이름을 표시하거나 형식을 유형별(문서 vs. 스프레드시트 vs. 이미지)로 그룹화할 때 유용합니다.

java 파일 확장자를 확인하는 방법은?

파일 이름을 로드하고 접미사를 추출한 뒤 Signature.getSupportedFileTypes()가 반환한 캐시된 목록과 비교합니다. 이 두 단계 접근 방식은 하드코딩된 배열이 아닌 최신 카탈로그와 비교함을 보장합니다. 또한 GroupDocs.Signature가 파일 헤더를 검증하므로 위조된 확장자를 방지하고 내용이 주장된 유형과 실제로 일치함을 확인합니다.

GroupDocs.Signature란?

GroupDocs.Signature는 개발자가 50개 이상의 문서 형식에 디지털 서명을 추가, 검증 및 관리할 수 있게 해주는 Java 라이브러리입니다. PDF, Office, 이미지 등 다양한 형식에 대한 통합 API를 제공하며, 암호화된 파일, 비밀번호 보호 문서, 다중 페이지 서명 등 복잡한 검증 시나리오를 처리합니다. 또한 콘텐츠 기반 형식 감지를 제공하여 악의적으로 이름이 바뀐 파일의 처리를 방지합니다.

왜 Java 내장 메서드 대신 라이브러리 기반 감지를 사용해야 할까?

라이브러리 기반 감지는 실제 파일 헤더와 내부 구조를 검사하여 내용이 주장된 형식과 진정으로 일치함을 보장합니다. Files.probeContentType 같은 내장 메서드나 단순 문자열 접미사 검사는 악성 실행 파일을 .pdf로 이름을 바꾸면 속을 수 있습니다. GroupDocs.Signature는 추가 처리를 수행하기 전에 깊은 콘텐츠 분석을 수행함으로써 이러한 위험을 제거하고 애플리케이션에 더 높은 보안 보장을 제공합니다.

지원 파일 형식 목록을 언제 캐시해야 할까?

애플리케이션 시작 시점이나 처음 필요할 때 형식 목록을 캐시하고, JVM이 살아있는 동안 불변 컬렉션을 재사용하십시오. 캐시는 각 요청마다 리플렉션이 무거운 라이브러리 초기화를 트리거하여 호출당 수 밀리초의 지연을 추가할 수 있는 고처리량 웹 서비스에서 특히 유용합니다. 목록을 한 번만 저장하면 CPU 오버헤드를 줄이고 전체 응답 시간을 개선합니다.

Java에서 지원되지 않는 파일 형식을 처리하는 방법은?

지원되지 않는 형식을 조기에 감지하고, 감사 목적을 위해 시도를 로그에 기록하며, 허용된 확장자를 나열한 명확한 오류 메시지를 사용자에게 반환하십시오. 이 접근 방식은 사용자 경험을 향상시키고 백엔드의 불필요한 처리 부하를 줄이며, 보안 팀에게 잠재적인 오용 시도에 대한 가시성을 제공합니다.

언제 이 접근 방식을 사용해야 할까

이상적인 사용 사례

1. 문서 업로드 검증기 구축
사용자가 애플리케이션에 파일을 업로드할 때, 서버 측에서 형식을 검증하고 싶습니다(클라이언트 측 검증만 신뢰하지 마세요). 이 접근 방식은 처리하기 전에 지원되는 형식의 포괄적인 목록과 비교할 수 있게 해줍니다.

2. 동적 파일 유형 필터 생성
파일 선택기나 업로드 인터페이스를 만들고 있나요? 라이브러리 기능과 동기화되지 않는 정적 배열을 유지하는 대신 허용된 형식 목록을 동적으로 생성하십시오.

3. 다중 형식 문서 처리 파이프라인
다양한 소스(이메일 첨부, 클라우드 스토리지, 사용자 업로드)에서 문서를 처리한다면, 파일을 적절한 핸들러로 라우팅하기 위해 신뢰할 수 있는 형식 감지가 필요합니다.

4. 클라우드 스토리지 서비스와의 통합
AWS S3, Google Drive, Azure Blob Storage와 동기화할 때, 파일을 다운로드하고 처리하기 전에 문서 호환성을 검증하십시오—대역폭과 처리 시간을 절약합니다.

내장 Java만으로 충분할 때

간단한 시나리오에서는 Java의 내장 접근 방식으로 충분할 수 있습니다:

  • 파일 확장자만 확인: file.getName().endsWith(".pdf")
  • MIME 유형 감지: Files.probeContentType(path)
  • 기본 검증: 업로드 소스를 제어하고 파일 확장자를 신뢰할 수 있을 때

중요한 주의사항: 내장 메서드는 속을 수 있습니다. malicious.exe를 document.pdf로 이름을 바꾸면 확장자 검사는 통과하지만 적절한 검증에 실패합니다. GroupDocs.Signature는 더 깊은 검사를 수행합니다.

일반적인 문제 및 트러블슈팅

문제 1: 빈 목록 또는 null 반환

증상: Signature.getSupportedFileTypes()가 빈 목록 또는 null을 반환합니다.

원인 및 해결책:

  • 라이브러리가 제대로 초기화되지 않음 – Maven/Gradle 의존성이 올바르게 추가되고 동기화되었는지 확인하십시오.
  • 버전 호환성 – 버전 23.12 이상을 사용하고 있는지 확인하십시오(이전 버전은 API가 다를 수 있습니다).
  • 클래스패스 문제 – 수동 JAR 파일을 사용하는 경우 클래스패스에 올바르게 추가되었는지 확인하십시오.

빠른 해결책:

List<FileType> formats = FileType.getSupportedFileTypes();
if (formats == null || formats.isEmpty()) {
    System.err.println("Error: No file types loaded. Check library initialization.");
    return;
}

문제 2: 예상 형식 누락

증상: 사용하려는 형식이 지원 목록에 없습니다.

가능한 이유:

  • 추가 플러그인이 필요한 특수 형식일 수 있습니다(일부 CAD 또는 의료 영상 형식은 별도 모듈 필요).
  • 최신 버전에서 추가된 형식일 수 있으니 릴리즈 노트를 확인하십시오.
  • 읽기는 지원하지만 서명 작업은 지원하지 않을 수 있습니다(GroupDocs.Signature는 주로 서명 추가에 사용되며, 모든 작업이 모든 형식을 동일하게 지원하지는 않음).

디버깅 접근법:

// Check for specific format
boolean hasPDF = supportedFileTypes.stream()
    .anyMatch(ft -> ft.getExtension().equalsIgnoreCase(".pdf"));
System.out.println("PDF supported: " + hasPDF);

문제 3: 큰 형식 목록으로 인한 성능 저하

증상: Signature.getSupportedFileTypes()를 반복 호출하면 애플리케이션이 느려집니다.

해결책: 결과를 캐시하십시오! 이 목록은 런타임 중에 변경되지 않습니다:

public class FormatCache {
    private static List<FileType> cachedFormats = null;
    
    public static List<FileType> getSupportedFormats() {
        if (cachedFormats == null) {
            cachedFormats = FileType.getSupportedFileTypes();
        }
        return cachedFormats;
    }
}

문제 4: 라이선스 관련 제한

증상: 평가 경고가 표시되거나 형식 지원이 제한됩니다.

해결책:

  • GroupDocs 메서드를 호출하기 전에 라이선스를 적용하십시오.
  • 라이선스 파일 경로가 올바른지 확인하십시오.
  • 시간 제한 라이선스를 사용하는 경우 만료 날짜를 확인하십시오.
try {
    License license = new License();
    license.setLicense("path/to/GroupDocs.Signature.lic");
} catch (Exception e) {
    System.err.println("License error: " + e.getMessage());
}

파일 형식 감지를 위한 모범 사례

1. 초기에 검증하고 빠르게 실패

처리 파이프라인에서 가능한 한 빨리 파일 형식을 검증하십시오:

public boolean validateFileFormat(String filePath) {
    String extension = getFileExtension(filePath);
    List<FileType> supported = FormatCache.getSupportedFormats();
    
    boolean isSupported = supported.stream()
        .anyMatch(ft -> ft.getExtension().equalsIgnoreCase(extension));
    
    if (!isSupported) {
        throw new UnsupportedFormatException(
            "File format " + extension + " is not supported"
        );
    }
    return true;
}

2. 명확한 사용자 피드백 제공

파일을 거부할 때는 지원되는 형식을 정확히 알려주십시오:

public String getSupportedFormatsMessage() {
    List<FileType> formats = FormatCache.getSupportedFormats();
    String extensions = formats.stream()
        .map(FileType::getExtension)
        .collect(Collectors.joining(", "));
    
    return "Supported formats: " + extensions;
}

3. 파일 확장자만 신뢰하지 말 것

.exe를 .pdf로 이름을 바꾸면 .pdf 확장자를 갖지만 유효한 PDF는 아닙니다. GroupDocs.Signature는 실제 콘텐츠를 검증하므로 확장자만 신뢰하지 않아야 하지만, 두 접근 방식을 결합하는 것이 좋습니다:

// First check extension (fast)
if (!hasValidExtension(file)) {
    return false;
}

// Then validate with library (more thorough)
try (Signature signature = new Signature(file)) {
    // If initialization succeeds, format is valid
    return true;
} catch (Exception e) {
    return false;
}

4. 예외를 우아하게 처리

지원되지 않는 형식 외에도 다양한 이유로 파일 검증이 실패할 수 있습니다:

public ValidationResult validateDocument(String path) {
    try {
        // Your validation logic
        return ValidationResult.success();
    } catch (UnsupportedFormatException e) {
        return ValidationResult.failure("Unsupported format: " + e.getMessage());
    } catch (IOException e) {
        return ValidationResult.failure("File access error: " + e.getMessage());
    } catch (Exception e) {
        return ValidationResult.failure("Unexpected error: " + e.getMessage());
    }
}

5. 형식 지원 변경 사항 모니터링

GroupDocs.Signature 라이브러리를 업데이트할 때는 릴리즈 노트를 확인하십시오:

  • 새로운 지원 형식
  • 지원 중단된 형식
  • 형식 감지 동작 변경

예상 형식이 지원되는지 확인하는 단위 테스트를 추가하는 것을 고려하십시오:

@Test
public void testEssentialFormatsSupported() {
    List<String> required = Arrays.asList(".pdf", ".docx", ".xlsx");
    List<FileType> supported = FileType.getSupportedFileTypes();
    
    for (String format : required) {
        assertTrue(
            supported.stream().anyMatch(ft -> ft.getExtension().equals(format)),
            format + " should be supported"
        );
    }
}

성능 고려 사항

파일 형식 감지를 최적화하는 것은 사소해 보일 수 있지만, 수천 개의 문서를 처리하거나 동시 업로드를 처리할 때는 중요합니다.

메모리 관리

Caching strategy: 앞서 언급했듯이 지원 형식 목록을 캐시하십시오:

// Good: Load once, reuse many times
private static final List<FileType> SUPPORTED_FORMATS = 
    FileType.getSupportedFileTypes();

// Bad: Loads list every time method is called
public boolean isSupported(String ext) {
    return FileType.getSupportedFileTypes().stream()
        .anyMatch(ft -> ft.getExtension().equals(ext));
}

Why it matters: 형식 목록을 로드하려면 리플렉션과 내부 라이브러리 초기화가 필요합니다. 한 번만 수행하면 CPU 사이클과 메모리 할당을 절감합니다.

리소스 사용 가이드라인

For high‑volume scenarios:

  • 형식 목록에 대해 스레드 안전 캐시 사용(위 예시는 불변이므로 스레드 안전).
  • 애플리케이션이 항상 형식 감지를 필요로 하지 않을 경우 지연 초기화를 고려하십시오.
  • 문서를 처리할 때 Signature 객체를 즉시 닫아 리소스를 해제하십시오.
try (Signature signature = new Signature(filePath)) {
    // Process document
} // Automatically closed, resources freed

배치 처리 최적화

여러 파일을 검증해야 한다면 병렬 처리를 고려하십시오:

List<String> files = Arrays.asList("doc1.pdf", "doc2.docx", "doc3.xlsx");

// Process in parallel
files.parallelStream()
    .forEach(file -> {
        if (validateFileFormat(file)) {
            processDocument(file);
        }
    });

Caution: 과도한 병렬화는 피하십시오. I/O에 의존하는 경우(디스크 읽기) 스레드가 많아도 도움이 되지 않습니다. 최적의 스레드 수를 테스트해 보십시오.

JVM 튜닝 팁

문서가 많은 애플리케이션을 위해:

  • 힙 크기 증가: -Xmx2g (필요에 따라 조정)
  • 가비지 컬렉션 모니터링: -XX:+PrintGCDetails 사용
  • 더 나은 일시 정지를 위해 G1GC 사용 고려: -XX:+UseG1GC

실용적인 적용 및 통합

파일 형식 감지가 필수적인 실제 시나리오를 살펴보겠습니다.

1. 문서 관리 시스템

Scenario: 사용자가 문서를 업로드하면 인덱싱, 처리 및 저장이 필요합니다.

Implementation pattern:

public class DocumentUploadHandler {
    public void handleUpload(MultipartFile file) {
        // Validate format first
        if (!isFormatSupported(file.getOriginalFilename())) {
            throw new InvalidFormatException(
                "Please upload: " + getSupportedFormatsString()
            );
        }
        
        // Process valid document
        processAndStore(file);
    }
    
    private boolean isFormatSupported(String filename) {
        String ext = getExtension(filename);
        return FormatCache.getSupportedFormats().stream()
            .anyMatch(ft -> ft.getExtension().equalsIgnoreCase(ext));
    }
}

2. 클라우드 스토리지 통합

Scenario: AWS S3, Google Drive 등에서 문서를 동기화하고 지원되는 형식만 처리합니다.

Why it’s useful: 지원되지 않는 파일을 다운로드하고 처리하려는 시도를 피함으로써 대역폭과 처리 시간을 절약합니다.

public void syncFromS3(String bucketName) {
    S3Client s3 = S3Client.create();
    ListObjectsV2Request listReq = ListObjectsV2Request.builder()
        .bucket(bucketName)
        .build();
    
    ListObjectsV2Response listing = s3.listObjectsV2(listReq);
    
    for (S3Object object : listing.contents()) {
        if (isFormatSupported(object.key())) {
            // Download and process only supported formats
            downloadAndProcess(bucketName, object.key());
        } else {
            logger.info("Skipping unsupported format: " + object.key());
        }
    }
}

3. 엔터프라이즈 워크플로 자동화

Scenario: 유형에 따라 문서를 다른 처리 파이프라인으로 라우팅합니다.

Example: PDFs는 서명 워크플로로, 스프레드시트는 데이터 추출로, 이미지는 OCR 처리로 보냅니다.

public void routeDocument(String filePath) {
    try (Signature signature = new Signature(filePath)) {
        FileType type = signature.getDocumentInfo().getFileType();
        
        switch (type.getExtension()) {
            case ".pdf":
            case ".docx":
                sendToSignatureWorkflow(filePath);
                break;
            case ".xlsx":
            case ".csv":
                sendToDataExtractionWorkflow(filePath);
                break;
            case ".jpg":
            case ".png":
                sendToOCRWorkflow(filePath);
                break;
            default:
                logger.warn("No workflow defined for: " + type.getExtension());
        }
    }
}

4. 파일 유형 선택기 구축

Scenario: 동적 형식 지원을 갖춘 UI 컴포넌트를 생성합니다.

Frontend integration example:

@RestController
public class FormatController {
    @GetMapping("/api/supported-formats")
    public ResponseEntity<List<String>> getSupportedFormats() {
        List<String> extensions = FileType.getSupportedFileTypes().stream()
            .map(FileType::getExtension)
            .sorted()
            .collect(Collectors.toList());
        
        return ResponseEntity.ok(extensions);
    }
}

프런트엔드는 이를 사용해 파일 업로드 컴포넌트를 구성할 수 있습니다:

// Frontend code (for context, not part of Java implementation)
fetch('/api/supported-formats')
    .then(res => res.json())
    .then(formats => {
        fileInput.accept = formats.join(',');
    });

자주 묻는 질문

Q: Maven에서 GroupDocs.Signature 라이브러리 버전을 어떻게 업데이트합니까?
A: pom.xml의 <version> 태그를 원하는 버전으로 변경한 뒤 mvn clean install을 실행하십시오. 항상 release notes를 검토하여 호환성 깨지는 변경 사항을 확인하십시오.

Q: 확장자가 잘못된 경우에도 GroupDocs.Signature가 파일 형식을 감지할 수 있나요?
A: 네. 라이브러리는 콘텐츠 기반 검증을 수행하므로 .exe를 .pdf로 이름을 바꾼 파일은 처리 중에 유효한 PDF가 아니라고 거부됩니다. getSupportedFileTypes()는 라이브러리가 처리할 수 있는 형식만 나열하며, 실제 유형을 확인하려면 파일을 열어보아야 합니다.

Q: 무료 체험과 임시 라이선스의 차이점은 무엇인가요?
A: 무료 체험은 즉시 접근이 가능하지만 평가용 워터마크와 일부 기능 제한이 포함됩니다. 임시 라이선스는 워터마크 없이 30일 동안 전체 기능을 제공하므로 프로덕션과 유사한 환경에서 철저히 테스트하기에 이상적입니다.

Q: 애플리케이션에서 지원되지 않는 파일 형식을 어떻게 처리해야 할까요?
A: “지원되지 않는 형식입니다. 지원되는 확장자는: .pdf, .docx, .xlsx, .png, .jpg.”와 같이 간결한 오류를 반환하십시오. 보안 모니터링을 위해 사건을 로그에 기록하고, 허용된 유형을 나열하는 UI 툴팁으로 사용자에게 알리는 것을 고려하십시오.

Q: GroupDocs.Signature가 암호화되거나 비밀번호로 보호된 파일에서도 작동하나요?
A: 네, 하지만 Signature 인스턴스를 생성할 때 비밀번호를 제공해야 합니다. 형식 감지는 비밀번호가 필요하지 않지만, 이후 처리(예: 서명 추가)에는 비밀번호가 필요합니다.

Q: GroupDocs.Signature를 위한 커뮤니티나 지원 포럼이 있나요?
A: 물론입니다! 커뮤니티 토론, 코드 예제, GroupDocs 팀의 직접 답변을 보려면 GroupDocs Forum을 방문하십시오.

리소스

마지막 업데이트: 2026-08-19
테스트 환경: GroupDocs.Signature 23.12 for Java
작성자: GroupDocs

<version>24.1</version>  <!-- Update to newer version -->

try {
    validateAndProcess(file);
} catch (UnsupportedFormatException e) {
    return ResponseEntity
        .badRequest()
        .body("Unsupported format. Please upload: " + getSupportedFormatsString());
}

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("your-password");
Signature signature = new Signature("protected.pdf", loadOptions);

관련 튜토리얼