Temos o prazer de anunciar o lançamento do GroupDocs.Assembly for Java 26.11, disponível a partir de novembro de 2026. Esta versão traz os recursos e correções do GroupDocs.Assembly for .NET 26.11 para Java:
- os modelos podem ser verificados contra um JSON Schema;
- as páginas de modelos e relatórios podem ser renderizadas em imagens;
- o carregamento de recursos externos está sob o controle da aplicação;
REMOVE_EMPTY_PARAGRAPHSfunciona para modelos planilha e texto simples;- tags
<<image>>funcionam em células de tabela de apresentações e resolvem caminhos relativos em relação à pasta do modelo; - as tags de cor aceitam hex strings.
Os motores Aspose incluídos passam de suas versões iniciais de 2026 para 26.10, e várias correções abrangem licenciamento, codificação de relatórios, códigos de barras e conteúdo HTML. O Java 8 continua como base.
Novidades nesta versão
| Chave | Resumo | Categoria |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource aceita um JSON Schema: membros declarados no schema podem ser referenciados mesmo quando são nulos, vazios ou ausentes nos dados, e os tipos de valor vêm do schema | Recurso |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview renderiza páginas de modelos, relatórios montados e outros documentos para imagens PNG, JPEG ou BMP |
Recurso |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funciona para modelos de planilha e documentos de texto simples |
Recurso |
| ASSEMBLYNET-140 | Recursos externos referenciados por modelos e dados estão sob o controle da aplicação; recursos cujas referências vêm dos dados são ignorados por padrão | Segurança |
| ASSEMBLYJAVA-353 | Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 e Aspose.BarCode 26.10 são incluídos | Atualização |
| ASSEMBLYJAVA-353 | Códigos de barras GS1 (EAN-14, SCC-14, SSCC-18 e DataBar) mantêm a autocorreção do texto do código com Aspose.BarCode 26.10 | Correção |
| ASSEMBLYNET-52 | Uma tag <<image>> funciona em uma célula de tabela de uma apresentação, e tags em formas de grupos de formas são processadas |
Aprimoramento |
| ASSEMBLYNET-62 | Um caminho de imagem relativo dos dados é resolvido em relação à pasta do modelo | Aprimoramento |
| ASSEMBLYNET-25 | Uma cor fornecida como string pode ser um valor hex em backColor e nas tags de cor de gráfico |
Aprimoramento |
| ASSEMBLYNET-155 | Um Boolean ausente em dados JSON, XML ou CSV conta como false em ?: e em where, count, any, all e first ao invés de falhar com um NullPointerException |
Correção |
| ASSEMBLYNET-157 | groupBy e distinct sobre objetos aninhados mesclam objetos iguais; referências $id/$ref de dados JSON são suportadas |
Correção |
| ASSEMBLYNET-142 | License.setLicense(InputStream) lê um stream que já foi lido desde o início |
Correção |
| ASSEMBLYNET-143 | O consumo de uma licença medida é relatado quando uma operação é concluída | Correção |
| ASSEMBLYNET-158 | Relatórios de texto e HTML de modelos apenas ASCII são gravados em UTF-8, de modo que dados não latinos não são mais perdidos | Correção |
| ASSEMBLYNET-160 | Códigos de barras não falham mais com NullPointerException quando a fonte da caixa de texto não está instalada |
Correção |
| ASSEMBLYNET-159 | Tags no tópico de conversa de um modelo MSG são montadas como as do seu assunto | Correção |
| ASSEMBLYNET-152 | Uma tag <<doc>> em um modelo de planilha, apresentação ou texto falha com uma mensagem clara; um assembleDocument falhado não deixa um arquivo de saída vazio |
Correção |
| ASSEMBLYJAVA-354 | Uma tag de expressão -html que termina seu parágrafo não deixa mais um parágrafo vazio após HTML que termina com um elemento de bloco |
Correção |
Alterações de comportamento a verificar antes de atualizar
- Recursos externos provenientes dos dados são ignorados por padrão. Por exemplo,
<<image [item.PhotoUrl]>>ondePhotoUrlé um URI http ou https agora gera uma imagem vazia. Adicione os hosts aLoadSaveOptions.getWhitelistedResources(), ou chameLoadSaveOptions.setSkipExternalResources(false)para manter o comportamento anterior. Recursos referenciados pelo próprio modelo e caminhos de arquivos locais funcionam como antes. - Chamada ambígua de
JsonDataSource.new JsonDataSource(path, null)com um literalnullcomo segundo argumento não compila mais. Converta o argumento:new JsonDataSource(path, (JsonDataLoadOptions) null). Aplicações compiladas não são afetadas. - Relatórios de texto e HTML em UTF-8. Relatórios de modelos de texto e HTML apenas ASCII sem marca de ordem de byte agora são gravados em UTF-8 ao invés de windows-1252. Para manter uma página de código de um byte, declare-a no modelo (
<meta charset>em HTML). groupByedistinctsobre objetos aninhados de dados JSON, XML e DataSet agora mesclam objetos iguais ao invés de gerar um grupo por linha.- Sem parágrafo extra após HTML. Uma tag
-htmlque termina seu parágrafo não deixa mais um parágrafo vazio após HTML que termina com um elemento de bloco. Para manter uma linha em branco, termine o HTML com<p> </p>. - Códigos de barras DataBar Expanded. Um código de barras DataBar Expanded ou DataBar Expanded Stacked com texto de código apenas de dígitos agora é codificado como um GTIN com o identificador de aplicação (01), como os outros tipos de DataBar.
- Texto da exceção alterado para uma tag
<<doc>>em modelos de planilha, apresentação e texto; o tipo de exceção permanece o mesmo. - API removida.
ICustomFontsHandler.resetFontSources()foi removida; chameFontSettings.resetFontSources()em seu lugar.
Novos recursos
Suporte a JSON Schema para JsonDataSource
Um modelo é verificado contra a estrutura de seus dados antes que qualquer <<if>> seja avaliado. Com JSON, essa estrutura era obtida dos próprios dados, de modo que uma referência dentro de um ramo que nunca é renderizado falhava quando os dados por trás dela eram nulos, um array vazio ou ausentes.
JsonDataSource agora aceita um JSON Schema, da mesma forma que XmlDataSource aceita um XML Schema, e o modelo é verificado contra o schema:
- membros declarados no schema podem ser referenciados mesmo se forem nulos, vazios ou ausentes nos dados;
- membros não declarados no schema ainda falham, portanto nomes digitados incorretamente são detectados como antes;
- os tipos de valor vêm do schema, então um booleano é um
Booleane uma string contendo dígitos permanece uma string.
Dado um cliente sem cartões de pagamento e sem dados de fidelidade, e um número de conta que é uma sequência de dígitos:
{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"Name": { "type": "string" },
"Account": { "type": "string" },
"Cards": {
"type": "array",
"items": { "type": "object", "properties": { "Type": { "type": "string" }, "Last4": { "type": "string" } } }
},
"Loyalty": { "type": ["object", "null"], "properties": { "Level": { "type": "string" } } }
}
}
e este modelo:
Customer: <<[customer.Name]>>
Account number: <<[customer.Account]>>
<<if [customer.Cards.count() > 0]>>Payment card: <<[customer.Cards.first().Type]>> ending in <<[customer.Cards.first().Last4]>><<else>>No payment card on file.<</if>>
Loyalty program: <<[customer.Loyalty?.Level]>>
passe o schema ao lado dos dados:
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
O resultado é No payment card on file. com o número da conta 00042. Sem o schema, o mesmo modelo falha em customer.Cards.first().Type, e o número da conta é lido como o número 42.
O schema pode ser fornecido como um caminho de arquivo ou um InputStream, com ou sem JsonDataLoadOptions. Palavras‑chave suportadas são type (incluindo tipos anuláveis), properties, items, format (date-time e date), enum, const, allOf e ponteiros $ref locais. oneOf, anyOf, not, $ref remoto ou recursivo, items em forma de tupla e arrays de arrays não são suportados.
Pré‑visualização de documento
DocumentAssembler.generatePreview renderiza páginas de um documento para imagens PNG, JPEG ou BMP: um modelo, um documento montado pelo GroupDocs.Assembly, ou qualquer outro documento de um formato suportado, a partir de um arquivo ou stream. Páginas de documentos de processamento de texto, texto e HTML, páginas impressas de planilhas, slides de apresentações e mensagens de email com seu cabeçalho são renderizadas.
DocumentAssembler assembler = new DocumentAssembler();
ByteArrayOutputStream report = new ByteArrayOutputStream();
try (InputStream template = new FileInputStream("Customer orders.docx"))
{
assembler.assembleDocument(template, report,
new DataSourceInfo(new JsonDataSource("Customers.json"), "customers"));
}
// A stream is created for every page and released when the page is written.
PreviewOptions options = new PreviewOptions(
pageNumber -> new FileOutputStream("page" + pageNumber + ".png"),
(pageNumber, pageStream) -> pageStream.close());
options.setPreviewFormat(PreviewFormats.PNG);
options.setResolution(120); // dots per inch; 96 by default
// options.setPageNumbers(new int[] { 1, 2 }); // all pages by default
assembler.generatePreview(new ByteArrayInputStream(report.toByteArray()), options);
Quando setWidth e setHeight são definidos, as páginas são escaladas para caber naquele tamanho mantendo sua proporção. As pré‑visualizações são geradas sem carregar recursos externos, e as imagens geradas são contabilizadas pela licença medida como documentos montados.
REMOVE_EMPTY_PARAGRAPHS para modelos de planilha e texto simples
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS agora funciona também para modelos de planilha e documentos de texto simples. Nesses casos, um parágrafo é uma linha de texto: uma linha do texto de uma célula, ou de um documento de texto, que se torna vazia após o processamento das tags do modelo é removida juntamente com sua quebra de linha. Tags como <<if>> e <<foreach>> escritas em linhas próprias não deixam mais linhas vazias.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
Modelo:
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
Resultado:
Prefix
Suffix
O mesmo texto de modelo em uma célula de planilha produz o mesmo resultado dentro da célula. Documentos HTML e XML permanecem como estão.
Segurança: controle de recursos externos
Uma tag <<image>> ou <<doc>> pode avaliar para um URI obtido dos dados, e o GroupDocs.Assembly costumava buscá‑lo sem forma de impedir. Um servidor que monta documentos a partir de dados fornecidos por terceiros poderia, assim, ser induzido a solicitar endereços internos.
O GroupDocs.Assembly agora indica de onde vem cada referência a um recurso externo (ExternalResourceOrigin):
TEMPLATE— o documento modelo referencia o recurso em si, incluindo um URI literal em uma tag como<<image ["https://example.com/logo.png"]>>;DATA— a referência vem dos dados, como um URI que uma expressão de tag avalia.
Por padrão, recursos referenciados pelo modelo são carregados como antes, e recursos cujas referências vêm dos dados são ignorados. Quatro membros de LoadSaveOptions controlam isso:
setSkipExternalResources(truepor padrão) — recursos externos não são carregados;setTrustTemplateResources(truepor padrão) — recursos referenciados pelo modelo são carregados mesmo quando a ignorância está ativada; defina comofalsequando os modelos vêm de fontes não confiáveis;getWhitelistedResources— nomes de host ou prefixos de URI absolutos permitidos mesmo quando a ignorância está ativada;setExternalResourceHandler— umExternalResourceHandlerchamado para cada recurso externo antes de ser solicitado, para permiti‑lo, ignorá‑lo ou fornecer seu conteúdo.
final String photoUri = "https://images.example.com/photos/no-photo.jpg";
DocumentAssembler assembler = new DocumentAssembler();
// Default options: the URI comes from data, so the image is skipped and left empty.
assembler.assembleDocument("Inserting image.docx", "Skipped.docx", new DataSourceInfo(photoUri, "expression"));
// Allow a trusted host and see every decision. The handler can also provide the content itself.
LoadSaveOptions options = new LoadSaveOptions();
options.getWhitelistedResources().add("images.example.com");
options.setExternalResourceHandler(new LocalImageHandler("no-photo.jpg"));
assembler.assembleDocument("Inserting image.docx", "Provided.docx", options, new DataSourceInfo(photoUri, "expression"));
public class LocalImageHandler extends ExternalResourceHandler
{
private final String mImagePath;
public LocalImageHandler(String imagePath) { mImagePath = imagePath; }
@Override
public void onLoading(ExternalResourceLoadingArgs args)
{
System.out.println(ExternalResourceOrigin.toString(args.getOrigin()) + " resource " + args.getUri() + ": "
+ (args.isSkipped() ? "skipped" : "allowed"));
// Provide the content instead of requesting it.
if (!args.isSkipped() && args.getUri().toLowerCase().startsWith("https://images.example.com/"))
{
try
{
args.setData(Files.readAllBytes(Paths.get(mImagePath)));
}
catch (IOException e)
{
throw new UncheckedIOException(e);
}
}
}
}
Recursos externos são recursos que alcançam a rede: URIs http, https e ftp, caminhos UNC e URIs de arquivo com host remoto. Caminhos de arquivos locais não são afetados. Uma imagem ignorada de um documento é substituída por uma imagem transparente; um valor <<image>> ou <<doc>> ignorado é tratado como um valor vazio.
Aprimoramentos
Imagens em células de tabela e grupos de formas de apresentações
Em um modelo de apresentação, uma tag <<image>> só podia ser colocada em uma caixa de texto. Uma célula de tabela agora também é um contêiner de imagem: a imagem torna‑se o preenchimento da célula, incluindo células de linhas repetidas por <<foreach>>, permitindo construir uma tabela listando itens com suas imagens. Com -fitHeight, a linha cresce para mostrar a imagem com sua proporção. Tags em formas de grupos de formas, incluindo grupos aninhados, agora são processadas como outras formas.
Caminhos de imagem relativos resolvidos em relação à pasta do modelo
Uma tag <<image>> que obtém um caminho de arquivo relativo dos dados, como Images/photo.png, agora o resolve primeiro em relação à pasta do modelo, por analogia com recursos vinculados de documentos Microsoft Office. Para um modelo carregado a partir de um stream, defina a pasta com LoadSaveOptions.setResourceLoadBaseUri:
DocumentAssembler assembler = new DocumentAssembler();
// A template loaded from a stream has no folder: set it with setResourceLoadBaseUri.
LoadSaveOptions options = new LoadSaveOptions();
options.setResourceLoadBaseUri("C:\\Reports\\Templates");
try (InputStream template = new FileInputStream("C:\\Reports\\Templates\\Inserting image.docx");
OutputStream report = new FileOutputStream("output-from-stream.docx"))
{
assembler.assembleDocument(template, report, options, new DataSourceInfo("../Images/no-photo.jpg", "expression"));
}
Se nenhum arquivo existir lá, o diretório atual é usado como antes.
Strings de cor hex
Uma cor fornecida como string agora pode ser um valor hex — "#RRGGBB", "#RGB" ou "#AARRGGBB" — além de um nome de cor e um inteiro ARGB, em backColor e nas tags de cor de gráfico. Por exemplo, <<backColor [item.Color]>> com "#FF0000" vindo dos dados agora aplica vermelho.
Correções
- Booleans ausentes em dados JSON, XML e CSV agora contam como
falseno operador condicional?:e nos predicados dewhere,count,any,allefirst, ao invés de falhar com umNullPointerException. groupByedistinctsobre objetos aninhados de dados JSON e XML comparam objetos por valor, de modo que clientes iguais formam um grupo. JSON escrito com referências preservadas ($id/$ref) agora é suportado.License.setLicense(InputStream)lê umByteArrayInputStreama partir de sua marca e umFileInputStreama partir da posição 0, de modo que um stream já usado para licenciar outro produto GroupDocs não falha mais com “Unexpected EOF in prolog”.- Consumo medido é relatado quando a montagem de um documento ou a geração de uma pré‑visualização termina, ao invés de depois por uma thread em segundo plano.
- Relatórios de texto e HTML de modelos apenas ASCII são gravados em UTF-8, de modo que dados como
CaféouПриветnão são mais perdidos para windows-1252. - Códigos de barras cujo texto do código é desenhado pelo motor (QR, DataMatrix, Aztec e outros) não falham mais quando a fonte da caixa de texto não está instalada — tipicamente Calibri no Linux. Uma fonte de reserva é usada em seu lugar.
- Modelos MSG: tags no tópico de conversa são processadas como as do assunto, de modo que o Outlook encadeia as mensagens corretamente.
<<doc>>em modelos de planilha, apresentação e texto falha com uma mensagem dizendo que a tag não é suportada para o formato, e umassembleDocumentfalhado não deixa mais um arquivo de saída vazio.- Conteúdo HTML: uma tag de expressão
-htmlque termina seu parágrafo não deixa mais um parágrafo vazio extra após HTML que termina com um elemento de bloco (ASSEMBLYJAVA-354). - Códigos de barras GS1: o GroupDocs.Assembly agora corrige textos de código apenas numéricos de códigos de barras EAN-14, SCC-14, SSCC-18 e DataBar por conta própria, porque o Aspose.BarCode 26.10 deixou de fazê‑lo, de modo que esses códigos de barras permanecem os mesmos que em 26.10.1.
Motores Aspose atualizados para 26.10
O GroupDocs.Assembly for Java 26.10.1 incluía bibliotecas Aspose de início de 2026, de modo que vulnerabilidades corrigidas nelas desde então foram reportadas por scanners de segurança. Os motores incluídos agora são:
| Motor | 26.10.1 | 26.11 |
|---|---|---|
| Aspose.Words for Java | 26.3 | 26.10.1 |
| Aspose.Cells for Java | 26.3 | 26.10 |
| Aspose.Slides for Java | 26.2 | 26.10 |
| Aspose.Email for Java | 26.1 | 26.9 |
| Aspose.BarCode for Java | 26.6 | 26.10 |
O POM publicado ainda não declara dependências. Como os motores foram atualizados, documentos regenerados podem diferir ao nível de byte, embora permaneçam visual e funcionalmente equivalentes. Se você comparar byte a byte a saída gerada com bases de referência armazenadas, atualize essas bases após a atualização.
Observações para usuários Java
- Datas com
Zou um deslocamento em dados JSON ou CSV são valoresjava.util.Datedaquele instante exato, e um padrão de formato os imprime no fuso horário padrão da JVM. Para saída que não dependa do servidor, execute a JVM com um fuso horário fixo, por exemplo-Duser.timezone=UTC. ExternalResourceOriginePreviewFormatssão classes de constantesint, como as outras enumerações da API Java.CreatePageStreameReleasePageStreamsão interfaces funcionais, portanto lambdas se encaixam.
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-assembly</artifactId>
<version>26.11</version>
</dependency>
</dependencies>
Download direto
Baixe o JAR da página de download do GroupDocs.Assembly for Java 26.11.