GroupDocs를 사용하여 Java로 docx 편집 및 이미지 추출

edit docx with java를 수행하면서 모든 삽입된 이미지, 글꼴 또는 스타일시트를 추출해야 한다면, 올바른 곳에 오셨습니다. 이 튜토리얼에서는 GroupDocs.Editor for Java를 사용하여 Word 문서를 편집하고, 이미지, 글꼴 및 CSS 스타일시트를 추출하며, 여러 파일의 배치 처리를 수행하는 방법을 단계별로 안내합니다. 콘텐츠 관리 포털, 디지털 자산 파이프라인, 맞춤형 보고 엔진을 구축하든, 이러한 기술은 시간을 절약하고 코드를 깔끔하게 유지하며 Microsoft Office 설치 없이 작업할 수 있게 해줍니다.

빠른 답변

  • Java에서 docx 파일을 어떻게 편집합니까? Editor 인스턴스를 생성하고 파일을 로드한 뒤 edit()을 호출하여 반환된 EditableDocument를 수정합니다.
  • docx에서 이미지를 어떻게 추출할 수 있나요? document.getImages()를 사용하고 반환된 IImageResource 컬렉션을 반복하여 각각을 디스크에 저장합니다.
  • 글꼴도 추출할 수 있나요? 예—document.getFonts()를 호출하고 각 FontResourceBase 객체를 저장합니다.
  • 여러 파일을 한 번에 처리할 수 있나요? 물론입니다. .docx 파일이 있는 폴더를 순회하면; GroupDocs.Editor가 각 문서의 리소스를 분리합니다.
  • 프로덕션에 라이선스가 필요합니까? 평가를 위해 임시 또는 체험 라이선스가 필요하며, 프로덕션 배포에는 정식 라이선스가 필수입니다.

edit docx with java란 무엇인가요?

edit docx with java는 Microsoft Word 자체에 의존하지 않고 Java 코드를 사용하여 Microsoft Word .docx 파일을 프로그래밍 방식으로 열고, 수정하고, 저장하는 것을 의미합니다. GroupDocs.Editor는 Office Open XML 형식을 추상화한 고수준 API를 제공하여 Java에서 직접 문서 내용 및 삽입된 리소스를 작업할 수 있게 합니다.

왜 docx에서 이미지를 추출해야 할까요?

이미지를 추출하면 Word 파일에 삽입된 시각적 자산에 직접 접근할 수 있습니다. 웹 갤러리를 위한 그래픽 재활용, 디지털 자산 관리 시스템으로 자산 이전, 혹은 문서 내용과 별도로 아카이브해야 할 때 특히 유용합니다. 이미지를 추출함으로써 후속 처리 시 원본 파일 크기를 줄일 수 있습니다.

왜 GroupDocs.Editor로 Java 워드 문서 애플리케이션을 편집해야 할까요?

GroupDocs.Editor는 Office 설치가 필요 없으며, 모든 운영 체제에서 JDK 8 이상을 지원하고, 이미지, 글꼴 및 CSS를 추출하는 내장 메서드를 제공합니다. 전체 파일을 메모리에 로드하지 않고 수백 페이지 문서를 처리할 수 있어 고처리량 배치 작업에 이상적입니다.

필수 조건

  • Java Development Kit (JDK) 8 이상
  • Maven 의존성 관리용 (또는 JAR를 수동으로 추가할 수 있는 경우)
  • Java 프로젝트 구조 및 IDE 설정에 대한 기본적인 이해

GroupDocs.Editor for Java 설정

Maven 설정

Add the repository and dependency to your pom.xml exactly as shown in the official guide:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

직접 다운로드

Maven을 사용하지 않으려면, GroupDocs releases에서 최신 버전의 GroupDocs.Editor for Java을 다운로드하십시오.

라이선스 획득

GroupDocs.Editor를 사용하려면 무료 체험 또는 임시 라이선스를 획득하십시오. GroupDocs 웹사이트에서 임시 라이선스를 요청할 수 있습니다. 제공된 지침에 따라 코드에 라이선스를 적용하십시오.

기본 초기화 및 설정

라이브러리를 추가한 후, Word 파일을 가리키는 Editor 인스턴스를 생성합니다.
Editor는 Word 문서를 로드하고 관리하는 주요 클래스입니다.

Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());

이제 edit docx with java 스타일로 작업할 준비가 되었습니다.

구현 가이드

구현을 여러 개별 기능으로 나누어, 각각이 GroupDocs.Editor for Java의 특정 기능에 초점을 맞추도록 하겠습니다.

GroupDocs.Editor for Java로 docx 편집 방법

개요

문서를 로드하고 편집하는 것이 첫 단계입니다. 이 기능을 통해 애플리케이션 내에서 직접 콘텐츠를 확인하고 수정할 수 있습니다.

Step 1: Editor 객체 생성

Editor는 Word 문서를 로드하고 편집하기 위한 진입점 클래스입니다.

// Initialize the Editor with the path to your Word file.
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new WordProcessingLoadOptions());
Step 2: 문서 편집

EditableDocument는 문서의 편집 가능한 HTML 콘텐츠를 나타냅니다.

EditableDocument document = editor.edit(new WordProcessingEditOptions());

docx에서 이미지 추출 방법

개요

이미지를 추출하는 것은 시각 자료를 텍스트와 별도로 재사용하거나 아카이브해야 할 때 필수적입니다.

Step 1: 이미지 가져오기

document.getImages() 호출은 각각 단일 삽입 이미지에 해당하는 IImageResource 객체 컬렉션을 반환합니다.
IImageResource는 문서에서 추출된 단일 삽입 이미지를 나타냅니다.

// Get the list of image resources in the document.
List<IImageResource> images = document.getImages();

이미지를 폴더에 저장

개요

추출 후에는 로컬 디스크, 네트워크 공유 또는 클라우드 버킷 등 원하는 위치에 이미지를 저장할 수 있습니다.

Step 2: 추출된 이미지 저장

IImageResource 컬렉션을 반복하면서 각 인스턴스에 save()를 호출하고 대상 디렉터리와 파일 이름을 지정합니다.

String outputFolder = "YOUR_OUTPUT_DIRECTORY";

for (IImageResource oneImage : images) {
    // Save each image with its original name and extension.
    oneImage.save(outputFolder + oneImage.getFilenameWithExtension());
}

docx에서 글꼴 추출 방법

개요

글꼴은 브랜드를 위해 종종 삽입되며, 이를 추출하면 다양한 플랫폼에서 시각적 일관성을 유지할 수 있습니다.

Step 1: 글꼴 가져오기

document.getFonts() 메서드는 각각 삽입된 글꼴 파일에 해당하는 FontResourceBase 객체 리스트를 반환합니다.
FontResourceBase는 문서에서 추출된 삽입 글꼴 파일을 나타냅니다.

// Obtain a list of font resources within the document.
List<FontResourceBase> fonts = document.getFonts();

글꼴을 폴더에 저장

개요

추출된 글꼴을 디자인 도구, 다른 문서 또는 동일한 타이포그래피가 필요한 웹 애플리케이션에서 나중에 사용할 수 있도록 저장합니다.

Step 2: 추출된 글꼴 저장

FontResourceBase 컬렉션을 순회하면서 선택한 출력 디렉터리에 각 글꼴을 기록합니다.

for (FontResourceBase oneFont : fonts) {
    // Store each font resource with its original name and extension.
    oneFont.save(outputFolder + oneFont.getFilenameWithExtension());
}

docx에서 스타일시트 추출 방법

개요

스타일시트(CSS)는 시각적 레이아웃을 정의합니다. 이를 추출하면 웹이나 다른 문서 형식에서 스타일을 재사용할 수 있습니다.

Step 1: 스타일시트 가져오기

document.getStylesheets()를 호출하면 DOCX가 HTML로 변환될 때 생성된 CSS 리소스 컬렉션을 얻을 수 있습니다.
각 스타일시트는 DOCX 레이아웃에서 생성된 CSS 파일입니다.

// Access the list of CSS text resources in the document.
List<CssText> stylesheets = document.getCss();

스타일시트를 폴더에 저장

개요

CSS 파일을 저장하면 Word 외부에서 문서 스타일을 완전히 제어할 수 있어 웹 페이지나 다른 HTML 기반 출력과 원활하게 통합할 수 있습니다.

Step 2: 추출된 스타일시트 저장

save() 메서드를 사용하여 각 스타일시트를 디스크에 기록하고, 필요에 따라 명확하게 이름을 바꿀 수 있습니다.

for (CssText oneStylesheet : stylesheets) {
    // Preserve each stylesheet with its original name and extension.
    oneStylesheet.save(outputFolder + oneStylesheet.getFilenameWithExtension());
}

실제 적용 사례

  1. Digital asset management – 이미지를 중앙 저장소에 추출한 뒤 태그를 붙이고 인덱싱하여 빠르게 검색할 수 있습니다.
  2. Brand consistency – 모든 기업 문서, 프레젠테이션 및 마케팅 자료에서 일관된 브랜드를 보장하기 위해 글꼴을 추출합니다.
  3. Custom document templates – 추출된 스타일시트를 재사용하여 자동 보고서 생성용 일관된 HTML 템플릿을 구축합니다.
  4. Batch processing of Word docs – .docx 파일이 있는 폴더를 순회하면서 동일한 편집‑추출 워크플로를 각 파일에 적용하여 수작업을 크게 줄입니다.

성능 고려 사항

GroupDocs.Editor를 사용할 때 다음 팁을 기억하십시오:

  • Resource management – 각 문서 처리 후 editor.close()를 호출하거나 JVM의 가비지 컬렉터가 리소스를 해제하도록 합니다. 이는 장기 실행 서비스에서 메모리 누수를 방지합니다.
  • Batch processing – 파일을 순차적으로 또는 스레드 풀을 사용해 처리하되 메모리 사용량을 모니터링합니다; 각 문서는 독립된 메모리 공간을 차지합니다.
  • Load options tuning – 대용량 문서의 로딩 속도를 높이기 위해 WordProcessingLoadOptions(예: 맞춤법 검사 또는 OCR 비활성화)를 조정합니다.
  • File size limits – 스트리밍 아키텍처 덕분에 GroupDocs.Editor는 전체 내용을 메모리에 로드하지 않고도 최대 500 MB 파일을 처리할 수 있습니다.

자주 묻는 질문

Q: GroupDocs.Editor가 모든 Java 버전과 호환되나요?
A: 예, JDK 8 이상, Java 11, 17 및 향후 LTS 릴리스를 포함한 모든 버전에서 작동합니다.

Q: 암호로 보호된 문서를 편집할 수 있나요?
A: 물론입니다. Editor 인스턴스를 생성할 때 WordProcessingLoadOptions를 통해 비밀번호를 제공하면 됩니다.

Q: 리소스 추출이 워크플로에 어떤 도움이 되나요?
A: 자산을 중앙화하면 브랜드 업데이트가 간소화되고 중복 저장이 감소하며, 여러 프로젝트에서 이미지, 글꼴 및 CSS를 재사용할 수 있습니다.

Q: 배치 처리의 성능 영향은 무엇인가요?
A: 각 Editor 인스턴스를 적절히 닫고 가벼운 로드 옵션을 사용하면, 병렬로 수십 개의 파일을 처리하더라도 300페이지 문서당 메모리 사용량을 150 MB 이하로 유지할 수 있습니다.

Q: GroupDocs.Editor를 클라우드 스토리지 서비스와 통합할 수 있나요?
A: 예, 파일을 로컬에 먼저 다운로드하지 않고도 AWS S3, Azure Blob, Google Cloud Storage 등에서 직접 스트리밍하여 Editor에 전달할 수 있습니다.

리소스

이 가이드를 따라 하면 이제 edit docx with java에 대한 확고한 기반을 갖추게 되며, GroupDocs.Editor for Java를 사용해 모든 관련 리소스를 추출할 수 있습니다. 맞춤법 검사, 변경 내용 추적, 사용자 정의 HTML 변환 등 추가 API 기능을 자유롭게 실험하여 솔루션을 더욱 확장해 보세요.

마지막 업데이트: 2026-09-16
테스트 환경: GroupDocs.Editor 25.3 for Java
작성자: GroupDocs

관련 튜토리얼