Java에서 PDF 메타데이터 편집: 개발자를 위한 단계별 가이드

GroupDocs.Metadata Cloud SDK for Java 은 Java 개발자가 프로그래밍 방식으로 PDF 문서 속성을 읽고 수정할 수 있게 합니다. 이 가이드에서는 Java에서 PDF 메타데이터를 편집하고, Title 및 Author와 같은 표준 필드를 업데이트하며, 사용자 정의 키‑값 쌍을 추가하는 방법을 배웁니다. SDK는 PDF를 로드하고 메타데이터를 변경한 뒤 파일을 스토리지에 다시 저장하는 간단한 API를 제공합니다. 단계별 지침을 따라 메타데이터 편집을 Java 애플리케이션에 통합하십시오.

전제 조건 및 설정

PDF 메타데이터를 사용하려면 Java 8 이상과 Maven이 개발 머신에 설치되어 있어야 합니다. 최신 버전은 이 페이지에서 다운로드하십시오.

Maven 프로젝트에 SDK를 추가합니다:

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

또는 명령줄을 통해 설치하십시오:

mvn install com.groupdocs:groupdocs-metadata-cloud

GroupDocs Cloud 대시보드에서 얻은 클라이언트 ID와 클라이언트 시크릿을 사용하여 구성 파일을 만들거나(또는 환경 변수를 설정)하십시오. 이 예제에서는 라이선스 코드가 필요하지 않으며, 임시 라이선스는 라이선스 페이지에서 요청할 수 있습니다.

PDF 메타데이터 이해

PDF 파일에는 표준 속성 집합(Title, Author, Subject, Keywords)이 포함되어 있으며 사용자 정의 키‑값 쌍을 허용합니다. 이러한 속성은 문서의 메타데이터 사전에 저장되며 파일의 시각적 내용을 변경하지 않고도 읽거나 수정할 수 있습니다.

GroupDocs.Metadata Cloud SDK for Java의 주요 기능

PDF에서 기존 메타데이터를 읽고, DOCX, XLSX, 및 기타 많은 형식.
Title, Author, Creator, Producer와 같은 표준 속성을 업데이트합니다.
간단한 맵 인터페이스를 사용하여 사용자 정의 속성을 추가, 편집 또는 제거합니다.
변경 사항을 원본 파일에 저장하거나 새 출력 위치에 저장합니다.

표준 PDF 문서 속성 수정

SDK는 모든 표준 필드에 대한 getter와 setter를 제공하는 MetadataInfo 클래스를 노출합니다. 또한 사용자 정의 항목을 작업하기 위해 CustomProperties 컬렉션에 접근할 수 있습니다.

사용자 정의 메타데이터 필드 추가

사용자 정의 메타데이터는 문자열 키와 값으로 구성된 사전 형태로 저장됩니다. SDK는 문서를 저장할 때 이러한 항목들을 자동으로 직렬화하여, 사용자 정의 메타데이터를 지원하는 모든 PDF 리더에서 사용할 수 있도록 합니다.

Java에서 PDF 메타데이터 편집 단계

API 클라이언트 초기화: 자격 증명을 사용하여 Configuration 객체를 생성하고 MetadataApi를 인스턴스화합니다.
원본 PDF 업로드: StorageApi를 사용하여 파일을 GroupDocs Cloud 스토리지에 배치합니다.
PDF 메타데이터 로드: metadataApi.getMetadataInfo를 호출하여 MetadataInfo 객체를 가져옵니다.
필드 업데이트: 표준 속성(예: setTitle, setAuthor)을 설정하고 getCustomProperties().put("MyKey", "MyValue")를 통해 사용자 정의 항목을 추가합니다.
변경 사항 저장: metadataApi.updateMetadataInfo를 호출하여 수정된 메타데이터를 파일에 다시 씁니다.

사용된 클래스에 대한 자세한 내용은 API 참조를 참조하십시오.

Java에서 PDF 메타데이터 편집 - 전체 코드 예제

다음 예제는 전체 워크플로우를 보여줍니다: 인증, 파일 업로드, 메타데이터 수정 및 업데이트된 PDF 저장.

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로(sample.pdf, C:/files/sample.pdf)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL을 사용한 REST API로 PDF 메타데이터 편집

Java 라이브러리를 사용하고 싶지 않은 경우, 동일한 작업을 GroupDocs Metadata Cloud REST API를 통해 수행할 수 있습니다.

액세스 토큰 얻기

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

PDF 파일 업로드

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/files/sample.pdf"

메타데이터 업데이트

curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'

업데이트된 PDF 다운로드

   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o "C:/files/updated_sample.pdf"

이 명령을 사용하면 Java 라이브러리를 설치하기 어려운 스크립트, CI/CD 파이프라인 또는 모든 환경에 PDF 메타데이터 편집을 통합할 수 있습니다. 전체 엔드포인트 목록은 API 문서를 참조하십시오.

결론

이제 Java에서 GroupDocs.Metadata Cloud SDK for Java를 사용하여 PDF 메타데이터를 편집하는 방법을 완전히 이해하게 되었습니다. 이 가이드는 기존 메타데이터를 읽고, Title 및 Author와 같은 표준 필드를 수정하며, 사용자 정의 키‑값 쌍을 추가하고, 변경 사항을 지속하는 방법을 다루었습니다. SDK는 로컬 머신이나 서버에서 실행되며 유효한 라이선스가 필요합니다; license page에서 임시 라이선스로 시작하고 프로덕션 사용을 위해 전체 상업 라이선스로 업그레이드할 수 있습니다. 이러한 기술을 적용하여 PDF 문서를 잘 정리되고 검색 가능하도록 유지하십시오.

FAQs

Java에서 GroupDocs.Metadata Cloud SDK를 사용하여 PDF 메타데이터를 편집하려면 어떻게 해야 하나요?
SDK를 사용하여 PDF를 로드하고, MetadataInfo 속성을 수정한 다음 파일을 저장합니다. 자세한 내용은 GroupDocs.Metadata Cloud SDK for Java 문서를 참조하세요.

PDF 메타데이터에 사용자 정의 키-값 쌍을 추가할 수 있나요?
예, SDK는 setCustomProperties 메서드를 통해 사용자 정의 항목을 추가할 수 있습니다. 예제는 API reference를 참조하세요.

임시 라이선스가 개발에 충분한가요?
임시 라이선스는 라이선스 페이지에서 SDK를 테스트할 수 있게 해줍니다. 프로덕션에서는 전체 라이선스를 구매하세요.

PDF 메타데이터 조작에 대한 더 많은 예제는 어디에서 찾을 수 있나요?
공식 문서 및 포럼에는 추가 샘플과 커뮤니티 지원이 포함되어 있습니다.

전제 조건 및 설정#

PDF 메타데이터 이해#

GroupDocs.Metadata Cloud SDK for Java의 주요 기능#

표준 PDF 문서 속성 수정#

사용자 정의 메타데이터 필드 추가#

Java에서 PDF 메타데이터 편집 단계#

Java에서 PDF 메타데이터 편집 - 전체 코드 예제#

cURL을 사용한 REST API로 PDF 메타데이터 편집#

결론#

FAQs#

Read More#