Excel 파일을 프로그래밍 방식으로 편집하는 것은 데이터 기반 Java 애플리케이션을 구축할 때 자주 요구되는 작업이며, 특히 보고서를 업데이트하거나 동적으로 스프레드시트를 실시간으로 생성해야 할 때 필요합니다. GroupDocs.Editor Cloud SDK for Java는 저수준 파일 형식을 다루지 않고도 XLSX 워크북을 조작할 수 있는 강력한 REST 기반 라이브러리를 제공합니다. 이 가이드에서는 완전한 Java 코드 예제, 동등한 cURL 명령, 설치 단계 및 구성 옵션을 확인하여 Java 프로젝트에 Excel 편집 기능을 통합하는 방법을 보여줍니다.

REST를 사용하여 Java에서 Excel 시트 편집 - 전체 코드 예제

다음 예제는 Excel 워크북을 로드하고 변경을 수행한 뒤, GroupDocs.Editor Cloud SDK for Java를 사용하여 스토리지에 다시 저장하는 방법을 보여줍니다.

import com.groupdocs.cloud.editor.api.*;
import com.groupdocs.cloud.editor.client.*;
import com.groupdocs.cloud.editor.model.*;
import com.groupdocs.cloud.editor.model.requests.*;

public class EditDocument {
    public static void main(String[] args) {
        // Configure API client
        ApiClient apiClient = new ApiClient();
        apiClient.setBasePath("https://api.groupdocs.cloud");
        apiClient.setAppSid("YOUR_CLIENT_ID");
        apiClient.setAppKey("YOUR_CLIENT_SECRET");

// Create EditorApi instance
        EditorApi editorApi = new EditorApi(apiClient);

// Load document
        LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
        LoadResult loadResult = editorApi.loadDocument(loadRequest);

// Get document pages (for Excel, each sheet is a page)
        // Edit cell via editing HTML? Not sure.

// Save document
        SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
        editorApi.saveDocument(saveRequest);
    }
}

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로(sample.xlsx, output.xlsx)를 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 문의하십시오.

cURL 명령을 사용한 Excel REST 편집

순수 REST 방식을 선호한다면, 동일한 작업을 cURL로 수행할 수 있습니다. 아래는 일반적인 단계입니다.

  1. 액세스 토큰을 얻으세요
    YOUR_CLIENT_ID와 YOUR_CLIENT_SECRET를 귀하의 자격 증명으로 교체하십시오.
curl -X POST "https://api.groupdocs.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 소스 XLSX 파일 업로드
curl -X PUT "https://api.groupdocs.cloud/v2.0/editor/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary @sample.xlsx
  1. 워크북을 편집하기 위해 로드
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "loadOptions": {}
         }'
  1. 수정된 워크북 저장
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/save" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "outputPath": "output.xlsx",
           "saveOptions": {}
         }'

요청 본문 및 추가 매개변수에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

Java 코드에서 REST를 통한 Excel 시트 편집 이해

아래는 Java 예제에 대한 단계별 분석입니다:

  1. API 클라이언트 구성 - ApiClient 객체는 기본 URL과 인증 자격 증명을 저장합니다.

    ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");

  2. Editor API 인스턴스 만들기 - EditorApi는 loadDocument 및 saveDocument와 같은 메서드를 제공합니다.

EditorApi editorApi = new EditorApi(apiClient);

  1. Excel 워크북 로드 - LoadDocumentRequest는 파일 이름을 지정하고; 응답에는 페이지(시트) 정보가 포함됩니다.

    LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);

  2. 워크북 편집 - Excel의 경우 각 시트가 페이지로 표시됩니다. 페이지의 HTML 표현을 조작하거나 다른 편집 API를 사용할 수 있습니다. (샘플에서는 이 부분을 자리 표시자로 남겨두었습니다.)

  3. 수정된 파일 저장 - SaveDocumentRequest는 소스 및 대상 경로를 정의합니다.

    SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
editorApi.saveDocument(saveRequest);

전체 클래스 및 속성 목록은 API 참조를 참조하십시오.

환경을 준비하기

Maven 프로젝트에 SDK를 추가하세요:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

전제 조건: Java 8 이상, GroupDocs Cloud 계정, 그리고 유효한 클라이언트 자격 증명(AppSid 및 AppKey). 최신 JAR 파일을 다운로드 페이지에서 다운로드하십시오.

Excel 편집 옵션 구성

SDK를 사용하면 로드 및 저장 동작을 세밀하게 조정할 수 있습니다:

  1. 로드 옵션 - 워크북이 읽기 전용 모드로 열리는지 여부를 제어합니다.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
  1. 저장 옵션 - 출력 형식 (XLSX, CSV, 등)을 선택하고 수식을 보존할지 여부를 선택합니다.
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
  1. 인증 설정 - 필요에 따라 사용자 지정 시간 제한이나 프록시를 설정할 수 있습니다.
apiClient.setTimeout(120000); // 2 minutes

이 옵션들은 앞에서 보여준 요청 객체에 전달됩니다.

결론

Java에서 REST를 통해 Excel 시트를 편집하는 것이 GroupDocs.Editor Cloud SDK for Java를 사용하면 간단해집니다. SDK는 REST 호출을 추상화하여 인증, 파일 저장 및 형식 세부 사항을 백그라운드에서 처리하면서 비즈니스 로직에 집중할 수 있게 해줍니다. 코드 예제를 통합한 후에는 배치 처리, 맞춤형 셀 스타일링 또는 수식 평가를 지원하도록 솔루션을 확장할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 획득해야 함을 기억하세요; 가격 세부 정보는 제품 페이지에서 확인할 수 있으며, 임시 체험 라이선스는 임시 라이선스 페이지에서 요청할 수 있습니다. 오늘 바로 Excel 워크플로를 자동화하고 Java 애플리케이션 전반에 걸쳐 생산성을 높이세요.

자주 묻는 질문

  • Java에서 GroupDocs.Editor를 사용하여 REST를 통해 Excel 시트를 편집하려면 어떻게 해야 하나요?
    SDK의 loadDocument 및 saveDocument 메서드를 코드 예제와 같이 사용하십시오. 라이브러리가 REST 통신을 처리하므로 Java 객체만 사용하면 됩니다.

  • REST API가 요구하는 인증 방법은 무엇인가요?
    API는 OAuth2 클라이언트‑자격 증명 흐름을 사용합니다. AppSid와 AppKey로 액세스 토큰을 얻은 다음, 모든 호출에 대해 Authorization: Bearer 헤더에 포함하십시오. 자세한 내용은 공식 문서를 참조하세요.

  • 단일 요청으로 여러 워크시트를 편집할 수 있나요?
    예. 워크북을 로드한 후 각 워크시트는 LoadResult의 별도 페이지로 표시됩니다. 페이지를 순회하면서 변경을 적용하고 saveDocument를 한 번 호출하여 모든 편집을 저장합니다.

  • 가격 및 라이선스 정보는 어디에서 찾을 수 있나요?
    구독 플랜은 제품 메인 페이지에서 확인하고, 체험 키는 임시 라이선스 페이지에서 확인하세요.

더 읽기