복잡한 3D 차트를 Excel 워크북에서 휴대용 PDF 파일로 변환하는 것은 보고 및 시각 데이터 공유를 위해 자주 필요합니다. Aspose.Cells Cloud SDK for Java은 Java 개발자를 위해 이 작업을 간소화하는 강력한 클라우드 기반 라이브러리를 제공합니다. 이 가이드에서는 환경 설정부터 최종 문서 가져오기까지 Java에서 3D를 PDF로 변환하는 전체 과정을 단계별로 안내합니다. 자세한 코드 walkthrough, 완전한 예제, 그리고 REST API 통합을 위한 동등한 cURL 명령을 확인할 수 있습니다.
Aspose.Cells Cloud SDK for Java 설정
시작하기 전에 다음을 확인하십시오:
- Java 17 이상이 설치되어 있어야 합니다.
- Maven 또는 Gradle을 사용한 종속성 관리.
- Aspose Cloud 계정과 Client Id 및 Client Secret.
- 클라우드 호출을 위한 인터넷 액세스.
아래에 표시된 Maven 종속성을 사용하여 SDK를 프로젝트에 추가하고 공식 다운로드 페이지에서 최신 JAR를 다운로드하십시오.
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-cells-cloud</artifactId>
<version>26.7</version>
</dependency>
라이브러리를 직접 다운로드 URL에서 얻을 수도 있습니다.
클라이언트를 자격 증명으로 구성합니다. 이 스니펫은 전체 예제에서 직접 가져온 것입니다.
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
구성이 완료되면 변환 워크플로를 시작할 준비가 됩니다.
Java에서 3D를 PDF로 변환 - 단계별 워크스루
1단계: Excel 워크북을 클라우드 스토리지에 업로드
먼저, 3D 차트가 포함된 XLSX 파일을 업로드합니다. FilesApi가 업로드를 처리합니다.
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
2단계: PDF 저장 옵션 준비
PDF 출력을 미세 조정하려면 글꼴 캐싱, 이미지 압축 및 메모리 최적화를 활성화하십시오. 이러한 옵션은 3D 시각 품질을 유지하면서 PDF 크기를 낮게 유지하는 데 도움이 됩니다.
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true);
pdfOptions.setCompressImages(true);
pdfOptions.setImageQuality(80);
pdfOptions.setEnableMemoryOptimization(true);
3단계: 워크북을 PDF로 변환
Call the postWorkbookSaveAs method of CellsApi to perform the conversion. The API reference for this method is available in the Aspose.Cells API Reference.
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null); // storage (default)
4단계: 결과 PDF 다운로드
변환이 성공적으로 완료되면 PDF 바이트를 다운로드하고 로컬 파일에 기록합니다.
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
5단계: 선택적 정리
클라우드 스토리지에서 임시 파일을 제거하여 계정을 깔끔하게 유지하세요.
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
3D를 PDF로 변환하기 위한 전체 Java 구현 - 완전한 코드 예제
다음 예제는 Aspose.Cells Cloud SDK for Java를 사용하여 3D Excel 워크북을 PDF로 엔드‑투‑엔드 변환하는 방법을 보여줍니다.
import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.api.FilesApi;
import com.aspose.cloud.cells.client.ApiException;
import com.aspose.cloud.cells.client.Configuration;
import com.aspose.cloud.cells.model.PdfSaveOptions;
import com.aspose.cloud.cells.model.FilesUploadResult;
import com.aspose.cloud.cells.model.WorkbookResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
public class AsposeCells3DToPdfExample {
public static void main(String[] args) {
// -------------------- Configuration --------------------
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
// Optional: config.setBasePath("https://api.aspose.cloud"); // default
// -------------------- API Instances --------------------
CellsApi cellsApi = new CellsApi(config);
FilesApi filesApi = new FilesApi(config);
// -------------------- Local & Remote Paths --------------------
String localInputPath = "input.xlsx"; // Excel file containing 3D charts
String remoteInputName = "input.xlsx"; // Name used in cloud storage
String remoteOutputName = "output.pdf"; // Desired PDF name in cloud storage
String localOutputPath = "output.pdf"; // Where to save the downloaded PDF
try {
// -------------------- Upload Excel to Cloud --------------------
FilesUploadResult uploadResult = filesApi.uploadFile("", new File(localInputPath));
if (uploadResult == null || uploadResult.getUploaded().isEmpty()) {
System.err.println("Upload failed.");
return;
}
// -------------------- Prepare PDF Save Options (Performance) --------------------
PdfSaveOptions pdfOptions = new PdfSaveOptions();
pdfOptions.setCacheFont(true); // Cache fonts for faster processing
pdfOptions.setCompressImages(true); // Compress images to reduce size
pdfOptions.setImageQuality(80); // Balance quality and size
pdfOptions.setEnableMemoryOptimization(true); // Reduce memory footprint
// -------------------- Convert Workbook to PDF --------------------
WorkbookResponse convertResponse = cellsApi.postWorkbookSaveAs(
remoteInputName, // source workbook name
"pdf", // target format
remoteOutputName, // output path in cloud storage
pdfOptions, // save options
"", // folder (root)
null // storage (default)
);
if (convertResponse == null || convertResponse.getCode() != 200) {
System.err.println("Conversion failed.");
return;
}
// -------------------- Download Resulting PDF --------------------
byte[] pdfBytes = filesApi.downloadFile(remoteOutputName);
try (FileOutputStream fos = new FileOutputStream(new File(localOutputPath))) {
fos.write(pdfBytes);
}
System.out.println("Conversion completed successfully. PDF saved to " + localOutputPath);
} catch (ApiException | IOException e) {
e.printStackTrace();
} finally {
// -------------------- Optional Cleanup --------------------
try {
filesApi.deleteFile(remoteInputName, null, null);
filesApi.deleteFile(remoteOutputName, null, null);
} catch (ApiException ignored) {
}
}
}
}
Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로(
input.xlsx,output.pdf등)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 후 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 문의하십시오.
cURL을 사용한 REST API 변환 - Aspose.Cells Cloud
언어에 구애받지 않는 접근 방식을 선호한다면, 동일한 변환을 Aspose.Cells Cloud REST API에 대한 간단한 cURL 명령으로 수행할 수 있습니다.
1. 인증하고 액세스 토큰을 얻으세요
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
응답에는 이후 호출에서 사용할 access_token이 포함되어 있습니다.
2. 원본 XLSX 파일 업로드
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@input.xlsx"
3. 워크북을 PDF로 변환
curl -X POST "https://api.aspose.cloud/v3.0/cells/input.xlsx/saveAs/pdf?outputPath=output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"CacheFont": true,
"CompressImages": true,
"ImageQuality": 80,
"EnableMemoryOptimization": true
}'
4. 생성된 PDF 다운로드
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.pdf
이 명령은 Java 코드를 작성하지 않고도 동일한 Java에서 3D를 PDF로 변환 워크플로를 수행합니다. 자세한 내용은 공식 API 문서를 참조하십시오.
결론
위 단계들을 따라 하면 Aspose.Cells Cloud SDK for Java를 사용하여 3D Excel 워크북을 고품질 PDF 파일로 안정적으로 변환할 수 있습니다. 이 라이브러리는 3D 다이어그램 렌더링이라는 무거운 작업을 처리하고, PDF 저장 옵션을 통해 크기와 성능을 제어할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보하는 것을 기억하세요; 가격 세부 정보는 제품 페이지에서 확인할 수 있으며 임시 라이선스는 임시 라이선스 페이지에서 얻을 수 있습니다. 이 지식을 바탕으로 Java 애플리케이션에 3D를 PDF로 변환하는 기능을 통합하고 최종 사용자에게 다듬어진 보고서를 제공할 준비가 되었습니다.
자주 묻는 질문
-
Java와 Aspose.Cells를 사용하여 3D를 PDF로 변환하려면 어떻게 구현합니까?
SDK를 사용하여 XLSX 파일을 업로드하고,PdfSaveOptions를 구성한 뒤postWorkbookSaveAs를 호출하여 결과 PDF를 다운로드합니다. 이 문서의 전체 코드 샘플은 정확한 순서를 보여줍니다. -
Java에서 코드를 작성하지 않고 3D 다이어그램 PDF 변환을 수행할 방법이 있나요?
예, 제공된 REST API와 cURL 명령을 사용하면 HTTP 요청을 할 수 있는 모든 플랫폼에서 동일한 결과를 얻을 수 있습니다. -
3D 시각화 PDF 변환과 일반 Excel to PDF 변환의 차이점은 무엇인가요?
3D 시각화는 차트 개체의 추가 렌더링이 필요하며, 이는 SDK가 자동으로 처리합니다. 일반 변환은 이러한 3D 렌더링 단계를 건너뛰어 그래픽이 누락될 수 있습니다. -
java Excel를 PDF로 변환하는 비‑3D 워크북에 동일한 워크플로를 사용할 수 있나요?
물론입니다. 동일한 API 호출은 모든 Excel 파일에서 작동하며, 필요하지 않은 경우 3D 전용 옵션을 생략하거나 조정하면 됩니다.