Java에서 프레젠테이션 저장

개요

Open Presentations in Java 은 프레젠테이션을 열 때 Presentation 클래스를 사용하는 방법을 설명합니다. 이 문서에서는 프레젠테이션을 생성하고 저장하는 방법을 설명합니다. Presentation 클래스에는 프레젠테이션 내용이 들어 있습니다. 처음부터 프레젠테이션을 만들든 기존 프레젠테이션을 수정하든 작업이 끝나면 저장해야 합니다. Aspose.Slides for Java를 사용하면 파일 또는 스트림에 저장할 수 있습니다. 이 문서에서는 프레젠테이션을 저장하는 다양한 방법을 설명합니다.

파일에 프레젠테이션 저장

프레젠테이션을 파일에 저장하려면 Presentation 클래스의 save 메서드를 호출합니다. 메서드에 파일 이름과 저장 형식을 전달합니다. 다음 예제는 Aspose.Slides를 사용하여 프레젠테이션을 저장하는 방법을 보여줍니다.

// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
Presentation presentation = new Presentation();
try {
    // 여기에서 작업을 수행합니다...

    // 프레젠테이션을 파일에 저장합니다.
    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

스트림에 프레젠테이션 저장

출력 스트림을 Presentation 클래스의 save 메서드에 전달하여 프레젠테이션을 스트림에 저장할 수 있습니다. 프레젠테이션은 다양한 스트림 유형에 쓸 수 있습니다. 아래 예제에서는 새 프레젠테이션을 만들고 파일 스트림에 저장합니다.

// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
Presentation presentation = new Presentation();
try {
    OutputStream fileStream = new FileOutputStream("Output.pptx");
    try {
        // 프레젠테이션을 스트림에 저장합니다.
        presentation.save(fileStream, SaveFormat.Pptx);
    } finally {
        fileStream.close();
    }
} finally {
    presentation.dispose();
}

미리 정의된 보기 유형으로 프레젠테이션 저장

Aspose.Slides를 사용하면 생성된 프레젠테이션이 열릴 때 PowerPoint가 사용하는 초기 보기를 ViewProperties 클래스를 통해 설정할 수 있습니다. ViewType 열거형의 값을 사용하여 setLastView 메서드를 호출합니다.

Presentation presentation = new Presentation();
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Strict Office Open XML 형식으로 프레젠테이션 저장

Aspose.Slides를 사용하면 Strict Office Open XML 형식으로 프레젠테이션을 저장할 수 있습니다. 저장 시 PptxOptions 클래스를 사용하고 해당 conformance 속성을 설정합니다. Conformance.Iso29500_2008_Strict 를 설정하면 출력 파일이 Strict Office Open XML 형식으로 저장됩니다.

아래 예제는 프레젠테이션을 생성하고 Strict Office Open XML 형식으로 저장합니다.

PptxOptions options = new PptxOptions();
options.setConformance(Conformance.Iso29500_2008_Strict);

// 프레젠테이션 파일을 나타내는 Presentation 클래스를 인스턴스화합니다.
Presentation presentation = new Presentation();
try {
    // 프레젠테이션을 Strict Office Open XML 형식으로 저장합니다.
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Zip64 모드로 Office Open XML 형식에 프레젠테이션 저장

Office Open XML 파일은 ZIP 아카이브이며, 각 파일의 압축 해제 크기, 압축된 크기 및 전체 아카이브 크기에 4GB(2^32 바이트) 제한을 두고, 아카이브에 포함될 수 있는 파일 수를 65,535(2^16‑1) 개로 제한합니다. ZIP64 형식 확장은 이러한 제한을 2^64까지 높입니다.

IPptxOptions.setZip64Mode 메서드를 사용하면 Office Open XML 파일을 저장할 때 ZIP64 형식 확장을 언제 사용할지 선택할 수 있습니다.

이 메서드는 다음 모드와 함께 사용할 수 있습니다:

  • IfNecessary 은 위 제한을 초과하는 경우에만 ZIP64 형식 확장을 사용합니다. 기본 모드입니다.
  • Never 은 ZIP64 형식 확장을 사용하지 않습니다.
  • Always 은 항상 ZIP64 형식 확장을 사용합니다.

다음 코드는 ZIP64 형식 확장이 활성화된 상태로 PPTX로 프레젠테이션을 저장하는 방법을 보여줍니다:

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setZip64Mode(Zip64Mode.Always);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

썸네일을 새로 고치지 않고 프레젠테이션 저장

PptxOptions.setRefreshThumbnail 메서드는 PPTX로 프레젠테이션을 저장할 때 썸네일 생성 여부를 제어합니다:

  • true 로 설정하면 저장 중에 썸네일이 새로 고쳐집니다. 기본값입니다.
  • false 로 설정하면 현재 썸네일이 유지됩니다. 프레젠테이션에 썸네일이 없으면 생성되지 않습니다.

아래 코드에서는 썸네일을 새로 고치지 않고 PPTX로 프레젠테이션을 저장합니다.

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setRefreshThumbnail(false);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pptx", SaveFormat.Pptx, pptxOptions);
}
finally {
    presentation.dispose();
}

저장 진행 상황을 백분율로 업데이트

IProgressCallback 인터페이스는 ISaveOptions 인터페이스와 추상 SaveOptions 클래스가 제공하는 setProgressCallback 메서드를 통해 사용됩니다. setProgressCallbackIProgressCallback 구현을 지정하면 저장 진행 상황을 백분율로 받을 수 있습니다.

다음 코드 조각은 IProgressCallback을 사용하는 방법을 보여줍니다.

ISaveOptions saveOptions = new PdfOptions();
saveOptions.setProgressCallback(new ExportProgressHandler());

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pdf", SaveFormat.Pdf, saveOptions);
} finally {
    presentation.dispose();
}
class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        // 여기에서 진행률 백분율 값을 사용합니다.
        int progress = (int) progressValue;

        System.out.println(progress + "% of the file has been converted.");
    }
}

FAQ

‘빠른 저장’(증분 저장)이 지원되어 변경된 부분만 기록되나요?

아니요. 저장 시마다 전체 대상 파일이 새로 생성되며, 증분 ‘빠른 저장’은 지원되지 않습니다.

다중 스레드에서 동일한 Presentation 인스턴스를 저장하는 것이 스레드 안전한가요?

아니요. Presentation 인스턴스는 스레드 안전하지 않으며 단일 스레드에서 저장해야 합니다.

저장 시 하이퍼링크와 외부 연결 파일은 어떻게 처리되나요?

Hyperlinks 은 유지됩니다. 외부 연결 파일(예: 상대 경로를 사용한 비디오)은 자동으로 복사되지 않으므로, 참조 경로가 계속 접근 가능하도록 해야 합니다.

문서 메타데이터(작성자, 제목, 회사, 날짜)를 설정/저장할 수 있나요?

예. 표준 문서 속성 이 지원되며 저장 시 파일에 기록됩니다.