GroupDocs 라이선스 Java – 라이선스 가이드

이 포괄적인 튜토리얼에서는 프로덕션 수준 애플리케이션을 위한 how to set groupdocs license java 를 알아볼 수 있습니다. 적절한 라이선스를 통해 GroupDocs.Metadata 기능 전체—메타데이터 추출, 편집, 규정 준수 검사 등—를 활용할 수 있으며 배포가 법적으로 준수됩니다. 라이선스 파일 배치, InputStream 기반 로드, 메터링 라이선스 옵션 등을 단계별로 안내하여 GroupDocs.Metadata를 모든 Java 프로젝트에 자신 있게 통합할 수 있습니다.

빠른 답변

  • GroupDocs.Metadata 라이선스에 필요한 파일 유형은 무엇입니까? A plain .lic XML file containing the encrypted license key.
  • 스트림에서 라이선스를 로드할 수 있습니까? Yes—use License.setLicense(InputStream) to avoid hard‑coding file paths.
  • 메터링(사용량 기반) 라이선스가 지원됩니까? Absolutely; call Metered.setMeteredKey(String) with your key.
  • 별도의 런타임 종속성이 필요합니까? Only the core GroupDocs.Metadata JAR; licensing lives inside the same library.
  • 라이선스가 모든 Java 버전에서 작동합니까? Java 8 부터 17까지 지원하여 대부분의 엔터프라이즈 환경을 포괄합니다.

“set groupdocs license java”란 무엇입니까?

*“set groupdocs license java”*는 Java 애플리케이션 내에서 유효한 GroupDocs.Metadata 라이선스 파일을 적용하여 SDK가 평가 제한 없이 작동하도록 하는 과정을 의미합니다. 이는 런타임에 제공된 .lic XML 파일을 로드하는 것으로, 체험 워터마크를 제거하고 무제한 문서 처리를 가능하게 하며 모든 지원 포맷에 대한 고급 메타데이터 조작 기능을 활성화합니다.

Java에서 GroupDocs.Metadata 라이선스를 사용하는 이유

GroupDocs.Metadata는 30개 이상의 입력 및 출력 포맷을 지원하며—PDF, DOCX, XLSX, PPTX, 이미지 파일 등을 포함—스트리밍 아키텍처 덕분에 2 GB까지의 문서를 처리하면서 메모리 사용량을 150 MB 이하로 유지합니다. 적절한 라이선스는 100 % 기능 가용성을 보장하고 라이선스가 없는 평가판에 적용되는 5페이지 제한을 제거합니다.

전제 조건

  • Java 8 이상 (Java 17 권장)
  • GroupDocs.Metadata 종속성을 추가하기 위한 Maven 또는 Gradle 빌드 시스템
  • 유효한 .lic 파일 또는 GroupDocs 계정에서 발급받은 메터링 라이선스 키

groupdocs 라이선스를 설정하는 방법은?

InputStream을 사용하여 클래스패스 또는 외부 위치에서 라이선스 파일을 로드합니다. 이 접근 방식은 웹 및 데스크톱 환경 모두에서 작동하며 하드코딩된 파일 경로를 없애줍니다. 라이선스를 src/main/resources에 배치하고 애플리케이션 시작 시 License 클래스를 호출하면 메타데이터 작업을 수행하기 전에 SDK가 완전히 활성화됩니다.

단계 1: Maven 종속성 추가

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

단계 2: 라이선스 파일 배치

GroupDocs.Metadata.lic 파일을 src/main/resources에 복사하여 JAR에 포함되도록 합니다.

단계 3: 애플리케이션 시작 시 라이선스 로드

import com.groupdocs.metadata.License;
import java.io.InputStream;

public class LicenseLoader {
    public static void applyLicense() throws Exception {
        try (InputStream licStream = LicenseLoader.class.getResourceAsStream("/GroupDocs.Metadata.lic")) {
            License license = new License();
            license.setLicense(licStream);
        }
    }
}

License 클래스는 GroupDocs.Metadata 라이선스를 적용하기 위한 진입점이며, 암호화된 XML을 읽어 모든 프리미엄 기능을 활성화합니다.

단계 4: 라이선스 활성화 확인

import com.groupdocs.metadata.Metadata;
import java.io.File;

public class Verify {
    public static void main(String[] args) throws Exception {
        LicenseLoader.applyLicense(); // ensure license is set first
        Metadata metadata = new Metadata(new File("sample.pdf"));
        System.out.println("License applied: " + metadata.getLicenseInfo().isValid());
    }
}

검증을 실행하면 true가 출력되어 라이선스가 올바르게 적용되었음을 확인합니다.

Java에서 메터링 라이선스(사용량 기반) 사용 방법

메터링 라이선스를 사용하면 고정 선불 비용 대신 실제 사용량에 따라 비용을 지불할 수 있습니다. Metered 클래스는 온라인 활성화를 처리하며, 각 API 호출은 사용량을 GroupDocs에 보고하여 청구하고, 남은 크레딧을 프로그래밍 방식으로 조회할 수 있습니다. setLicense 호출을 Metered.setMeteredKey 로 교체하여 이 모델로 전환합니다:

import com.groupdocs.metadata.metered.Metered;

public class MeteredLicense {
    public static void applyMeteredKey() {
        Metered.setMeteredKey("YOUR-METERED-KEY-HERE");
    }
}

Metered 클래스는 온라인 활성화를 처리하며, 각 API 호출은 사용량을 GroupDocs에 보고하여 청구합니다.

일반적인 문제 및 해결책

  • 라이선스 파일을 찾을 수 없음 – 파일이 클래스패스(src/main/resources)에 있는지 확인하고 앞에 슬래시(/GroupDocs.Metadata.lic)를 사용해 참조하십시오.
  • 잘못된 라이선스 오류 – .lic 파일이 사용 중인 제품 버전과 일치하는지 확인하고, 필요하면 GroupDocs 포털에서 다시 생성하십시오.
  • Metered key 거부 – 키 문자열에 공백이나 줄바꿈이 없는지 다시 확인하십시오; 키는 하나의 연속된 라인이어야 합니다.

사용 가능한 튜토리얼

InputStream을 사용하여 Java에서 GroupDocs.Metadata 라이선스 설정 방법

Java에서 InputStream을 사용하여 GroupDocs.Metadata 라이선스를 구성하는 방법을 배웁니다. 이 단계별 가이드를 통해 고급 문서 관리 기능을 활성화하십시오.

추가 리소스

자주 묻는 질문

Q: 동일한 라이선스 파일을 여러 Java 서비스에서 사용할 수 있습니까?
A: 예, 동일한 라이선스 계약 하에 실행되는 경우 단일 .lic 파일을 여러 Java 애플리케이션에서 공유할 수 있습니다.

Q: 라이선스가 클라우드 배포(AWS, Azure 등)를 지원합니까?
A: 물론입니다; 라이선스는 환경에 구애받지 않습니다. 파일이 런타임 컨테이너에서 접근 가능하도록만 하면 됩니다.

Q: 다운타임 없이 체험판에서 정식 라이선스로 전환하려면 어떻게 해야 합니까?
A: 새로운 .lic 파일을 배포하고 애플리케이션을 재시작하면 SDK가 다음 초기화 시 새로운 라이선스를 인식합니다.

Q: 메터링 키가 만료되면 어떻게 됩니까?
A: API 호출이 라이선스 예외를 반환하기 시작합니다. GroupDocs 계정에서 키를 새로 고쳐 사용을 재개하십시오.

Q: 남은 사용량 할당량을 프로그래밍 방식으로 확인할 방법이 있습니까?
A: 예, Metered.getUsageInfo()를 호출하여 현재 사용량과 남은 크레딧을 조회할 수 있습니다.

마지막 업데이트: 2026-06-07
테스트 환경: GroupDocs.Metadata 23.12 for Java
작성자: GroupDocs

관련 튜토리얼