Estamos felizes em anunciar o lançamento do GroupDocs.Metadata for Java 26.11, disponível a partir de novembro de 2026. Esta versão lê metadados de oito formatos adicionais — cinco formatos de arquivo, áudio OGG Vorbis e e‑books FB2 e MOBI — e pode carregar um documento diretamente de um URI. O suporte a email cresce consideravelmente: arquivos MSG expõem cerca de 30 propriedades MAPI a mais, várias existentes tornam‑se editáveis e anexos EML podem ser editados. Metadata.sanitize() agora remove muito mais de documentos PDF, e um conjunto de correções melhora as pré‑visualizações CAD e a detecção de tipo de arquivo.

O que há de novo nesta versão

Chave Resumo Categoria
METADATANET-4251 Suporte aos formatos de arquivo GZIP, BZ2, XZ e Zstandard Recurso
— Suporte ao formato Apple Archive (AAR) Recurso
METADATANET-4083 Suporte ao formato de áudio OGG (Vorbis) Recurso
METADATANET-4077 Suporte ao formato de e‑book FictionBook 2 (FB2) (somente leitura) Recurso
— Suporte ao formato de e‑book MOBI Recurso
METADATANET-4094 Carregar documentos de recursos web com os novos construtores Metadata(URI) Recurso
METADATANET-4121 MSG: ID de mensagem da Internet, cobrança, corpo HTML e RTF; EML: anexos editáveis Recurso
METADATANET-4123, METADATANET-4124 MSG: tópico de conversa, nomes de exibição, sinalizadores de criptografia e assinatura, endereços do remetente e “enviado em nome de”, resposta, confirmação de leitura e outras propriedades MAPI Recurso
METADATANET-4110, METADATANET-4111 Email: getSenderEmailAddress(), nome do remetente MSG editável, corpo e categorias Melhoria
METADATANET-4099 MSG: horário de entrega editável, horário de envio do cliente e cabeçalhos editáveis Melhoria
— EmailHeaderPackage.set(String, PropertyValue) adiciona ou atualiza um cabeçalho de email Melhoria
— WordProcessing: propriedades HyperlinksChanged, ScaleCrop e SharedDoc Melhoria
METADATANET-4139 Metadata.sanitize() remove anexos PDF, marcadores, campos de formulário e assinaturas digitais Melhoria
METADATANET-4140 Novas tags Tags.getTime().getDelivery() e Tags.getTool().getCompression(); mais propriedades são marcadas Melhoria
METADATAJAVA-718 Bibliotecas Aspose atualizadas Melhoria
— Pré‑visualizações de desenhos CAD estavam vazias Correção
— Arquivos RAR, 7z e TAR podiam ser reconhecidos como arquivos MP3 Correção
— Imagens AVIF podiam ser reconhecidas como arquivos MP3, MOV ou HEIF Correção
— Correções menores: consistência de equals/hashCode de tags brutas, importação JSON à prova de null, overflow em aritmética de tamanho, streams fechados após empacotamento ZIP Correção

Alterações de comportamento a verificar antes de atualizar

  1. A sanitização de PDF remove mais. Metadata.sanitize() agora remove anotações, anexos, marcadores, campos de formulário e assinaturas digitais de documentos PDF; antes da 26.11 removia apenas anotações. Se um PDF sanitizado precisar manter esses itens, não chame sanitize() nele — remova apenas as propriedades que você precisa.
  2. Arquivos são reconhecidos pela sua extensão. RAR, 7z, TAR e os novos formatos de arquivo são detectados pela extensão do arquivo, portanto um arquivo carregado a partir de um InputStream ou de um URI precisa ter seu formato definido explicitamente (veja abaixo).
  3. Propriedade do remetente de email renomeada. Na lista de propriedades, a propriedade do remetente agora se chama SenderEmailAddress em vez de Sender. Código que procura a propriedade pelo nome deve usar o novo nome. EmailPackage.getSender() está obsoleto em favor de getSenderEmailAddress().
  4. Cabeçalhos de áudio MPEG são somente leitura. MpegAudioPackage descreve o fluxo de áudio, de modo que suas propriedades — como a versão MPEG, modo de canal, taxa de bits e frequência — não podem mais ser alteradas através da API de propriedades.

Novos formatos

Arquivos: AAR, GZIP, BZ2, XZ e Zstandard

Os novos constantes FileType são AAR, GZIP (.gz), BZ2, XZ e ZSTD (.zst). Cada formato vem com um pacote raiz somente leitura:

Formato Pacote raiz O que expõe
AAR AarRootPackage AarPackage: total de entradas, sinalizador solid, e entradas AarFile com nome, comprimento e sinalizador de diretório
GZIP GzipRootPackage GzipPackage: nome, total de entradas, tamanho comprimido e descomprimido
BZ2 Bz2RootPackage Bz2Package: nome, total de entradas, tamanho
XZ XzRootPackage XzPackage: nome, total de entradas, tamanho
Zstandard ZstdRootPackage ZstdPackage: nome, total de entradas, tamanho
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());
}

Áudio OGG Vorbis

FileType.OGG e OggRootPackage.getOggPackage() foram adicionados. OggPackage lê os campos de comentário Vorbis:

  • título, álbum, número da faixa, artista, intérprete, gênero e data;
  • direitos autorais, licença, organização, descrição, localização, contato e ISRC;
  • a string do fornecedor e a versão;
  • quaisquer comentários restantes, através de 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());
    }
}

E‑books: FB2 e MOBI

  • FictionBook 2 (FB2) — FileType.FB2 e Fb2RootPackage.getFb2Package() foram adicionados; o formato é somente leitura. Fb2Package possui quatro seções: as informações de título e as informações de título de origem (Fb2TitleInfo: título do livro, autores, gêneros, palavras‑chave, idioma e sequência), as informações do documento (Fb2DocumentInfo) e as informações de publicação (Fb2PublishInfo).
  • MOBI — FileType.MOBI e MobiRootPackage.getMobiPackage() foram adicionados. MobiPackage expõe o cabeçalho PDB (PDBHeader) e o cabeçalho MOBI (MobiHeader). O nome completo do livro pode ser editado com MobiHeader.setFullName(String).

Carregando a partir de um URI

Dois novos construtores carregam um documento diretamente de um java.net.URI, de modo que você não precisa mais baixar o arquivo manualmente:

public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)

O documento é baixado para a memória e então carregado da mesma forma que a partir de um stream. Como os arquivos agora são reconhecidos pela sua extensão, defina o formato explicitamente ao carregar um arquivo a partir de um stream ou de um URI:

try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
    // ...
}

Mensagens de email

  • EmailPackage.getSenderEmailAddress() foi adicionado; EmailPackage.getSender() está obsoleto e retorna o mesmo valor.
  • EmailPackage.setHeaders(EmailHeaderPackage) e EmailHeaderPackage.set(String, PropertyValue) adicionam ou atualizam cabeçalhos de email.
  • EmlPackage.getAttachments() e EmlPackage.setAttachments(EmailAttachmentPackage[]) tornam os anexos EML editáveis.

MsgPackage ganha muitas novas propriedades:

  • editável: Body, Categories, SenderName, DeliveryTime, ClientSubmitTime, Billing, BodyHtml, BodyRtf, ReplyTo, ReadReceiptRequested, SenderSmtpAddress, SentRepresentingEmailAddress, SentRepresentingName, Mileage, Attachments;
  • somente leitura: InternetMessageId, ConversationTopic, DisplayBcc, DisplayCc, DisplayName, DisplayNamePrefix, DisplayTo, NormalizedSubject, SubjectPrefix, SenderAddressType, SentRepresentingAddressType, SentRepresentingSmtpAddress, TransportMessageHeaders, e os sinalizadores isEncrypted(), isSigned() e 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");
}

Outras melhorias

Sanitização de documentos PDF

Metadata.sanitize() agora remove anexos, marcadores, campos de formulário e assinaturas digitais de documentos PDF, não apenas anotações. Isso o torna um método mais completo para limpar um PDF antes de compartilhá‑lo fora da sua organização.

Documentos WordProcessing

WordProcessingPackage ganha três propriedades que podem ser lidas e editadas: HyperlinksChanged, ScaleCrop e SharedDoc.

Tags

  • Tags.getTime().getDelivery() marca o horário de entrega de mensagens.
  • Tags.getTool().getCompression() marca as configurações de compressão de arquivos ZIP, PNG e PSD.

Ambas as tags podem ser usadas com ContainsTagSpecification em Metadata.findProperties, e mais propriedades existentes agora são marcadas.

Correções

  • Pré‑visualizações de desenhos CAD estavam vazias.
  • Arquivos RAR, 7z e TAR podiam ser reconhecidos como arquivos MP3.
  • Imagens AVIF podiam ser reconhecidas como arquivos MP3, MOV ou HEIF.
  • Correções menores: consistência de equals/hashCode de tags brutas, importação JSON à prova de null, overflow em aritmética de tamanho e streams fechados após empacotamento ZIP.

Bibliotecas Aspose atualizadas

As bibliotecas Aspose incluídas foram atualizadas para: 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 e Aspose.ZIP 26.7.

Como obter a atualização

Maven

Adicione o repositório GroupDocs e a dependência ao seu pom.xml:

<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>

Download direto

Baixe o JAR a partir da página de download do GroupDocs.Metadata for Java 26.11.

Recursos