GroupDocs.Metadata를 사용한 Java에서 Excel 생성 날짜 변경

현대의 데이터 중심 환경에서는 Excel 생성 날짜 변경과 기타 메타데이터를 최신 상태로 유지하는 것이 문서 조직, 검색 가능성 및 규정 준수를 크게 향상시킬 수 있습니다. 재무 보고서, 프로젝트 추적기 또는 보관 데이터를 다루든, 정확한 메타데이터는 적절한 사람이 적절한 시점에 올바른 파일을 찾을 수 있게 합니다. 이 튜토리얼에서는 GroupDocs.Metadata 라이브러리를 사용하여 Excel 생성 날짜 변경, Excel에 키워드 추가, 그리고 Excel 문서 속성 수정을 Java 애플리케이션에서 수행하는 방법을 단계별로 안내합니다.

빠른 답변

Excel 파일의 생성 날짜를 변경할 수 있나요? 예, GroupDocs.Metadata의 setCreatedTime을 사용하면 가능합니다.
Java에서 Excel 메타데이터 업데이트를 지원하는 라이브러리는? GroupDocs.Metadata for Java.
라이선스가 필요합니까? 평가용 무료 체험판을 사용할 수 있으며, 운영 환경에서는 정식 라이선스가 필요합니다.
필요한 Java 버전은? JDK 8 이상.
Excel 워크북에 사용자 정의 키워드를 추가할 수 있나요? 물론입니다—문서 속성의 setKeywords를 사용하면 됩니다.

“Excel 생성 날짜 변경”이란?

Excel 생성 날짜를 변경한다는 것은 워크북 파일 내부에 저장된 기본 Created 속성을 업데이트하는 것을 의미합니다. 이 속성은 표준 Office Open XML 메타데이터의 일부이며, 실제 워크시트 내용에 영향을 주지 않고 프로그래밍 방식으로 편집할 수 있습니다.

Excel 메타데이터에 GroupDocs.Metadata를 사용하는 이유

GroupDocs.Metadata는 Office Open XML 형식에서 요구되는 저수준 XML 처리를 추상화한 고수준, 타입 안전 API를 제공합니다. 이를 통해 다음을 수행할 수 있습니다:

작성자, 회사, 생성 날짜와 같은 핵심 속성을 한 번에 업데이트.
Excel에 키워드 추가하여 SharePoint, OneDrive 또는 로컬 파일 시스템에서 검색 결과를 개선.
Excel 문서 속성 수정을 Excel을 열지 않고도 수행, 시간과 리소스를 절약.

사전 요구 사항

Java Development Kit (JDK) 8 이상.
IntelliJ IDEA 또는 Eclipse와 같은 IDE.
Java 파일 I/O에 대한 기본 지식.

GroupDocs.Metadata for Java 설정

설치

pom.xml에 GroupDocs.Metadata Maven 저장소와 의존성을 추가합니다:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/metadata/java/</url>
   </repository>
</repositories>

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

또는 수동 설정을 선호한다면 최신 버전을 직접 다운로드하십시오.

라이선스 획득

GroupDocs는 평가용 무료 체험판을 제공합니다. 운영 환경에서는 공급업체로부터 임시 또는 영구 라이선스를 받아야 합니다. 자세한 내용은 GroupDocs 구매 페이지를 참조하십시오.

기본 초기화

Java 소스 파일에 필요한 클래스를 import합니다:

import com.groupdocs.metadata.Metadata;
import com.groupdocs.metadata.core.SpreadsheetRootPackage;

단계별 구현

1단계: Excel 워크북 열기

소스 워크북 경로를 지정하고 Metadata 인스턴스를 생성합니다. try‑with‑resources 블록은 파일 핸들을 자동으로 닫아줍니다.

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/input.xlsx";

try (Metadata metadata = new Metadata(inputFilePath)) {
    // Access the root package for further operations
    SpreadsheetRootPackage root = metadata.getRootPackageGeneric();
}

2단계: 기본 메타데이터 속성 업데이트

이제 Excel 생성 날짜 변경, 작성자, 회사, 카테고리 설정 및 Excel에 키워드 추가를 할 수 있습니다. new Date() 호출은 현재 타임스탬프를 캡처하지만, 원하는 java.util.Date 객체를 전달할 수도 있습니다.

root.getDocumentProperties().setAuthor("test author");
root.getDocumentProperties().setCreatedTime(new Date());
root.getDocumentProperties().setCompany("GroupDocs");
root.getDocumentProperties().setCategory("test category");
root.getDocumentProperties().setKeywords("metadata, built-in, update");

팁: project:Q2, finance, confidential와 같이 일관된 키워드 명명 규칙을 사용하면 향후 검색 효율이 높아집니다.

3단계: 업데이트된 워크북 저장

출력 경로를 지정하고 변경 사항을 영구 저장합니다. 원본 파일은 그대로 유지되므로 감사 추적에 유용합니다.

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/output.xlsx";
metadata.save(outputFilePath);

일반적인 문제와 해결책

Issue	Why It Happens	Fix
File path errors	Incorrect relative/absolute paths	`inputFilePath`와 `outputFilePath`를 다시 확인하십시오. 플랫폼 독립적인 경로를 위해 `Paths.get(...)`를 사용하세요.
Incompatible library version	Using an older GroupDocs.Metadata that doesn’t support the `setCreatedTime` method	Maven 스니펫에 표시된 최신 버전으로 업그레이드하십시오.
Missing license	Trial period expired	임시 라이선스를 적용하거나 구매 페이지를 통해 정식 라이선스를 구입하십시오.
Large workbook memory usage	Loading massive Excel files consumes heap space	파일을 배치로 처리하고 필요에 따라 JVM 힙(`-Xmx`)을 늘리십시오.

자주 묻는 질문

Q: GroupDocs.Metadata가 지원하는 Java 버전은?
A: Java 8 이상을 완벽히 지원합니다.

Q: 메타데이터 업데이트 시 예외 처리는 어떻게 해야 하나요?
A: 코드를 try‑catch 블록으로 감싸고 MetadataException을 로깅하여 I/O 또는 포맷 오류를 포착하십시오.

Q: 한 번에 여러 Excel 파일을 업데이트할 수 있나요?
A: 네, 파일 경로 컬렉션을 순회하면 되지만, 대량 배치 시 메모리 사용량을 모니터링하십시오.

Q: 메타데이터 변경을 되돌릴 수 있나요?
A: 업데이트 적용 전에 원본 워크북을 백업해 두고, 필요 시 복원하면 됩니다.

Q: 더 자세한 문서는 어디서 찾을 수 있나요?
A: 공식 가이드는 GroupDocs Metadata Documentation을 참고하십시오.

실무 적용 사례

재무 감사 – 누가 언제 워크북을 수정했는지 기록하여 감사 추적을 제공.
프로젝트 관리 – 프로젝트별 키워드로 스프레드시트를 태그해 빠르게 검색.
데이터 보관 – 규정 준수를 위해 원본 생성 날짜와 회사 정보를 보존.

성능 팁

메타데이터 작업을 한 번에 너무 많이 수행하면 메모리 사용량이 급증할 수 있으니 제한하십시오.
Metadata 객체는 즉시 닫아야 합니다(try‑with‑resources 패턴이 자동으로 처리).
매우 큰 워크북은 백그라운드 스레드에서 처리해 UI 응답성을 유지하십시오.

결론

이제 GroupDocs.Metadata를 활용해 Java에서 Excel 생성 날짜 변경, Excel에 키워드 추가, 그리고 Excel 문서 속성 수정을 수행하는 방법을 알게 되었습니다. 이 기능을 통해 스프레드시트를 체계적으로 관리하고, 검색 가능하게 하며, 내부 거버넌스 정책을 준수할 수 있습니다. 다음 단계로는 사용자 정의 속성이나 배치 처리와 같은 다른 메타데이터 기능을 탐색해 문서 관리 워크플로를 더욱 효율화해 보세요.

Last Updated: 2026-03-22
Tested With: GroupDocs.Metadata 24.12 for Java
Author: GroupDocs

Resources