03: Migración Java desde Python

Escenario

Contoso es una empresa que vende productos para varias actividades al aire libre. El departamento de marketing de Contoso quiere lanzar un sitio web de redes sociales micro para promocionar sus productos a clientes existentes y potenciales.

Debido a que un desarrollador Python dejó la empresa, las partes interesadas pidieron migrar la aplicación API backend Python existente a Java, usando Spring Boot.

Ahora, como desarrollador Java, debes migrar la aplicación FastAPI existente a Spring Boot. Tienes muy poco conocimiento de Python y FastAPI, por cierto.

Prerrequisitos

Consulta el documento README para la preparación.

Verificar Modo Agente de GitHub Copilot

Haz clic en el ícono de GitHub Copilot en la parte superior de GitHub Codespace o VS Code y abre la ventana de GitHub Copilot.
Si se te pide iniciar sesión o registrarte, hazlo. Es gratuito.
Asegúrate de estar usando el Modo Agente de GitHub Copilot.
Selecciona el modelo ya sea GPT-4.1 o Claude Sonnet 4.
Asegúrate de haber configurado Servidores MCP.

Preparar Instrucciones Personalizadas

Establece la variable de entorno de $REPOSITORY_ROOT.

# bash/zsh
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)

# PowerShell
$REPOSITORY_ROOT = git rev-parse --show-toplevel

Copia las instrucciones personalizadas.

# bash/zsh
cp -r $REPOSITORY_ROOT/docs/custom-instructions/java/. \
      $REPOSITORY_ROOT/.github/

# PowerShell
Copy-Item -Path $REPOSITORY_ROOT/docs/custom-instructions/java/* `
          -Destination $REPOSITORY_ROOT/.github/ -Recurse -Force

Preparar Proyecto Spring Boot

Asegúrate de estar usando el Modo Agente de GitHub Copilot con el modelo Claude Sonnet 4 o GPT-4.1.
Asegúrate de que el servidor MCP context7 esté funcionando.
Instala Spring Boot CLI.
```
sdk install springboot
```

Usa un prompt como el siguiente para crear un andamio para un proyecto de aplicación Spring Boot.

Me gustaría crear un andamio para una aplicación Spring Boot. Sigue las instrucciones a continuación.

- Usa context7.
- Tu directorio de trabajo es `java`.
- Identifica primero todos los pasos que vas a hacer.
- Usa Spring Boot CLI para crear el proyecto de aplicación Spring Boot.
- Usa Gradle como el gestor de paquetes Java.
- Usa el nombre de paquete `com.contoso.socialapp`.
- Usa el ID de artefacto `socialapp`.
- Usa el ID de grupo `com.contoso`.
- Usa el tipo de paquete `jar`.
- Usa la versión OpenJDK `21`.
- Agrega dependencias - `Spring Web`, `Spring Boot Actuator` y `Lombok`.
- Usa el número de puerto `8080`.
- Asegúrate de permitir CORS desde cualquier lugar.
- Construye la aplicación Spring Boot y verifica si la aplicación se construye correctamente.
- Ejecuta esta aplicación Spring Boot y verifica si la aplicación se ejecuta correctamente.
- Si la construcción o ejecución de la aplicación falla, analiza los problemas y corrígelos.

Haz clic en el botón de GitHub Copilot para tomar los cambios.

Migrar Aplicación API FastAPI

Asegúrate de estar usando el Modo Agente de GitHub Copilot con el modelo Claude Sonnet 4 o GPT-4.1.
Asegúrate de que el servidor MCP context7 esté funcionando.
Agrega product-requirements.md y openapi.yaml a GitHub Copilot.

Usa un prompt como el siguiente para migrar FastAPI a Spring Boot.

Ahora, estamos migrando la aplicación API basada en FastAPI existente a una aplicación API Spring Boot. Sigue las instrucciones a continuación para la migración.

- Usa context7.
- La aplicación FastAPI existente se encuentra en `python`.
- Tu directorio de trabajo es `java/socialapp`.
- Identifica primero todos los pasos que vas a hacer.
- Analiza la estructura de la aplicación de la aplicación FastAPI existente.
- Migra todos los endpoints. Ambos endpoints correspondientes deben ser exactamente iguales entre sí.
- Usa SQLite como la base de datos.
- Usa `sns_api.db` como el nombre de la base de datos SQLite.
- La base de datos siempre debe ser inicializada cuando se inicie la aplicación.
- Usa `openapi.yaml` que describe todos los endpoints y esquema de datos.
- La aplicación API debe renderizar la página Swagger UI a través de un endpoint predeterminado.
- La aplicación API debe renderizar exactamente el mismo documento OpenAPI a través de un endpoint predeterminado.
- NO agregues nada no definido en `openapi.yaml`.
- NO modifiques nada definido en `openapi.yaml`.
- Si es necesario, agrega más paquetes para OpenAPI y Swagger UI.

Haz clic en el botón de GitHub Copilot para tomar los cambios.
Una vez que la migración haya terminado, usa un prompt como el siguiente para verificar el resultado de la migración.
```
Me gustaría construir la aplicación Spring Boot. Sigue las instrucciones.

- Usa context7.
- Construye la aplicación Spring Boot y verifica si la aplicación se construye correctamente.
- Si la construcción de la aplicación falla, analiza los problemas y corrígelos.
```
NOTA:
- Hasta que la construcción tenga éxito, itera este paso.
- Si la construcción sigue fallando, revisa los mensajes de error y pregúntales al Agente GitHub Copilot para resolverlos.
Haz clic en el botón de GitHub Copilot para tomar los cambios.

Verificar Aplicación Backend Spring Boot

Una vez que la aplicación esté construida, verifica si está escrita correctamente o no.

Ejecuta la aplicación Spring Boot y verifica si la aplicación se está ejecutando correctamente verificando todos los endpoints. También verifica que el endpoint OpenAPI renderice exactamente el mismo contenido que `openapi.yaml`.

Si la ejecución de la aplicación falla, analiza los problemas y corrígelos. Usa context7.

Abre un navegador web y navega a http://localhost:8080.
Haz clic en el botón de GitHub Copilot para tomar los cambios.

Bien. Has completado el paso "Java". Vamos al PASO 04: Migración .NET desde JavaScript.

Disclaimer: Este documento ha sido localizado por GitHub Copilot. Por lo tanto, puede contener errores. Si encuentras alguna traducción que sea inapropiada o errónea, por favor crea un issue.

FilesExpand file tree

03-java.md

Latest commit

History