Introducción

Si estás comenzando con el desarrollo backend en Spring Boot, aprender a conectar tu aplicación con una base de datos es uno de los primeros pasos esenciales. En Pulsosoft te explicamos de forma simple cómo hacerlo usando PostgreSQL, una de las bases de datos más potentes y usadas por empresas de todo el mundo.

Al final de esta guía tendrás tu conexión lista, entenderás el archivo application.properties y podrás iniciar tus primeros proyectos con datos reales.

1. Configura tu entorno

Antes de empezar, asegúrate de tener instalado:

• Java 17 o superior
• Spring Tool Suite (STS) o IntelliJ IDEA
• PostgreSQL y pgAdmin

Con todo listo, crea un nuevo proyecto Spring Boot desde Spring Initializr con las dependencias:

• Spring Web
• Spring Data JPA
• PostgreSQL Driver

2. Configura el archivo application.properties

Abre el archivo src/main/resources/application.properties y agrega las siguientes líneas para conectar con tu base de datos:

spring.datasource.url=jdbc:postgresql://localhost:5432/mi_base
spring.datasource.username=postgres
spring.datasource.password=admin123
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
    

Consejo Pulsosoft: Nunca subas tus credenciales reales a GitHub. Usa .env o variables de entorno para mantener tus datos seguros.

3. Crea una entidad simple

En tu paquete model, crea una clase llamada Usuario.java:

package com.pulsosoft.demo.model;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class Usuario {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String nombre;
    private String correo;

    // Getters y setters
}
    

4. Prueba la conexión

Crea una clase UsuarioRepository que extienda de JpaRepository y un endpoint simple para probar la conexión:

package com.pulsosoft.demo.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import com.pulsosoft.demo.model.Usuario;

public interface UsuarioRepository extends JpaRepository<Usuario, Long> { }
    

package com.pulsosoft.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import com.pulsosoft.demo.repository.UsuarioRepository;

@RestController
public class UsuarioController {
    private final UsuarioRepository repo;

    public UsuarioController(UsuarioRepository repo) {
        this.repo = repo;
    }

    @GetMapping("/usuarios")
    public String testConnection() {
        return "Conexión exitosa con PostgreSQL 🚀";
    }
}
    

Ejecuta el proyecto y abre http://localhost:8080/usuarios. Si ves el mensaje, ¡tu conexión está lista!

5. Buenas prácticas y errores comunes

• No uses contraseñas reales en el código fuente.
• Utiliza variables de entorno para credenciales.
• Configura correctamente el puerto de PostgreSQL (por defecto es 5432).
• Si aparece un error de conexión, revisa el nombre exacto de la base creada en pgAdmin.

Conclusión

Conectar tu aplicación Spring Boot con PostgreSQL es más sencillo de lo que parece. Entender esta base te permitirá avanzar hacia proyectos más sólidos y profesionales. Recuerda que dominar la conexión entre código y datos es el primer paso hacia un backend eficiente y escalable.