Editar hoja de Excel a través de REST en Java - Ejemplo de código completo

El siguiente ejemplo muestra cómo cargar un libro de Excel, realizar cambios y guardarlo de nuevo en el almacenamiento usando el 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);
    }
}

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de los archivos (sample.xlsx, output.xlsx), verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Edición de Excel REST con comandos cURL

Si prefieres un enfoque puro de REST, la misma operación se puede realizar con cURL. A continuación se presentan los pasos típicos.

1. Obtener un token de acceso
   Reemplace YOUR_CLIENT_ID y YOUR_CLIENT_SECRET con sus credenciales.

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"

2. Cargar el archivo XLSX de origen

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

3. Cargar el libro de trabajo para editar

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": {}
         }'

4. Guardar el libro de trabajo modificado

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": {}
         }'

Para obtener más detalles sobre los cuerpos de solicitud y parámetros adicionales, consulte la documentación oficial de la API.

Comprender la edición de hoja de Excel a través de REST en código Java

A continuación se muestra un desglose paso a paso del ejemplo en Java:

1. Configurar cliente API - El objeto ApiClient almacena la URL base y las credenciales de autenticación.

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

2. Crear la instancia de Editor API - EditorApi proporciona métodos como loadDocument y saveDocument.

   EditorApi editorApi = new EditorApi(apiClient);
   

3. Cargar el libro de Excel - LoadDocumentRequest especifica el nombre del archivo; la respuesta contiene información de página (hoja).

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

4. Editar el libro de trabajo - Para Excel, cada hoja aparece como una página. Puedes manipular la representación HTML de una página o usar otras APIs de edición. (El ejemplo deja esta parte como un marcador de posición.)

5. Guardar el archivo modificado - SaveDocumentRequest define las rutas de origen y destino.

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

Para obtener una lista completa de clases y propiedades, consulte la referencia de API.

Preparando el Entorno

Agrega el SDK a tu proyecto Maven:

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

Requisitos previos: Java 8 o superior, una cuenta de GroupDocs Cloud y credenciales de cliente válidas (AppSid y AppKey). Descargue los últimos JARs desde la página de descarga.

Configuración de opciones de edición de Excel

El SDK le permite afinar el comportamiento de carga y guardado:

1. Opciones de carga - Controla si el libro de trabajo se abre en modo de solo lectura.

LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);

2. Opciones de guardado - Elija el formato de salida (XLSX, CSV, etc.) y si desea conservar las fórmulas.

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

3. Configuración de autenticación - Puede establecer un tiempo de espera personalizado o un proxy si es necesario.

apiClient.setTimeout(120000); // 2 minutes

Estas opciones se pasan a los objetos de solicitud mostrados anteriormente.

Conclusión

Editar una hoja de Excel a través de REST en Java se vuelve sencillo con el GroupDocs.Editor Cloud SDK for Java. El SDK abstrae las llamadas REST, permitiéndote centrarte en la lógica de negocio mientras gestiona la autenticación, el almacenamiento de archivos y los matices de formato en segundo plano. Después de integrar el ejemplo de código, puedes ampliar la solución para admitir procesamiento por lotes, estilo personalizado de celda, o evaluación de fórmulas. Recuerda obtener una licencia adecuada para uso en producción; los detalles de precios están disponibles en la página del producto, y se puede solicitar una licencia de prueba temporal desde la página de licencia temporal. Comienza a automatizar tus flujos de trabajo de Excel hoy y aumenta la productividad en tus aplicaciones Java.

FAQs

• ¿Cómo puedo editar una hoja de Excel a través de REST en Java usando GroupDocs.Editor?
  Utilice los métodos loadDocument y saveDocument del SDK como se muestra en el ejemplo de código. La biblioteca gestiona la comunicación REST, por lo que solo trabajas con objetos Java.

• ¿Qué método de autenticación requiere la API REST?
  La API utiliza el flujo de credenciales de cliente OAuth2. Obtenga un token de acceso con su AppSid y AppKey, luego inclúyalo en el encabezado Authorization: Bearer para todas las llamadas. Los detalles están en la documentación oficial.

• ¿Puedo editar varias hojas de cálculo en una sola solicitud?
  Sí. Después de cargar el libro de trabajo, cada hoja de cálculo aparece como una página separada en el LoadResult. Recorra las páginas, aplique los cambios y llame a saveDocument una vez para persistir todas las ediciones.

• ¿Dónde puedo encontrar información de precios y licencias?
  Visite la página principal del producto para los planes de suscripción y la página de licencia temporal para obtener una clave de prueba.

Leer más

• Editar archivos PowerPoint usando la biblioteca Java
• Editar documentos Word o Excel usando la API REST
• Editar hoja de Excel usando la API REST en Python