Java에서 프레젠테이션 열기
소개
처음부터 PowerPoint 프레젠테이션을 만드는 것뿐만 아니라, Aspose.Slides는 기존 프레젠테이션을 열 수도 있습니다. 프레젠테이션을 로드한 후에는 해당 프레젠테이션에 대한 정보를 조회하고, 슬라이드 내용을 편집하며, 새 슬라이드를 추가하고, 기존 슬라이드를 제거하는 등 다양한 작업을 할 수 있습니다.
프레젠테이션 열기
기존 프레젠테이션을 열려면 Presentation 클래스를 인스턴스화하고 파일 경로를 생성자에 전달합니다.
다음 Java 예제는 프레젠테이션을 열고 슬라이드 수를 가져오는 방법을 보여줍니다:
// Presentation 클래스를 인스턴스화하고 파일 경로를 생성자에 전달합니다.
Presentation presentation = new Presentation("Sample.pptx");
try {
// 프레젠테이션의 전체 슬라이드 수를 출력합니다.
System.out.println(presentation.getSlides().size());
} finally {
presentation.dispose();
}
암호로 보호된 프레젠테이션 열기
암호로 보호된 프레젠테이션을 열어야 할 경우, LoadOptions 클래스의 setPassword 메서드에 비밀번호를 전달하여 복호화하고 로드합니다. 다음 Java 코드가 이 작업을 시연합니다:
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");
Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
// 복호화된 프레젠테이션에 대해 작업을 수행합니다.
} finally {
presentation.dispose();
}
대용량 프레젠테이션 열기
Aspose.Slides는 특히 LoadOptions 클래스의 getBlobManagementOptions 메서드를 통해 대용량 프레젠테이션을 로드할 때 도움이 되는 옵션을 제공합니다.
다음 Java 코드는 대용량 프레젠테이션(예: 2 GB)을 로드하는 방법을 보여줍니다:
final String filePath = "LargePresentation.pptx";
LoadOptions loadOptions = new LoadOptions();
// KeepLocked 동작을 선택합니다—프레젠테이션 파일은 전체 수명 동안 잠긴 상태를 유지합니다
// Presentation 인스턴스이지만 메모리로 로드하거나 임시 파일에 복사할 필요가 없습니다.
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB
Presentation presentation = new Presentation(filePath, loadOptions);
try {
// 대용량 프레젠테이션이 로드되었으며 사용할 수 있습니다. 메모리 사용량은 낮게 유지됩니다.
// 프레젠테이션을 수정합니다.
presentation.getSlides().get_Item(0).setName("Large presentation");
// 프레젠테이션을 다른 파일에 저장합니다. 이 작업 중 메모리 사용량은 낮게 유지됩니다.
presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);
// 이렇게 하지 마세요! 프레젠테이션 객체가 해제될 때까지 파일이 잠겨 있어 I/O 예외가 발생합니다.
//Files.delete(Paths.get(filePath));
} finally {
presentation.dispose();
}
// 여기서 수행해도 됩니다. 원본 파일은 이제 프레젠테이션 객체에 의해 잠겨 있지 않습니다.
Files.delete(Paths.get(filePath));
Info
스트림을 사용할 때 발생할 수 있는 특정 제한을 우회하기 위해 Aspose.Slides가 스트림 내용을 복사할 수 있습니다. 스트림에서 대용량 프레젠테이션을 로드하면 프레젠테이션이 복사되어 로드 속도가 느려질 수 있습니다. 따라서 대용량 프레젠테이션을 로드해야 할 경우 스트림 대신 프레젠테이션 파일 경로를 사용하는 것을 강력히 권장합니다.
비디오, 오디오, 고해상도 이미지 등 큰 객체를 포함하는 프레젠테이션을 만들 때는 메모리 사용량을 줄이기 위해 BLOB 관리를 사용할 수 있습니다.
외부 리소스 제어
Aspose.Slides는 외부 리소스를 관리할 수 있게 해주는 IResourceLoadingCallback 인터페이스를 제공합니다. 다음 Java 코드는 IResourceLoadingCallback 인터페이스를 사용하는 방법을 보여줍니다:
LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());
Presentation presentation = new Presentation("Sample.pptx", loadOptions);
class ImageLoadingHandler implements IResourceLoadingCallback {
public int resourceLoading(IResourceLoadingArgs args) {
if (args.getOriginalUri().endsWith(".jpg")) {
try {
// 대체 이미지를 로드합니다.
byte[] imageData = Files.readAllBytes(new File("aspose-logo.jpg").toPath());
args.setData(imageData);
return ResourceLoadingAction.UserProvided;
} catch (RuntimeException ex) {
return ResourceLoadingAction.Skip;
} catch (IOException ex) {
ex.printStackTrace();
}
} else if (args.getOriginalUri().endsWith(".png")) {
// 대체 URL을 설정합니다.
args.setUri("http://www.google.com/images/logos/ps_logo2.png");
return ResourceLoadingAction.Default;
}
// 다른 모든 이미지를 건너뜁니다.
return ResourceLoadingAction.Skip;
}
}
임베드된 바이너리 객체 없이 프레젠테이션 로드
PowerPoint 프레젠테이션에는 다음과 같은 유형의 임베드된 바이너리 객체가 포함될 수 있습니다:
- VBA 프로젝트 ( IPresentation.getVbaProject 로 접근 가능);
- OLE 객체 임베드 데이터 ( IOleEmbeddedDataInfo.getEmbeddedFileData 로 접근 가능);
- ActiveX 컨트롤 바이너리 데이터 ( IControl.getActiveXControlBinary 로 접근 가능).
ILoadOptions.setDeleteEmbeddedBinaryObjects 메서드를 사용하면 임베드된 바이너리 객체가 전혀 없는 상태로 프레젠테이션을 로드할 수 있습니다.
이 메서드는 잠재적으로 악성인 바이너리 콘텐츠를 제거하는 데 유용합니다. 다음 Java 코드는 임베드된 바이너리 콘텐츠 없이 프레젠테이션을 로드하는 방법을 보여줍니다:
LoadOptions loadOptions = new LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);
Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
// 프레젠테이션에 대해 작업을 수행합니다.
} finally {
presentation.dispose();
}
FAQ
파일이 손상되어 열 수 없다는 것을 어떻게 알 수 있나요?
로드 중에 구문 분석/형식 검증 예외가 발생합니다. 이러한 오류는 종종 잘못된 ZIP 구조 또는 손상된 PowerPoint 레코드를 언급합니다.
열 때 필수 글꼴이 누락되면 어떻게 되나요?
파일은 열리지만 이후 렌더링/내보내기 시 글꼴이 대체될 수 있습니다. 런타임 환경에 글꼴 대체 구성하거나 필요한 글꼴 추가하십시오.
열 때 임베드된 미디어(비디오/오디오)는 어떻게 처리되나요?
프레젠테이션 리소스로 사용할 수 있게 됩니다. 미디어가 외부 경로로 참조되는 경우 해당 경로가 환경에서 접근 가능해야 하며, 그렇지 않으면 렌더링/내보내기 시 미디어가 누락될 수 있습니다.