Aspose.Slides FOSS
Java
Java에서 프레젠테이션을 로드하는 방법

Java에서 프레젠테이션을 로드하는 방법

Aspose.Slides FOSS for Java lets you open any .pptx 파일을 열어 내용을 검사하고, PPTX로 다시 저장하거나 데이터를 추출합니다. 이 가이드는 파일 열기, 슬라이드 순회, 도형 텍스트 읽기, 그리고 저장을 라운드 트립하는 방법을 다룹니다.

단계별 가이드

1단계: Maven 의존성 추가 

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

단계 2: 기존 프레젠테이션 열기

파일 경로를 다음에 전달합니다. Presentation 생성자에 전달합니다. try-with-resources를 사용하여 정리를 보장합니다.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("input.pptx")) {
    System.out.println("Slide count: " + prs.getSlides().size());
    prs.save("output.pptx", SaveFormat.PPTX);
}

소스 파일의 알 수 없는 XML 파트는 그대로 보존됩니다: 라이브러리는 아직 이해하지 못하는 내용을 절대 제거하지 않습니다.

단계 3: 슬라이드 검사

모든 슬라이드를 순회하며 각 슬라이드의 도형 개수를 출력합니다:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (int i = 0; i < prs.getSlides().size(); i++) {
        ISlide slide = prs.getSlides().get(i);
        int shapeCount = slide.getShapes().size();
        System.out.println("Slide " + i + ": " + shapeCount + " shapes");
    }
}

단계 4: 도형 텍스트 읽기

도형을 순회하고 텍스트 프레임이 있는 도형에서 텍스트를 읽습니다. TextFrame:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (ISlide slide : prs.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof IAutoShape) {
                IAutoShape autoShape = (IAutoShape) shape;
                ITextFrame tf = autoShape.getTextFrame();
                if (tf != null && !tf.getText().isEmpty()) {
                    System.out.println("  Shape text: " + tf.getText());
                }
            }
        }
    }
}

단계 5: 문서 속성 읽기

다음에서 핵심 문서 속성에 접근합니다. prs.getDocumentProperties():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    IDocumentProperties props = prs.getDocumentProperties();
    System.out.println("Title:   " + props.getTitle());
    System.out.println("Author:  " + props.getAuthor());
    System.out.println("Subject: " + props.getSubject());
}

단계 6: 라운드 트립 저장

프레젠테이션을 검사하거나 수정한 후, PPTX로 다시 저장합니다:

prs.save("output.pptx", SaveFormat.PPTX);

다른 경로에 저장하면 새 파일이 생성됩니다. 같은 경로에 저장하면 원본이 덮어쓰기됩니다.

일반적인 문제 및 해결책

java.io.FileNotFoundException

경로가 올바른지 확인합니다. .pptx 파일이 작업 디렉터리를 기준으로 올바른지 확인합니다. 사용합니다. java.nio.file.Paths 견고한 경로 구성을 위해:

import java.nio.file.Path;
import java.nio.file.Paths;

Path path = Paths.get("assets", "deck.pptx");
try (Presentation prs = new Presentation(path.toString())) {
    // ...
}

Exception: File format is not supported

이 라이브러리는 지원합니다. .pptx (Office Open XML)만 지원합니다. 레거시 .ppt (binary PowerPoint 97-2003) 파일은 지원되지 않습니다.

도형에는 getTextFrame() 메서드가 없습니다

일부 도형(Connectors, PictureFrames, GroupShapes)에는 텍스트 프레임이 없습니다. 다음으로 확인하세요. instanceof IAutoShape 형변환 및 텍스트 접근 전에.

자주 묻는 질문

로드 시 원본 콘텐츠가 모두 보존됩니까?

예. 알 수 없는 XML 파트는 라운드 트립 저장 시 그대로 보존됩니다. 라이브러리는 이해하는 문서 모델의 파트만 직렬화하고, 인식하지 못하는 XML은 그대로 전달합니다.

암호로 보호된 PPTX를 로드할 수 있나요?

암호로 보호된(암호화된) 프레젠테이션은 이 버전에서 지원되지 않습니다.

InputStream에서 로드하는 것이 지원되나요?

예. 해당 Presentation 생성자는 …을 허용합니다. InputStream:

import java.io.FileInputStream;

try (FileInputStream fis = new FileInputStream("deck.pptx");
     Presentation prs = new Presentation(fis)) {
    System.out.println("Slides: " + prs.getSlides().size());
}

또 보기

 한국어