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
- 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 chamesanitize()nele — remova apenas as propriedades que você precisa. - 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
InputStreamou de um URI precisa ter seu formato definido explicitamente (veja abaixo). - Propriedade do remetente de email renomeada. Na lista de propriedades, a propriedade do remetente agora se chama
SenderEmailAddressem vez deSender. Código que procura a propriedade pelo nome deve usar o novo nome.EmailPackage.getSender()está obsoleto em favor degetSenderEmailAddress(). - Cabeçalhos de áudio MPEG são somente leitura.
MpegAudioPackagedescreve 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.FB2eFb2RootPackage.getFb2Package()foram adicionados; o formato é somente leitura.Fb2Packagepossui 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.MOBIeMobiRootPackage.getMobiPackage()foram adicionados.MobiPackageexpõe o cabeçalho PDB (PDBHeader) e o cabeçalho MOBI (MobiHeader). O nome completo do livro pode ser editado comMobiHeader.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)eEmailHeaderPackage.set(String, PropertyValue)adicionam ou atualizam cabeçalhos de email.EmlPackage.getAttachments()eEmlPackage.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 sinalizadoresisEncrypted(),isSigned()eisTemplate().
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.