저희는 GroupDocs.Assembly for Java 26.11의 출시를 기쁘게 발표합니다. 2026년 11월부터 이용 가능합니다. 이 릴리스는 GroupDocs.Assembly for .NET 26.11의 기능 및 수정 사항을 Java에 제공합니다:
- 템플릿을 JSON 스키마에 대해 검증할 수 있습니다;
- 템플릿 및 보고서의 페이지를 이미지로 렌더링할 수 있습니다;
- 외부 리소스 로딩을 애플리케이션이 제어합니다;
REMOVE_EMPTY_PARAGRAPHS가 스프레드시트 및 일반 텍스트 템플릿에서도 작동합니다;<<image>>태그가 프레젠테이션의 테이블 셀에서 작동하며 상대 경로를 템플릿 폴더를 기준으로 해석합니다;- 색상 태그가 16진수 문자열을 허용합니다.
번들된 Aspose 엔진이 초기 2026 버전에서 26.10으로 업데이트되었으며, 라이선스, 보고서 인코딩, 바코드 및 HTML 콘텐츠와 관련된 여러 수정 사항이 포함되었습니다. Java 8은 여전히 기준 버전입니다.
이번 릴리스의 새로운 기능
| 키 | 요약 | 카테고리 |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource가 JSON 스키마를 허용합니다: 스키마에 선언된 멤버는 데이터에서 null이거나 비어 있거나 누락된 경우에도 참조할 수 있으며, 값 유형은 스키마에서 가져옵니다 |
기능 |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview가 템플릿, 조립된 보고서 및 기타 문서의 페이지를 PNG, JPEG 또는 BMP 이미지로 렌더링합니다 |
기능 |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS가 스프레드시트 템플릿 및 일반 텍스트 문서에서도 작동합니다 |
기능 |
| ASSEMBLYNET-140 | 템플릿 및 데이터가 참조하는 외부 리소스는 애플리케이션이 제어합니다; 데이터에서 참조가 오는 리소스는 기본적으로 건너뛰어집니다 | 보안 |
| ASSEMBLYJAVA-353 | Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 및 Aspose.BarCode 26.10이 번들에 포함됩니다 | 업데이트 |
| ASSEMBLYJAVA-353 | GS1 바코드(EAN-14, SCC-14, SSCC-18 및 DataBar)는 Aspose.BarCode 26.10을 사용하여 코드 텍스트 자동 보정을 유지합니다 | 수정 |
| ASSEMBLYNET-52 | <<image>> 태그가 프레젠테이션의 테이블 셀에서 작동하며, 그룹 도형의 도형에 있는 태그도 처리됩니다 |
향상 |
| ASSEMBLYNET-62 | 데이터에서 제공된 상대 이미지 경로가 템플릿 폴더를 기준으로 해석됩니다 | 향상 |
| ASSEMBLYNET-25 | 문자열로 제공된 색상이 backColor 및 차트 색상 태그에서 16진수 값이 될 수 있습니다 |
향상 |
| ASSEMBLYNET-155 | JSON, XML 또는 CSV 데이터에서 누락된 Boolean 값은 실패 대신 ?: 연산자와 where, count, any, all, first에서 false로 간주됩니다 |
수정 |
| ASSEMBLYNET-157 | 중첩 객체에 대한 groupBy와 distinct가 동일한 객체를 병합합니다; JSON 데이터의 $id/$ref 참조가 지원됩니다 |
수정 |
| ASSEMBLYNET-142 | License.setLicense(InputStream)이 이미 처음부터 읽힌 스트림을 읽습니다 |
수정 |
| ASSEMBLYNET-143 | 작업이 완료될 때 메터링된 라이선스 사용량이 보고됩니다 | 수정 |
| ASSEMBLYNET-158 | ASCII 전용 템플릿의 텍스트 및 HTML 보고서가 UTF-8로 작성되어 비라틴 데이터가 손실되지 않습니다 | 수정 |
| ASSEMBLYNET-160 | 바코드의 텍스트 박스 폰트가 설치되지 않아도 NullPointerException이 발생하지 않습니다 |
수정 |
| ASSEMBLYNET-159 | MSG 템플릿의 대화 주제에 있는 태그가 해당 제목의 태그와 같이 조립됩니다 | 수정 |
| ASSEMBLYNET-152 | 스프레드시트, 프레젠테이션 또는 텍스트 템플릿에서 <<doc>> 태그가 명확한 메시지와 함께 실패합니다; 실패한 assembleDocument는 빈 출력 파일을 남기지 않습니다 |
수정 |
| ASSEMBLYJAVA-354 | -html 표현식 태그가 단락을 종료할 때 블록 요소로 끝나는 HTML 뒤에 빈 단락이 남지 않습니다 |
수정 |
업그레이드 전 확인해야 할 동작 변경 사항
- 데이터에서 오는 외부 리소스는 기본적으로 건너뛰어집니다. 예를 들어,
PhotoUrl이 http 또는 https URI인 경우<<image [item.PhotoUrl]>>는 이제 빈 이미지를 반환합니다. 호스트를LoadSaveOptions.getWhitelistedResources()에 추가하거나LoadSaveOptions.setSkipExternalResources(false)를 호출하여 이전 동작을 유지하십시오. 템플릿 자체가 참조하는 리소스와 로컬 파일 경로는 이전과 같이 작동합니다. - 모호한
JsonDataSource호출. 두 번째 인자로 리터럴null을 사용한new JsonDataSource(path, null)은 더 이상 컴파일되지 않습니다. 인자를 캐스팅하십시오:new JsonDataSource(path, (JsonDataLoadOptions) null). 이미 컴파일된 애플리케이션에는 영향을 주지 않습니다. - UTF-8 텍스트 및 HTML 보고서. 바이트 순서 표시가 없는 ASCII 전용 텍스트 및 HTML 템플릿의 보고서는 이제 windows-1252 대신 UTF-8로 작성됩니다. 단일 바이트 코드 페이지를 유지하려면 템플릿에 선언하십시오(
HTML의 <meta charset>). - **JSON, XML 및 DataSet 데이터의 중첩 객체에 대한
groupBy와distinct**가 이제 행당 하나의 그룹을 만들지 않고 동일한 객체를 병합합니다. - HTML 뒤에 추가 단락이 없습니다. 단락을 종료하는
-html태그가 블록 요소로 끝나는 HTML 뒤에 빈 단락을 남기지 않습니다. 빈 줄을 유지하려면 HTML을<p> </p>로 종료하십시오. - DataBar Expanded 바코드. 숫자만 포함된 코드 텍스트를 가진 DataBar Expanded 또는 DataBar Expanded Stacked 바코드는 이제 다른 DataBar 유형과 마찬가지로 (01) 애플리케이션 식별자를 가진 GTIN으로 인코딩됩니다.
- 예외 텍스트 변경: 스프레드시트, 프레젠테이션 및 텍스트 템플릿에서
<<doc>>태그에 대한 예외 메시지가 변경되었습니다; 예외 유형은 동일합니다. - 제거된 API.
ICustomFontsHandler.resetFontSources()가 제거되었습니다; 대신FontSettings.resetFontSources()를 호출하십시오.
새로운 기능
JsonDataSource에 대한 JSON 스키마 지원
템플릿은 <<if>>가 평가되기 전에 데이터 구조에 대해 검증됩니다. JSON의 경우, 해당 구조가 데이터 자체에서 추출되었기 때문에, 렌더링되지 않는 분기 내부의 참조는 해당 데이터가 null이거나 빈 배열이거나 누락된 경우 실패했습니다.
JsonDataSource는 이제 JSON 스키마를 허용합니다. 이는 XmlDataSource가 XML 스키마를 허용하는 방식과 동일하며, 템플릿은 스키마에 대해 검증됩니다:
- 스키마에 선언된 멤버는 데이터에서 null이거나 비어 있거나 존재하지 않아도 참조할 수 있습니다;
- 스키마에 선언되지 않은 멤버는 여전히 실패하므로, 오타가 이전과 같이 감지됩니다;
- 값 유형은 스키마에서 가져오므로, Boolean은
Boolean이며 숫자를 포함한 문자열은 문자열로 유지됩니다.
다음과 같은 고객이 있다고 가정합니다: 결제 카드와 로열티 데이터가 없으며, 계좌 번호가 숫자 문자열인 경우:
{ "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" } } }
}
}
그리고 이 템플릿:
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]>>
데이터 옆에 스키마를 전달합니다:
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
결과는 계좌 번호 00042와 함께 No payment card on file.입니다. 스키마 없이 동일한 템플릿은 customer.Cards.first().Type에서 실패하고, 계좌 번호는 숫자 42로 읽힙니다.
스키마는 파일 경로나 InputStream으로 제공될 수 있으며, JsonDataLoadOptions 유무와 관계없이 사용할 수 있습니다. 지원되는 키워드는 type(nullable 유형 포함), properties, items, format(date-time 및 date), enum, const, allOf 및 로컬 $ref 포인터입니다. oneOf, anyOf, not, 원격 또는 재귀 $ref, 튜플 형태 items 및 배열의 배열은 지원되지 않습니다.
문서 미리보기
DocumentAssembler.generatePreview는 문서의 페이지를 PNG, JPEG 또는 BMP 이미지로 렌더링합니다: 템플릿, GroupDocs.Assembly가 조립한 문서, 또는 지원되는 형식의 다른 문서를 파일이나 스트림에서. 워드 프로세싱, 텍스트 및 HTML 문서의 페이지, 스프레드시트의 인쇄 페이지, 프레젠테이션 슬라이드 및 헤더가 포함된 이메일 메시지가 렌더링됩니다.
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);
setWidth와 setHeight가 모두 설정되면, 페이지는 비율을 유지하면서 해당 크기에 맞게 스케일됩니다. 미리보기는 외부 리소스를 로드하지 않고 생성되며, 생성된 이미지는 조립된 문서와 마찬가지로 메터링된 라이선스로 계산됩니다.
스프레드시트 및 일반 텍스트 템플릿에 대한 REMOVE_EMPTY_PARAGRAPHS
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS가 이제 스프레드시트 템플릿 및 일반 텍스트 문서에서도 작동합니다. 여기서 단락은 텍스트 한 줄을 의미합니다: 셀 텍스트의 한 줄 또는 텍스트 문서의 한 줄이 템플릿 태그 처리 후 빈 줄이 되면 줄 바꿈과 함께 제거됩니다. <<if>> 및 <<foreach>>와 같이 자체 라인에 작성된 태그는 더 이상 빈 라인을 남기지 않습니다.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
템플릿:
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
결과:
Prefix
Suffix
스프레드시트 셀에 동일한 템플릿 텍스트를 넣어도 셀 내에서 동일한 결과가 나타납니다. HTML 및 XML 문서는 그대로 유지됩니다.
보안: 외부 리소스 제어
<<image>> 또는 <<doc>> 태그는 데이터에서 가져온 URI로 평가될 수 있으며, GroupDocs.Assembly는 이를 방지할 방법 없이 가져왔습니다. 다른 사람이 제공한 데이터로 문서를 조립하는 서버는 내부 주소를 요청하도록 유도될 수 있습니다.
GroupDocs.Assembly는 이제 각 외부 리소스 참조가 어디에서 오는지(ExternalResourceOrigin)를 알려줍니다:
TEMPLATE— 템플릿 문서 자체가 리소스를 참조합니다. 예:<<image ["https://example.com/logo.png"]>>와 같은 태그에 리터럴 URI가 포함됩니다;DATA— 참조가 데이터에서 옵니다. 예: 태그 표현식이 평가한 URI.
기본적으로 템플릿이 참조하는 리소스는 이전과 같이 로드되고, 데이터에서 오는 리소스는 건너뛰어집니다. LoadSaveOptions의 네 멤버가 이를 제어합니다:
setSkipExternalResources(true가 기본값) — 외부 리소스를 로드하지 않습니다;setTrustTemplateResources(true가 기본값) — 건너뛰기가 활성화된 경우에도 템플릿이 참조하는 리소스를 로드합니다; 템플릿이 신뢰할 수 없는 경우false로 설정하십시오;getWhitelistedResources— 건너뛰기가 활성화된 경우에도 허용되는 호스트 이름 또는 절대 URI 접두사;setExternalResourceHandler— 요청되기 전에 모든 외부 리소스에 대해 호출되는ExternalResourceHandler로, 허용, 건너뛰기 또는 콘텐츠 제공을 할 수 있습니다.
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);
}
}
}
}
외부 리소스는 네트워크에 도달하는 리소스로, http, https 및 ftp URI, UNC 경로 및 원격 호스트가 있는 파일 URI를 포함합니다. 로컬 파일 경로는 영향을 받지 않습니다. 문서의 건너뛴 이미지는 투명 이미지로 대체되며, 건너뛴 <<image>> 또는 <<doc>> 값은 빈 값으로 처리됩니다.
향상
프레젠테이션의 테이블 셀 및 그룹 도형에 이미지
프레젠테이션 템플릿에서 <<image>> 태그는 텍스트 상자에만 배치할 수 있었습니다. 이제 테이블 셀도 이미지 컨테이너가 되어, 이미지가 셀의 그림 채우기로 적용됩니다. <<foreach>>로 반복되는 행의 셀도 포함되므로, 아이템과 사진을 나열하는 테이블을 만들 수 있습니다. -fitHeight를 사용하면 행이 이미지의 비율에 맞게 확대됩니다. 그룹 도형의 도형에 있는 태그(중첩 그룹 포함)는 이제 다른 도형과 같이 처리됩니다.
템플릿 폴더를 기준으로 상대 이미지 경로 해석
<<image>> 태그가 데이터에서 상대 파일 경로(Images/photo.png 등)를 받을 경우, 이제 Microsoft Office 문서의 연결 리소스와 유사하게 먼저 템플릿 폴더를 기준으로 해석합니다. 스트림에서 로드된 템플릿의 경우 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"));
}
해당 위치에 파일이 없으면 이전과 같이 현재 디렉터리가 사용됩니다.
16진수 색상 문자열
문자열로 제공된 색상은 이제 색상 이름이나 ARGB 정수 외에 16진수 값("#RRGGBB", "#RGB" 또는 "#AARRGGBB")도 될 수 있습니다. 이는 backColor 및 차트 색상 태그에서 적용됩니다. 예를 들어, 데이터에서 온 "#FF0000"을 가진 <<backColor [item.Color]>>는 빨간색을 적용합니다.
수정
- JSON, XML 및 CSV 데이터의 누락된 Boolean은 이제
?:조건 연산자와where,count,any,all,first에서false로 간주되며,NullPointerException으로 실패하지 않습니다. - **JSON 및 XML 데이터의 중첩 객체에 대한
groupBy와distinct**는 객체를 값으로 비교하여 동일한 고객이 하나의 그룹이 됩니다. 보존된 참조($id/$ref)를 포함한 JSON이 이제 지원됩니다. - **
License.setLicense(InputStream)**은 마크 위치에서ByteArrayInputStream을, 0 위치에서FileInputStream을 읽어, 다른 GroupDocs 제품에 라이선스를 적용하기 위해 이미 사용된 스트림이 “Unexpected EOF in prolog” 오류 없이 작동합니다. - 메터링 사용량은 문서를 조립하거나 미리보기를 생성 완료 시 보고되며, 백그라운드 스레드에서 나중에 보고되지 않습니다.
- ASCII 전용 템플릿의 텍스트 및 HTML 보고서는 UTF-8로 작성되어
Café또는Привет와 같은 데이터가 windows-1252로 손실되지 않습니다. - **엔진이 그리는 코드 텍스트를 가진 바코드(QR, DataMatrix, Aztec 등)**는 텍스트 박스 폰트가 설치되지 않아도 더 이상 실패하지 않습니다(예: Linux의 Calibri). 대신 대체 폰트가 사용됩니다.
- MSG 템플릿: 대화 주제의 태그가 제목의 태그와 같이 처리되어 Outlook이 메시지를 올바르게 스레드합니다.
- **스프레드시트, 프레젠테이션 및 텍스트 템플릿에서
<<doc>>**는 해당 형식에서 지원되지 않는다는 메시지와 함께 실패하며, 실패한assembleDocument는 빈 출력 파일을 남기지 않습니다. - HTML 콘텐츠: 단락을 종료하는
-html표현식 태그가 블록 요소로 끝나는 HTML 뒤에 추가 빈 단락을 남기지 않습니다 (ASSEMBLYJAVA-354). - GS1 바코드: GroupDocs.Assembly는 이제 EAN-14, SCC-14, SSCC-18 및 DataBar 바코드의 숫자 전용 코드 텍스트를 자체적으로 수정합니다. 이는 Aspose.BarCode 26.10이 이를 중단했기 때문이며, 이 바코드들은 26.10.1과 동일하게 유지됩니다.
Aspose 엔진이 26.10으로 업그레이드됨
GroupDocs.Assembly for Java 26.10.1은 초기 2026의 Aspose 라이브러리를 번들에 포함했으며, 이후 수정된 취약점이 보안 스캐너에 의해 보고되었습니다. 현재 번들된 엔진은 다음과 같습니다:
| 엔진 | 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 |
게시된 POM은 여전히 의존성을 선언하지 않습니다. 엔진이 새로 고쳐졌기 때문에 재생성된 문서는 바이트 수준에서 차이가 있을 수 있지만 시각적·기능적으로는 동일합니다. 생성된 출력물을 저장된 기준과 바이트 비교한다면, 업그레이드 후 기준을 새로 고치십시오.
Java 사용자 참고 사항
- JSON 또는 CSV 데이터의
Z또는 오프셋이 있는 날짜는 정확한 순간을 나타내는java.util.Date값이며, 포맷 패턴은 JVM 기본 시간대에 따라 출력합니다. 서버에 의존하지 않는 출력을 위해서는 예를 들어-Duser.timezone=UTC와 같이 고정 시간대로 JVM을 실행하십시오. ExternalResourceOrigin와PreviewFormats는 다른 Java API 열거형과 마찬가지로int상수 클래스입니다.CreatePageStream와ReleasePageStream은 함수형 인터페이스이므로 람다식을 사용할 수 있습니다.
업데이트 받는 방법
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-assembly</artifactId>
<version>26.11</version>
</dependency>
</dependencies>
직접 다운로드
다음 GroupDocs.Assembly for Java 26.11 다운로드 페이지에서 JAR를 다운로드하십시오.