Spring Boot

Descripción general

Spring Boot es un framework de Java que facilita la creación de aplicaciones autónomas y de calidad para producción. Ofrece autoconfiguración, servidores embebidos y un enfoque opinado para construir APIs REST y aplicaciones web.

Inicio rápido

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>

./mvnw spring-boot:run

git add .
git commit -m "Initial setup"
git push origin main

Desarrollo local con Docker

Si no tienes Java instalado localmente, puedes usar Docker para compilar y ejecutar tu aplicación Spring Boot.

Ejecutar comandos con Docker

# Build the project
docker run --rm -v $(pwd):/app -w /app maven:3-eclipse-temurin-21 ./mvnw clean package -DskipTests

# Run the application
docker run --rm -v $(pwd):/app -w /app -p 8080:8080 eclipse-temurin:21 java -jar target/*.jar

Configuración de la base de datos

La plataforma NStrim te proporciona una base de datos MySQL/MariaDB. Configura tu archivo application.properties con las credenciales correctas.

Configuración completa

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

Estructura del proyecto

├── src/
│   └── main/
│       ├── java/com/example/
│       │   ├── Application.java          # Punto de entrada de Spring Boot
│       │   ├── controllers/              # Controladores REST
│       │   ├── models/                   # Entidades JPA
│       │   ├── repositories/             # Repositorios Spring Data
│       │   └── services/                 # Lógica de negocio
│       └── resources/
│           ├── application.properties    # Configuración
│           ├── templates/                # Plantillas Thymeleaf
│           └── static/                   # CSS, JS, imágenes
├── pom.xml                               # Dependencias Maven
└── Dockerfile                            # Configuración Docker
        

Tareas comunes

Crear un controlador REST

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping
    public List<User> getAll() {
        return userRepository.findAll();
    }

    @PostMapping
    public User create(@RequestBody User user) {
        return userRepository.save(user);
    }
}

Crear una entidad JPA

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // getters and setters
}

Crear un repositorio

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
}

Comandos útiles

Resolución de problemas

Flujo de despliegue