xlsx 파일을 읽고 Java에서 GroupDocs로 Excel 편집하는 방법

Java 애플리케이션에서 xlsx 파일 내용을 읽고, 셀을 수정하거나 전체 워크북을 재구성해야 한다면, 여기가 바로 적합한 곳입니다. 이 튜토리얼에서는 GroupDocs.Editor for Java를 사용하여 워크북을 열고, 워크시트를 편집하며, 수식을 보존하고, 다중 탭 파일을 관리하고, 암호 보호된 파일이나 매우 큰 스프레드시트를 처리하는 방법을 단계별로 안내합니다—서버에 Microsoft Office를 설치할 필요 없이.

빠른 답변

  • 암호 보호된 Excel 파일을 편집할 수 있나요? 예 — 문서를 로드할 때 비밀번호만 제공하면 됩니다.
  • GroupDocs.Editor가 수식을 보존하나요? 물론입니다; 어떤 편집을 하더라도 수식은 그대로 작동합니다.
  • 다중 시트 편집을 지원하나요? 워크북 내에서 원하는 만큼의 워크시트를 열고, 수정하고, 저장할 수 있습니다.
  • 필요한 Java 버전은? Java 8 이상을 권장합니다.
  • 프로덕션에 라이선스가 필요합니까? 비시험용으로는 유효한 GroupDocs.Editor for Java 라이선스가 필요합니다.

Java 컨텍스트에서 “Excel 편집 방법”이란?

Java에서 Excel을 편집한다는 것은 .xlsx 또는 .xls 파일을 프로그래밍 방식으로 로드하고, 셀 값을 변경하며, 행/열을 추가하거나 제거하고, 결과를 수동 작업 없이 저장하는 것을 의미합니다. GroupDocs.Editor는 Office Open XML의 복잡성을 추상화하여, 모든 운영 체제에서 작동하는 깔끔하고 고수준의 API를 제공합니다.

왜 Java에서 GroupDocs.Editor로 Excel 스프레드시트를 편집할까요?

GroupDocs.Editor는 전체 기능을 갖춘 API를 제공하여 50개 이상의 입력 및 출력 형식을 지원하고, 파일 전체를 메모리에 로드하지 않고도 수백 페이지에 달하는 워크북을 처리하며, Java 8을 지원하는 모든 OS에서 실행됩니다. 따라서 xlsx 파일 데이터를 직접 읽고 편집할 수 있습니다. 이는 Microsoft Office가 필요 없게 하고, 라이선스 비용을 절감하며, 클라우드 또는 온프레미스 환경에서 자동화된 배치 처리를 가능하게 합니다.

전제 조건

  • Java 8 이상이 설치되어 있어야 합니다.
  • 프로젝트에 GroupDocs.Editor for Java 라이브러리를 추가합니다 (Maven/Gradle).
  • 프로덕션 사용을 위한 유효한 GroupDocs.Editor 라이선스가 필요합니다.

단계별 가이드

단계 1: 편집기 초기화

Editor는 GroupDocs.Editor for Java의 주요 진입점으로, 스프레드시트 문서를 로드하고 저장합니다. 작업하려는 Excel 파일을 지정하여 Editor 인스턴스를 생성합니다. 워크북이 암호 보호된 경우, 로드 옵션에 비밀번호를 포함합니다.

단계 2: 워크북 로드

load 메서드를 호출하여 SpreadsheetDocument 객체를 얻습니다. SpreadsheetDocument 클래스는 메모리 내에서 전체 Excel 워크북을 나타내며, 워크시트, 셀 및 수식에 접근할 수 있게 합니다.

단계 3: 셀, 수식 또는 워크시트 수정

필요한 워크시트로 이동한 뒤, API를 사용해 셀 값(setValue)이나 수식(setFormula)을 변경합니다. 새 워크시트를 추가하거나 기존 워크시트를 삭제하고, 탭 순서를 재배열할 수도 있습니다. 계산이 필요한 셀에는 반드시 setFormula를 사용하세요; 그렇지 않으면 수식이 정적 텍스트로 저장됩니다.
setValue는 셀의 값을 설정합니다. setFormula는 셀에 수식을 할당합니다.

단계 4: 업데이트된 워크북 저장

모든 변경이 완료되면 save 메서드를 호출하여 워크북을 디스크에 저장하거나 클라이언트로 스트리밍합니다. 원래의 계산 엔진은 그대로 유지되므로, 파일을 Excel에서 열면 수식이 다시 계산됩니다.

프로 팁: 개발 중에 원본 파일의 복사본을 사용하여 실수로 인한 데이터 손실을 방지하세요.

Java로 암호 보호된 Excel 파일 편집 방법

비밀번호가 포함된 LoadOptions 객체를 사용해 워크북을 로드한 뒤, 보호되지 않은 파일과 동일하게 편집합니다. 편집기는 메모리에서 파일을 복호화하고 변경 사항을 적용한 뒤 저장 시 다시 암호화하여 보호를 유지합니다.
LoadOptions는 암호화된 워크북에 대한 비밀번호와 같은 로드 옵션을 지정합니다.

대용량 Excel 워크북 효율적으로 처리하기

대형 워크북은 많은 메모리를 차지할 수 있습니다. 리소스 사용량을 낮게 유지하려면:

  • 전체 워크북을 메모리에 로드하는 대신, 한 번에 하나의 워크시트만 처리합니다.
  • 스트리밍 API(새로운 GroupDocs.Editor 릴리스에서 제공)를 사용해 행을 점진적으로 읽고 씁니다.
  • 워크시트 편집이 끝난 후 해당 워크시트에 대한 참조를 해제하여 가비지 컬렉터가 메모리를 회수하도록 합니다.

일반적인 문제와 해결책

  • 수식이 정적 텍스트가 되는 경우: 수식을 포함해야 하는 셀에는 setValue 대신 setFormula를 사용하세요.
  • 암호 보호된 파일이 열리지 않음: 로드 옵션에 올바른 비밀번호가 제공되었는지 다시 확인하세요.
  • 대용량 파일에서 메모리 압박: 워크시트별로 처리하거나 스트리밍을 활성화해 힙 사용량을 줄이세요.

사용 가능한 튜토리얼

Java에서 GroupDocs.Editor로 마스터 Excel 탭 편집: 개발자를 위한 종합 가이드

GroupDocs.Editor for Java를 사용해 프로그래밍 방식으로 Excel 탭을 편집하고 저장하는 방법을 배워보세요. 오늘 바로 스프레드시트 관리 능력을 향상시키세요!

추가 리소스

자주 묻는 질문

Q: .xlsx와 .xls 형식을 모두 편집할 수 있나요?
A: 예, GroupDocs.Editor는 최신 및 레거시 Excel 파일 형식을 모두 지원합니다.

Q: 편집 시 셀 스타일 및 서식이 보존되나요?
A: 명시적으로 변경하지 않는 한, 모든 원본 셀 스타일, 폰트 및 색상이 유지됩니다.

Q: 매우 큰 스프레드시트를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 워크북을 청크 단위로 처리하고, 개별 워크시트를 작업하며, 각 작업 후 즉시 리소스를 해제합니다.

Q: 프로그래밍으로 새 워크시트를 추가할 수 있나요?
A: 물론입니다. addWorksheet 메서드를 사용해 워크북에 새 탭을 만들 수 있습니다.

Q: 프로덕션 배포를 위한 라이선스 옵션은 무엇이 있나요?
A: GroupDocs.Editor는 다양한 프로젝트 요구에 맞춰 영구, 구독 및 임시 라이선스를 제공합니다.

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

관련 튜토리얼