Files
aadd_conect01/README.md
T
2026-10-28 21:26:49 +01:00

146 lines
6.9 KiB
Markdown

# aadd_conect01: Operaciones CRUD sobre una tabla MySQL con JDBC
## Descripción
Proyecto en Java que se conecta mediante JDBC a una base de datos MySQL (`concesionario`) y realiza las cuatro operaciones básicas (CRUD) sobre la tabla `T_COCHE`: consulta, borrado, inserción y actualización.
La base de datos está en un contenedor Docker con `mysql` dentro de la máquina virtual y se carga con DBeaver. El proyecto es de tipo Maven y obtiene el conector `mysql-connector-j` desde el `pom.xml`. Los datos de conexión están escritos como constantes en el código, porque en esta práctica no se usa fichero de configuración, y no se utiliza el patrón DAO.
## Estructura del proyecto
- `aadd_conect01/`
- `src/org/palomafp/aadd/dta/`
- `AppPrincipal.java`: clase principal con la conexión y las operaciones CRUD
- `Coche.java`: clase que representa una fila de la tabla `T_COCHE`
- `bbdd-concesionario.sql`: script que crea la base de datos y carga los datos iniciales
- `pom.xml`: dependencias y configuración de Maven
- `.gitignore`
- `README.md`
## Base de datos
Script cargado en MySQL desde DBeaver:
```sql
create database concesionario;
use concesionario;
create table T_COCHE(
identificador int primary key,
marca varchar(50) not null,
modelo varchar(50) not null,
cilindrada decimal(4,2) not null
);
insert into T_COCHE values (1,'Renault', 'Megane', 1.5);
insert into T_COCHE values (2,'Seat', 'León', 1.6);
insert into T_COCHE values (3,'Suzuki', 'Vitara', 1.9);
insert into T_COCHE values (4,'Seat', 'Clio', 1.4);
insert into T_COCHE values (5,'Seat', 'Ibiza', 1.4);
insert into T_COCHE values (6,'Peugeot', '308', 2.0);
insert into T_COCHE values (7,'Renault', 'Megane', 1.5);
```
El usuario `myuser` necesita permisos para crear y usar la base de datos. Se le concedieron desde el contenedor con el usuario `root`:
```sql
GRANT ALL PRIVILEGES ON *.* TO 'myuser'@'%';
FLUSH PRIVILEGES;
```
## Componentes principales
- **`AppPrincipal`**: abre la conexión con `DriverManager`, ejecuta las operaciones CRUD en orden e imprime los resultados por consola. Cada operación está en su propio método.
- **`Coche`**: clase con los atributos `identificador`, `marca`, `modelo` y `cilindrada`, sus getters y un `toString()` para imprimirla.
## Dependencias
Definidas en el `pom.xml`:
```xml
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>26.10.0</version>
<scope>compile</scope>
</dependency>
```
El `pom.xml` indica `src` como directorio de código fuente (`sourceDirectory`), porque el proyecto se creó como proyecto Java y se convirtió después a Maven.
## Configuración de la conexión
Constantes de `AppPrincipal`:
| Constante | Valor |
|---|---|
| `URL` | `jdbc:mysql://192.168.1.62:3306/concesionario` |
| `USUARIO` | `myuser` |
| `PASSWORD` | `mypass` |
La IP es la de la máquina virtual donde se encuentre el contenedor. Si cambia, hay que actualizar la `URL`.
## Métodos de `AppPrincipal`
| Método | Acción |
|---|---|
| `main(String[] args)` | Abre la conexión con `try-with-resources` y ejecuta las cuatro operaciones en orden. Los errores SQL se capturan e imprimen por la salida de error |
| `consultarCoches(Connection conexion)` | Ejecuta un `SELECT` con `Statement` y devuelve una `List<Coche>` recorriendo el `ResultSet` |
| `borrarCoches(Connection conexion)` | Ejecuta `DELETE FROM T_COCHE` con `executeUpdate` y devuelve el número de filas borradas |
| `insertarCoche(Connection conexion, Coche c)` | Inserta un coche con un `PreparedStatement` y parámetros |
| `actualizarModelo(Connection conexion, int id, String nuevoModelo)` | Actualiza el modelo del coche indicado con un `PreparedStatement` y devuelve el número de filas modificadas |
## Operaciones CRUD realizadas
El programa ejecuta estos pasos, en este orden:
| Paso | Operación | Detalle |
|---|---|---|
| 1 | Consulta (Read) | Obtiene la lista de coches y la imprime por consola |
| 2 | Borrado (Delete) | Borra todos los coches de la tabla |
| 3 | Inserción (Create) | Inserta de nuevo cada coche de la lista obtenida en el paso 1 |
| 4 | Actualización (Update) | Cambia el modelo del coche con identificador `5` de `Ibiza` a `Ibiza Eco` |
| 5 | Comprobación | Vuelve a consultar e imprimir la lista para verificar el resultado |
### Salida por consola
```
=== Lista inicial de coches ===
Coche [identificador=1, marca=Renault, modelo=Megane, cilindrada=1.5]
Coche [identificador=2, marca=Seat, modelo=León, cilindrada=1.6]
Coche [identificador=3, marca=Suzuki, modelo=Vitara, cilindrada=1.9]
Coche [identificador=4, marca=Seat, modelo=Clio, cilindrada=1.4]
Coche [identificador=5, marca=Seat, modelo=Ibiza, cilindrada=1.4]
Coche [identificador=6, marca=Peugeot, modelo=308, cilindrada=2.0]
Coche [identificador=7, marca=Renault, modelo=Megane, cilindrada=1.5]
Coches borrados: 7
Coches reinsertados: 7
Coches actualizados: 1
=== Lista final de coches ===
Coche [identificador=1, marca=Renault, modelo=Megane, cilindrada=1.5]
Coche [identificador=2, marca=Seat, modelo=León, cilindrada=1.6]
Coche [identificador=3, marca=Suzuki, modelo=Vitara, cilindrada=1.9]
Coche [identificador=4, marca=Seat, modelo=Clio, cilindrada=1.4]
Coche [identificador=5, marca=Seat, modelo=Ibiza Eco, cilindrada=1.4]
Coche [identificador=6, marca=Peugeot, modelo=308, cilindrada=2.0]
Coche [identificador=7, marca=Renault, modelo=Megane, cilindrada=1.5]
```
## Aspectos a tener en cuenta
- Los recursos (`Connection`, `Statement`, `PreparedStatement` y `ResultSet`) se cierran automáticamente con `try-with-resources`.
- La consulta y el borrado usan `Statement` porque no llevan parámetros. La inserción y la actualización usan `PreparedStatement`, que evita concatenar valores en la sentencia SQL.
- El borrado elimina toda la tabla antes de reinsertar los datos. Como la lista se guarda en memoria antes de borrar, los datos se recuperan, pero si el programa fallara entre el paso 2 y el 3 la tabla quedaría vacía. No se usan transacciones en esta práctica.
- Si Eclipse se ejecuta fuera de la máquina virtual, `localhost` apunta al propio equipo y no a la M.V., por eso la URL usa la IP de la M.V.
- Un error `Communications link failure` indica que Java no llega al servidor (IP o puerto incorrectos, contenedor parado); un error `Access denied` indica un problema de usuario, clave o permisos.
## Ejecución
1. Arrancar el contenedor MySQL en la M.V. (`docker compose up -d` desde la carpeta con el `docker-compose.yml`) y comprobar con `docker ps` que está en marcha.
2. Cargar el script `bbdd-concesionario.sql` desde DBeaver con el usuario `myuser`.
3. Comprobar que la `URL` de `AppPrincipal` tiene la IP correcta de la M.V.
4. Importar el proyecto en Eclipse y actualizar Maven (*Maven → Update Project*) para descargar el conector.
5. Ejecutar `AppPrincipal` con *Run As → Java Application*.
6. Revisar la salida por consola y, si se quiere, comprobar el resultado en DBeaver con `SELECT * FROM T_COCHE;`.