우리는 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 압축 후 스트림 닫힘 수정

업그레이드 전 확인해야 할 동작 변경 사항

  1. PDF 정리가 더 많이 수행됩니다. Metadata.sanitize()가 이제 PDF 문서에서 주석뿐만 아니라 첨부 파일, 북마크, 양식 필드 및 디지털 서명을 제거합니다. 26.11 이전에는 주석만 제거했습니다. 정리된 PDF에서 이러한 항목을 유지해야 한다면 sanitize()를 호출하지 말고 필요한 속성만 제거하십시오.
  2. 압축 파일이 확장자로 인식됩니다. RAR, 7z, TAR 및 새로운 압축 형식은 파일 확장자를 기준으로 감지되므로, InputStream이나 URI에서 로드하는 경우 형식을 명시적으로 설정해야 합니다(아래 URI에서 로드 섹션 참고).
  3. 이메일 발신자 속성 이름이 변경되었습니다. 속성 목록에서 발신자 속성 이름이 Sender에서 SenderEmailAddress로 바뀌었습니다. 이름으로 속성을 조회하는 코드는 새 이름을 사용해야 합니다. EmailPackage.getSender()는 getSenderEmailAddress()를 사용하도록 폐기되었습니다.
  4. 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 파일을 다운로드하십시오.

리소스