GroupDocs.Editor Java로 DOCX 이미지 추출 및 문서 편집

현대 기업에서는 extract images docx 를 빠르고 신뢰성 있게 수행하는 것이 자동화된 워크플로우에 큰 변화를 가져옵니다. convert docx to html 가 필요하거나 웹 포털에 이미지를 삽입하거나 batch process word docs 파이프라인을 구축하려는 경우, GroupDocs.Editor for Java는 고성능, Microsoft‑Office‑없는 솔루션을 제공합니다. 이 가이드에서는 환경 설정부터 고급 편집까지 필요한 모든 내용을 단계별로 안내하므로 몇 분 안에 보고서 자동 생성 솔루션을 구축할 수 있습니다.

빠른 답변

  • Word 파일을 로드하기 위한 기본 클래스는 무엇입니까? Editor
  • 편집을 위한 HTML 마크업을 반환하는 메서드는 무엇입니까? edit() returns an EditableDocument
  • Word 문서에서 이미지를 추출하려면 어떻게 해야 합니까? Use getAllResources() on the EditableDocument
  • 편집된 내용을 디스크에 저장할 수 있습니까? Yes, call save() on the EditableDocument
  • 개발에 라이선스가 필요합니까? A free trial or temporary license works for testing; a full license is required for production

“extract images docx”란 무엇입니까?

Extract images docx는 .docx 파일을 로드하고, 편집 가능한 HTML 형태로 변환한 뒤 모든 삽입된 이미지, 폰트, 스타일시트를 추출하는 것을 의미합니다. 이를 통해 각 리소스를 완전히 제어할 수 있어 별도로 저장하거나 CDN에 재호스팅하거나 다른 문서에 삽입할 수 있습니다.

왜 Java용 GroupDocs.Editor를 사용합니까?

GroupDocs.Editor는 엔터프라이즈 수준 문서 처리를 위해 이상적인 포괄적인 기능 세트를 제공합니다. 30가지 이상의 입력 및 출력 형식을 지원하고, 전체 문서를 메모리에 로드하지 않고도 최대 500 MB 파일을 처리하며, 기존 애플리케이션에 쉽게 통합되는 간단한 Java API를 제공합니다.

  • Full‑featured Word support – Microsoft Office 없이 편집, 추출 및 변환 가능.
  • Seamless HTML conversion – 웹 기반 편집기나 CMS 통합에 최적.
  • Robust resource handling – 한 번의 호출로 이미지, 폰트, CSS를 가져옴.
  • Scalable performance – 배치 처리 및 대규모 보고서 생성에 이상적.
  • Convenient Java API – Java 8+ 및 인기 IDE와 자연스럽게 작동.

전제 조건

  • Java Development Kit (JDK) 8 이상.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 기본 Java 지식 및 Maven에 대한 친숙함.

필요한 라이브러리

프로젝트에 GroupDocs.Editor 라이브러리를 포함하십시오. Maven을 사용하여 종속성으로 추가합니다:

<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>

또는 최신 버전을 직접 GroupDocs.Editor for Java releases에서 다운로드하십시오.

라이선스 획득

GroupDocs.Editor를 사용하려면 무료 체험으로 시작하거나 임시 라이선스를 요청하거나 정식 라이선스를 구매할 수 있습니다. 라이브러리는 평가용으로 바로 사용할 수 있으며, 프로덕션 라이선스로 전환하려면 라이선스 파일을 업데이트하면 됩니다.

GroupDocs.Editor Java를 사용하여 편집 가능한 문서를 만드는 방법

Editor 클래스는 문서를 로드하고 편집 기능을 제공하며, EditableDocument는 로드된 파일을 편집 가능한 HTML 형태로 나타냅니다. 이 둘을 함께 사용하면 리소스 추출, 내용 수정 및 변경 저장을 위한 간단한 엔드‑투‑엔드 워크플로우를 구현할 수 있습니다.

직접 답변

.docx 파일 경로를 사용하여 Editor 클래스를 인스턴스화하고, edit()을 호출하여 EditableDocument를 얻은 다음 필요에 따라 HTML을 수정하고, 마지막으로 save()를 호출하여 변경 사항을 영구 저장합니다. 이 엔드‑투‑엔드 흐름을 통해 이미지를 추출하고, 내용을 편집하며, 몇 줄의 Java 코드만으로 문서를 재생성할 수 있습니다.

설치

  1. Add Dependency – pom.xml에 위의 Maven 스니펫이 포함되어 있는지 확인하십시오.
  2. Download JAR – 수동 설정을 선호한다면 공식 GroupDocs site에서 최신 JAR를 다운로드하십시오.
  3. Configure License – GroupDocs.Editor.lic 파일을 resources 폴더에 두거나 프로그래밍 방식으로 설정하십시오.

기본 초기화

Editor는 GroupDocs.Editor Java에서 문서를 로드하고, 편집하며, 저장하는 핵심 클래스입니다.

import com.groupdocs.editor.Editor;

// Initialize Editor with a sample Word document
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");

이 간단한 한 줄로 문서를 로드, 편집 및 저장할 수 있는 완전한 기능의 편집기를 얻을 수 있습니다.

단계별 가이드

Step 1: 문서를 EditableDocument로 로드

EditableDocument는 로드된 Word 파일을 편집 가능한 HTML 형태로 나타냅니다.

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.EditableDocument;

// Load the document into an EditableDocument
Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx");
EditableDocument beforeEdit = editor.edit();
  • Editor – 파일 I/O 및 형식 감지를 처리합니다.
  • EditableDocument – HTML 마크업 및 리소스 접근을 제공합니다.

Step 2: Word 콘텐츠 편집 (how to edit word)

이제 HTML 문자열을 조작하고, 플레이스홀더를 교체하거나 스타일을 업데이트할 수 있습니다. 변경 후 save()를 호출하여 저장합니다.

Step 3: 이미지 및 기타 리소스 추출

GroupDocs.Editor를 사용하면 모든 삽입된 리소스를 쉽게 추출할 수 있으며, 이는 바로 extract images docx 하는 방법입니다.

import com.groupdocs.editor.htmlcss.resources.IHtmlResource;
import java.util.List;

// Extract embedded HTML, images, fonts, and CSS
String allAsHtmlInsideOneString = beforeEdit.getEmbeddedHtml();
List<IHtmlResource> allResources = beforeEdit.getAllResources();

// Accessing specific resources
List<String> stylesheets = beforeEdit.getCssContent();
  • getEmbeddedHtml() – 전체 HTML 마크업을 반환합니다.
  • getAllResources() – 원본 Word 파일에 삽입된 모든 이미지, 폰트, 스타일시트의 목록을 제공합니다. getAllResources() 메서드는 이미지 및 폰트와 같은 모든 삽입 리소스 목록을 반환합니다.
  • **extract images from word** – ImageResource유형의 객체를 찾기 위해allResources`를 반복하면 됩니다.

Step 4: HTML 마크업에서 외부 링크 조정

문서에 사용자 지정 핸들러(예: CDN)를 가리켜야 하는 링크가 포함된 경우, 실시간으로 해당 링크를 재작성할 수 있습니다.

String customImagesRequesthandlerUri = "http://example.com/ImagesHandler/id=";
String htmlMarkup = beforeEdit.getContentString(customImagesRequesthandlerUri);
  • getContentString() – 모든 이미지 참조에 제공된 URI 접두사를 삽입하여 이미지 제공 위치를 제어할 수 있게 합니다. getContentString() 메서드는 리소스 링크에 선택적 URI 접두사가 포함된 HTML을 반환합니다.

Step 5: 편집된 문서를 디스크에 저장

모든 편집 및 리소스 조정이 끝난 후 결과를 HTML 파일에 다시 기록하거나(또는 나중에 DOCX로 재변환) 저장합니다.

// Save the edited document as an HTML file
beforeEdit.save("YOUR_OUTPUT_DIRECTORY/output.html");
  • save() – 편집된 HTML과 연결된 모든 리소스를 지정된 폴더에 저장합니다. save() 메서드는 편집된 HTML과 리소스를 출력 위치에 기록합니다.

Step 6: 폐기 상태 확인

특히 batch process word docs 를 수행할 때 적절한 리소스 관리가 중요합니다.

String res = !beforeEdit.isDisposed() ? "not" : "already";
  • isDisposed() – 문서의 네이티브 리소스가 해제되었으면 true를 반환합니다. isDisposed() 메서드는 문서 리소스가 이미 해제되었는지 여부를 나타냅니다. 작업이 끝난 큰 문서는 항상 해제하십시오.

Step 7: HTML에서 EditableDocument 생성

기존 HTML 파일이나 원시 마크업에서 시작할 수도 있으며, 이는 convert docx to html 시나리오에 유용합니다.

import com.groupdocs.editor.EditableDocument;

// Create EditableDocument from file and markup
EditableDocument afterEditFromFile = EditableDocument.fromFile("YOUR_OUTPUT_DIRECTORY/output.html");
EditableDocument afterEditFromMarkup = EditableDocument.fromMarkup(htmlMarkup, allResources);
  • fromFile() – 이전에 save()로 저장된 HTML 파일을 로드합니다.
  • fromMarkup() – 문자열과 해당 리소스 목록에서 직접 EditableDocument를 생성합니다.

GroupDocs.Editor를 사용하여 Word를 HTML로 변환하는 방법

Editor를 사용해 .docx를 로드하고 edit()를 호출한 뒤 getEmbeddedHtml() 또는 getContentString()을 통해 HTML을 가져오면 원본과 동일한 HTML 표현을 얻을 수 있습니다. getEmbeddedHtml() 메서드는 문서의 전체 HTML 마크업을 반환하며 레이아웃, 폰트, 이미지를 보존하므로 웹 페이지, 이메일에 삽입하거나 나중에 저장할 수 있습니다.

GroupDocs.Editor를 사용한 Word 문서 배치 처리

수십 개 또는 수백 개의 템플릿을 처리해야 할 때는 위 단계들을 루프나 CompletableFuture 파이프라인으로 감싸면 됩니다. 이 방법을 사용하면 많은 파일을 동시에 처리하면서 메모리 사용량을 낮게 유지할 수 있습니다. 각 문서 처리 후 dispose()를 호출(또는 GC에 맡기기)하여 메모리 사용량을 낮게 유지하십시오. dispose() 메서드는 문서가 사용한 네이티브 리소스를 해제합니다.

일반적인 문제 및 해결책

  • Large documents cause OutOfMemoryError – 모든 데이터를 메모리에 로드하지 말고 리소스를 스트리밍하고, EditableDocument를 사용 후 즉시 해제하십시오.
  • Images not appearing after conversion – getContentString()에 올바른 URI 접두사를 전달했는지 확인하거나 추출된 리소스를 대상 폴더에 복사하십시오.
  • License not recognized – GroupDocs.Editor.lic 파일이 클래스패스에 있는지 확인하거나 Editor 생성 전에 프로그래밍 방식으로 라이선스를 설정하십시오.

자주 묻는 질문

Q: GroupDocs.Editor Java를 사용하여 PDF를 편집할 수 있습니까?
A: 예, GroupDocs.Editor는 PDF를 포함한 다양한 형식을 지원합니다. 특정 메서드는 API reference를 확인하십시오.

Q: 대용량 문서를 효율적으로 처리하려면 어떻게 해야 합니까?
A: EditableDocument 인스턴스를 즉시 해제하고 Java의 CompletableFuture를 사용해 파일을 병렬 처리하는 등 리소스 관리 기법을 사용하십시오.

Q: GroupDocs.Editor가 모든 Java IDE와 호환됩니까?
A: 예, IntelliJ IDEA 및 Eclipse와 같은 인기 IDE에서 작동합니다.

Q: 많은 파일을 처리할 때 extract images docx를 수행하는 가장 좋은 방법은 무엇입니까?
A: EditableDocument.getAllResources()를 반복하고 ImageResource 객체를 필터링하십시오; 전용 폴더에 저장하거나 진행 중에 CDN에 업로드하십시오.

Q: 편집된 HTML을 DOCX 파일로 다시 변환할 수 있습니까?
A: 물론 가능합니다. saveAsDocx() 메서드는 편집된 HTML을 DOCX 파일로 변환합니다. 변경 후 EditableDocument.saveAsDocx("path/to/output.docx")를 사용하십시오.

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

{< /blocks/products/pf/tutorial-page-section >} {< /blocks/products/pf/main-container >} {< /blocks/products/pf/main-wrap-class >} {< blocks/products/products-backtop-button >}

관련 튜토리얼