우리는 GroupDocs.Metadata for Java 26.11의 출시를 기쁘게 발표합니다. 이 버전은 2026년 11월부터 사용할 수 있습니다. 이번 릴리스에서는 여덟 가지 추가 형식—다섯 가지 압축 형식, OGG Vorbis 오디오, FB2 및 MOBI 전자책—의 메타데이터를 읽을 수 있으며, URI에서 직접 문서를 로드할 수 있습니다. 이메일 지원도 크게 확대되었습니다: MSG 파일이 약 30개의 추가 MAPI 속성을 노출하고, 기존 속성 중 일부가 편집 가능해졌으며, EML 첨부 파일도 편집할 수 있습니다. Metadata.sanitize()가 PDF 문서에서 더 많은 항목을 제거하며, 여러 수정 사항이 CAD 미리보기와 파일 유형 감지를 개선합니다.
이번 릴리스의 새로운 기능
| 키 | 요약 | 카테고리 |
|---|---|---|
| METADATANET-4251 | GZIP, BZ2, XZ 및 Zstandard 압축 형식 지원 | 기능 |
| — | Apple Archive (AAR) 형식 지원 | 기능 |
| METADATANET-4083 | OGG (Vorbis) 오디오 형식 지원 | 기능 |
| METADATANET-4077 | FictionBook 2 (FB2) 전자책 형식 지원 (읽기 전용) | 기능 |
| — | MOBI 전자책 형식 지원 | 기능 |
| METADATANET-4094 | 새로운 Metadata(URI) 생성자를 통한 웹 리소스에서 문서 로드 |
기능 |
| METADATANET-4121 | MSG: 인터넷 메시지 ID, 청구, HTML 및 RTF 본문; EML: 편집 가능한 첨부 파일 | 기능 |
| METADATANET-4123, METADATANET-4124 | MSG: 대화 주제, 표시 이름, 암호화 및 서명 플래그, 발신자 및 “대리 발신” 주소, 회신 주소, 읽음 확인 및 기타 MAPI 속성 | 기능 |
| METADATANET-4110, METADATANET-4111 | 이메일: getSenderEmailAddress(), 편집 가능한 MSG 발신자 이름, 본문 및 카테고리 |
향상 |
| METADATANET-4099 | MSG: 편집 가능한 전송 시간, 클라이언트 제출 시간 및 헤더 | 향상 |
| — | EmailHeaderPackage.set(String, PropertyValue)가 이메일 헤더를 추가하거나 업데이트 |
향상 |
| — | WordProcessing: HyperlinksChanged, ScaleCrop 및 SharedDoc 속성 |
향상 |
| METADATANET-4139 | Metadata.sanitize()가 PDF 첨부 파일, 북마크, 양식 필드 및 디지털 서명을 제거 |
향상 |
| METADATANET-4140 | 새로운 태그 Tags.getTime().getDelivery() 및 Tags.getTool().getCompression(); 더 많은 속성이 태그됨 |
향상 |
| METADATAJAVA-718 | Aspose 라이브러리 업데이트 | 향상 |
| — | CAD 도면 미리보기가 비어 있었음 | 수정 |
| — | RAR, 7z 및 TAR 압축 파일이 MP3 파일로 인식될 수 있었음 | 수정 |
| — | AVIF 이미지가 MP3, MOV 또는 HEIF 파일로 인식될 수 있었음 | 수정 |
| — | 작은 수정: 원시 태그의 equals/hashCode 일관성, null‑safe JSON 가져오기, 크기 연산 오버플로, ZIP 압축 후 스트림 닫힘 | 수정 |
업그레이드 전 확인해야 할 동작 변경 사항
- PDF 정리가 더 많이 수행됩니다.
Metadata.sanitize()가 이제 PDF 문서에서 주석뿐만 아니라 첨부 파일, 북마크, 양식 필드 및 디지털 서명을 제거합니다. 26.11 이전에는 주석만 제거했습니다. 정리된 PDF에서 이러한 항목을 유지해야 한다면sanitize()를 호출하지 말고 필요한 속성만 제거하십시오. - 압축 파일이 확장자로 인식됩니다. RAR, 7z, TAR 및 새로운 압축 형식은 파일 확장자를 기준으로 감지되므로,
InputStream이나 URI에서 로드하는 경우 형식을 명시적으로 설정해야 합니다(아래 URI에서 로드 섹션 참고). - 이메일 발신자 속성 이름이 변경되었습니다. 속성 목록에서 발신자 속성 이름이
Sender에서SenderEmailAddress로 바뀌었습니다. 이름으로 속성을 조회하는 코드는 새 이름을 사용해야 합니다.EmailPackage.getSender()는getSenderEmailAddress()를 사용하도록 폐기되었습니다. - MPEG 오디오 헤더는 읽기 전용입니다.
MpegAudioPackage는 오디오 스트림을 설명하므로, MPEG 버전, 채널 모드, 비트레이트 및 주파수와 같은 속성은 이제 속성 API를 통해 변경할 수 없습니다.
새 형식
압축 파일: AAR, GZIP, BZ2, XZ 및 Zstandard
새로운 FileType 상수는 AAR, GZIP(.gz), BZ2, XZ 및 ZSTD(.zst)입니다. 각 형식은 읽기 전용 루트 패키지를 제공합니다:
| 형식 | 루트 패키지 | 노출되는 내용 |
|---|---|---|
| AAR | AarRootPackage |
AarPackage: 전체 항목 수, solid 플래그, 이름·길이·디렉터리 플래그를 가진 AarFile 항목 |
| GZIP | GzipRootPackage |
GzipPackage: 이름, 전체 항목 수, 압축 및 비압축 크기 |
| BZ2 | Bz2RootPackage |
Bz2Package: 이름, 전체 항목 수, 크기 |
| XZ | XzRootPackage |
XzPackage: 이름, 전체 항목 수, 크기 |
| Zstandard | ZstdRootPackage |
ZstdPackage: 이름, 전체 항목 수, 크기 |
try (Metadata metadata = new Metadata("backup.gz")) {
GzipRootPackage root = metadata.getRootPackageGeneric();
GzipPackage gzip = root.getGzipPackage();
System.out.println(gzip.getName());
System.out.println(gzip.getSize());
System.out.println(gzip.getUncompressedSize());
}
OGG Vorbis 오디오
FileType.OGG와 OggRootPackage.getOggPackage()가 추가되었습니다. OggPackage는 Vorbis 코멘트 필드를 읽습니다:
- 제목, 앨범, 트랙 번호, 아티스트, 연주자, 장르 및 날짜;
- 저작권, 라이선스, 조직, 설명, 위치, 연락처 및 ISRC;
- 벤더 문자열 및 버전;
getOggUserComments()를 통해 남은 모든 코멘트.
try (Metadata metadata = new Metadata("track.ogg")) {
OggRootPackage root = metadata.getRootPackageGeneric();
OggPackage ogg = root.getOggPackage();
System.out.println(ogg.getArtist() + " - " + ogg.getTitle());
for (OggUserComment comment : ogg.getOggUserComments()) {
System.out.println(comment.getHeader() + " = " + comment.getValue());
}
}
전자책: FB2 및 MOBI
- FictionBook 2 (FB2) —
FileType.FB2와Fb2RootPackage.getFb2Package()가 추가되었습니다; 형식은 읽기 전용입니다.Fb2Package는 네 개의 섹션을 가집니다: 제목 정보와 원본 제목 정보(Fb2TitleInfo: 책 제목, 저자, 장르, 키워드, 언어 및 시퀀스), 문서 정보(Fb2DocumentInfo) 및 출판 정보(Fb2PublishInfo). - MOBI —
FileType.MOBI와MobiRootPackage.getMobiPackage()가 추가되었습니다.MobiPackage는 PDB 헤더(PDBHeader)와 MOBI 헤더(MobiHeader)를 노출합니다. 책의 전체 이름은MobiHeader.setFullName(String)으로 편집할 수 있습니다.
URI에서 로드
두 개의 새로운 생성자는 java.net.URI에서 직접 문서를 로드하므로 파일을 직접 다운로드할 필요가 없습니다:
public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)
문서는 메모리로 다운로드된 뒤 스트림에서 로드하는 방식과 동일하게 로드됩니다. 이제 압축 파일이 확장자로 인식되므로, 스트림이나 URI에서 압축 파일을 로드할 때 형식을 명시적으로 설정하십시오:
try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
// ...
}
이메일 메시지
EmailPackage.getSenderEmailAddress()가 추가되었으며,EmailPackage.getSender()는 폐기되고 동일한 값을 반환합니다.EmailPackage.setHeaders(EmailHeaderPackage)와EmailHeaderPackage.set(String, PropertyValue)가 이메일 헤더를 추가하거나 업데이트합니다.EmlPackage.getAttachments()와EmlPackage.setAttachments(EmailAttachmentPackage[])가 EML 첨부 파일을 편집 가능하게 합니다.
MsgPackage에 많은 새로운 속성이 추가되었습니다:
- 편집 가능:
Body,Categories,SenderName,DeliveryTime,ClientSubmitTime,Billing,BodyHtml,BodyRtf,ReplyTo,ReadReceiptRequested,SenderSmtpAddress,SentRepresentingEmailAddress,SentRepresentingName,Mileage,Attachments; - 읽기 전용:
InternetMessageId,ConversationTopic,DisplayBcc,DisplayCc,DisplayName,DisplayNamePrefix,DisplayTo,NormalizedSubject,SubjectPrefix,SenderAddressType,SentRepresentingAddressType,SentRepresentingSmtpAddress,TransportMessageHeaders및 플래그isEncrypted(),isSigned()와isTemplate().
try (Metadata metadata = new Metadata("message.msg")) {
MsgRootPackage root = metadata.getRootPackageGeneric();
MsgPackage msg = root.getMsgPackage();
System.out.println(msg.getInternetMessageId());
msg.setSenderName("Support Team");
msg.setCategories(new String[] { "Reviewed" });
metadata.save("message-updated.msg");
}
기타 향상
PDF 문서 정리
Metadata.sanitize()가 이제 PDF 문서에서 주석뿐만 아니라 첨부 파일, 북마크, 양식 필드 및 디지털 서명을 제거합니다. 이는 조직 외부에 PDF를 공유하기 전에 보다 철저히 정리하는 방법이 됩니다.
WordProcessing 문서
WordProcessingPackage에 세 개의 속성이 추가되어 읽고 편집할 수 있습니다: HyperlinksChanged, ScaleCrop 및 SharedDoc.
태그
Tags.getTime().getDelivery()는 메시지 전송 시간을 표시합니다.Tags.getTool().getCompression()는 ZIP, PNG 및 PSD 파일의 압축 설정을 표시합니다.
두 태그 모두 Metadata.findProperties에서 ContainsTagSpecification과 함께 사용할 수 있으며, 기존 속성 중 더 많은 것이 이제 태그됩니다.
수정
- CAD 도면 미리보기가 비어 있었습니다.
- RAR, 7z 및 TAR 압축 파일이 MP3 파일로 인식될 수 있었습니다.
- AVIF 이미지가 MP3, MOV 또는 HEIF 파일로 인식될 수 있었습니다.
- 작은 수정: 원시 태그의 equals/hashCode 일관성, null‑safe JSON 가져오기, 크기 연산 오버플로, ZIP 압축 후 스트림 닫힘.
Aspose 라이브러리 업데이트
번들된 Aspose 라이브러리가 다음으로 업데이트되었습니다: Aspose.Words 26.8, Aspose.Cells 26.9, Aspose.Slides 26.9, Aspose.PDF 26.8.1, Aspose.Email 26.8, Aspose.CAD 26.8, Aspose.PSD 26.8, Aspose.Diagram 26.9, Aspose.BarCode 26.6, Aspose.Imaging 25.12 및 Aspose.ZIP 26.7.
업데이트 받는 방법
Maven
pom.xml에 GroupDocs 저장소와 의존성을 추가하십시오:
<repositories>
<repository>
<id>groupdocs-artifacts-repository</id>
<name>GroupDocs Artifacts Repository</name>
<url>https://releases.groupdocs.com/java/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-metadata</artifactId>
<version>26.11</version>
</dependency>
</dependencies>
직접 다운로드
GroupDocs.Metadata for Java 26.11 다운로드 페이지에서 JAR 파일을 다운로드하십시오.