Actualiza conectores

Author: sio2sio2

source/04.conector/01.basico.rst

@@ -129,25 +129,33 @@ El código tiene dos aspectos:
   + Las ejecutamos usando el método ``executeUpdate``, puesto que su función es
     modificar el contenido de la base de datos, no obtener información.
 
-Tampoco las sentencias de inserción devuelven resultados, por lo que también
+Tampoco las sentencias de inserción devuelven resultados, por lo que supuesto
+que hayamos definido la clase ``Centro``:
+
+.. literalinclude:: files/CentroS.java
+   :language: java
+   :class: toggle
+   :caption: Centro.java
+
 podemos hacer:
 
 .. code-block:: java
    :name: ej-insert-sin-par
 
-      // Agregamos algunos centros
+      // Estos son los INSERT que quedaron pendientes en el código anterior
       stmt.executeUpdate("INSERT INTO Centro VALUES (11004866, 'IES Castillo de Luna', 'pública')");
 
-      Object[] registros = new Object[][] {
-         new Object[] {11007533, "IES Arroyo Hondo", "pública"},
-         new Object[] {11701164, "IES Astaroth", "pública"}
-      };
+      Centro[] centros = new Centro[] {
+         new Centro(11007533, "IES Arroyo Hondo", "pública"),
+         new Centro(11701164, "IES Astaroth", "pública")
+      }
+
       String sqlString = "INSERT INTO Centro VALUES (%d, '%s', '%s');"
-      for(Object[] registro: registros) {
+      for(Centro centro: centros) {
           stmt.executeUpdate(String.format(sqlString,
-            (Integer) registro[0],
-            (String) registro[1],
-            (String) registro[2]
+            centro.getId(),
+            centro.getNombre(),
+            centro.getTitularidad()
           ));
       }
 
@@ -191,29 +199,22 @@ objeto |ResultSet| que se va consumiendo a medida que obtenemos registros de él
 
 En el ejemplo, nos hemos limitado a imprimirlos, pero si nuestro programa
 pretendiera hacer algo útil, tendríamos que trasladar esta información al modelo
-de objetos de Java, Por ejemplo, suponiendo que hubiéramos definido una clase
-``Centro`` así:
-
-.. literalinclude:: files/CentroS.java
-   :language: java
-   :class: toggle
-   :caption: Centro.java
-
-podríamos hacer esto:
+de objetos de Java, Por ejemplo, podríamos hacer esto:
 
 .. code-block:: java
 
 
+   Lista<Centro> centros = null;
    try(ResultSet rs = stmt.executeQuery("SELECT * FROM Centro")) {
-      List<Centro> centros = new ArrayList<>(); 
-
-       while(rs.next()) {
-           int id = rs.getInt("id");
-           String nombre = rs.getString("nombre");
-           String titularidad = rs.getString("titularidad");
-           // Posiblemente titularidad debería ser un enum.
-           centros.add(new Centros(id, nombre, titularidad));
-       }
+      centros = new ArrayList<>(); 
+
+      while(rs.next()) {
+          int id = rs.getInt("id");
+          String nombre = rs.getString("nombre");
+          String titularidad = rs.getString("titularidad");
+          // Posiblemente titularidad debería ser un enum.
+          centros.add(new Centro(id, nombre, titularidad));
+      }
    }
 
 .. important:: Obsérvese que tiene que ser el programador el que traduzca el modelo
@@ -249,19 +250,19 @@ mecanismo para parametrizar sentencias; y, en el caso de |JDBC|, se hace uso de
    :name: ej-insert-par
    :emphasize-lines: 8, 11-13
 
-   Object[] registros = new Object[][] {
-      new Object[] {11004866, "IES Castillo de Luna", "pública"},
-      new Object[] {11007533, "IES Arroyo Hondo", "pública"},
-      new Object[] {11701164, "IES Astaroth", "pública"}
-   };
+   Centro[] centros = new Centro[] {
+      new Centro(11004866, "IES Castillo de Luna", "pública"),
+      new Centro(11007533, "IES Arroyo Hondo", "pública"),
+      new Centro(11701164, "IES Astaroth", "pública")
+   }
 
    try(
       PreparedStatement pstmt = conn.prepareStatement("INSERT INTO Centro (id, nombre, titulacion) VALUES (?, ?, ?)")
    ) {
-       for(Object[] registro: registros) {
-           pstmt.setInt(1, (int) registro[0]);        // id
-           pstmt.setString(2, (String) registro[1]);  // nombre
-           pstmt.setString(3, (String) registro[2]);  // titulación
+       for(Centro centro: centros) {
+           pstmt.setInt(1, centro.getId());
+           pstmt.setString(2, centro.getNombre());
+           pstmt.setString(3, centro.getTitularidad());
            pstmt.executeUpdate();
        }
    }
@@ -281,9 +282,9 @@ identificador se definió. Para ello podemos hacer lo siguiente:
 
    TimeDateFormatter df = TimeDateFormatter.ofPattern("dd/MM/yyyy");
    // centro es un centro que ya tenemos definido.
-   Object[][] registros = new Object[][] {
-      new Object[] {"Perico de los Palotes", LocalDate.parse("12/06/1995", df), centro},
-      new Object[] {"Mariquilla de la O", LocalDate.parse("07/09/1999", df), centro}
+   Profesor[] profesores = new Profesor[] {
+      new Profesor ("Perico de los Palotes", LocalDate.parse("12/06/1995", df), centro),
+      new Profesor ("Mariquilla de la O", LocalDate.parse("07/09/1999", df), centro)
    };
 
    try(
@@ -292,11 +293,11 @@ identificador se definió. Para ello podemos hacer lo siguiente:
          Statement.RETURN_GENERATED_KEYS
       )
    ) {
-       for(Object[] registro: registros) {
-           pstmt.setString(1, registro[0]); 
-           pstmt.setDate(2, registro[1] == null?null:Date.valueOf(registro[1]));
+       for(Profesor profesor: profesores) {
+           pstmt.setString(1, profesor.getNombre()); 
+           pstmt.setDate(2, profesor.getNacimiento() == null?null:Date.valueOf(profesor.getNacimiento()));
            pstmt.setObject(3, centro == null?null:centro.getId(), Types.INTEGER);
-           pstmt.setNull(4, Types.INTEGER);
+           pstmt.setNull(4, Types.INTEGER);  // Lo debe generar automáticamente el SGBD
            pstmt.executeUpdate();
            try(ResultSet rs = pstmt.getGeneratedKeys())  {
               if(rs.next()) System.out.printf("'%s' se registró con ID=%d\n", registro[0], rs.getInt(1));
@@ -309,7 +310,7 @@ identificador se definió. Para ello podemos hacer lo siguiente:
    Necesitaremos :ref:`más adelante <conn-batch>` darle al menos una vuelta más.
 
 Obsérvese que al definir los valores de los parámetros de una consulta,
-necesitamos cambiar de método según sea el tipo del campos. Sin embargo,
+necesitamos cambiar de método según sea el tipo del campo. Sin embargo,
 |JDBC| permite usar un método genérico (``setObject``) que se encargará de
 inferir el tipo |SQL| correcto a partir del tipo de *Java*. La razón por la que
 en el ejemplo se añade un tercer parámetro se debe a que el valor puede ser nulo

source/04.conector/02.datos.rst

@@ -329,7 +329,7 @@ los mapas de *Python* o *Java*:
 .. rubric:: Notas al pie
 
 .. [#] Se han referido clases, pero también equivalen a tipos primitivos (``short`` en vez de :java-lang:`Short`).
-.. [#] Ambos tipos representan número reales de coma fija y necesitan que se
+.. [#] Ambos tipos representan número reales de coma fija y necesitan que
    se les proporcionen dos parámetros: la :dfn:`precisión` (el número total de cifras)
    y la :dfn:`escala` (el número de cifras decimales). Por ejemplo,
    ``NUMERIC(10, 2)`` es un número de 10 cifras, dos de las cuales son

source/04.conector/03.transacciones.rst

@@ -27,20 +27,20 @@ pertenezcan a una misma transacción debemos hacer lo siguiente:
 .. code-block:: java
    :emphasize-lines: 8, 17, 21, 24
 
-   Object[] registros = new Object[][] {
-       new Object[] {11004866, "IES Castillo de Luna", "pública"},
-       new Object[] {11007533, "IES Arroyo Hondo", "pública"},
-       new Object[] {11701164, "IES Astaroth", "pública"}
+   Centro[] centros = new Centro[] {
+      new Centro(11004866, "IES Castillo de Luna", "pública"),
+      new Centro(11007533, "IES Arroyo Hondo", "pública"),
+      new Centro(11701164, "IES Astaroth", "pública")
    };
    String sqlString = "INSERT INTO Centro VALUES (?, ?, ?);"
 
    conn.setAutoCommit(false);  // Evitamos que cada sentencia implique una transacción
 
    try(PreparedStatement pstmt = conn.prepareStatement(sqlString)) {
-       for(Object[] registro: registros) {
-           pstmt.setInt(1, (int) registro[0]);
-           pstmt.setString(2, (String) registro[1]);
-           pstmt.setString(3, (String) registro[2]);
+       for(Centro centro: centros) {
+           pstmt.setInt(1, centro.getId());
+           pstmt.setString(2, centro.getNombre());
+           pstmt.setString(3, centro.getTitularidad());
            pstmt.executeUpdate();
        }
        conn.commit(); // Después de ejecutar todas las sentencias, las confirmamos.
@@ -71,20 +71,20 @@ precisamente), el modo más eficiente para llevarlas a cabo es el siguiente:
 .. code-block:: java
    :emphasize-lines: 15, 17
 
-   Object[] registros = new Object[][] {
-       new Object[] {11004866, "IES Castillo de Luna", "pública"},
-       new Object[] {11007533, "IES Arroyo Hondo", "pública"},
-       new Object[] {11701164, "IES Astaroth", "pública"}
+   Centro[] centros = new Centro[] {
+      new Centro(11004866, "IES Castillo de Luna", "pública"),
+      new Centro(11007533, "IES Arroyo Hondo", "pública"),
+      new Centro(11701164, "IES Astaroth", "pública")
    };
    String sqlString = "INSERT INTO Centro VALUES (?, ?, ?);"
 
    conn.setAutoCommit(false);  // Evitamos que cada sentencia implique una transacción
 
    try(PreparedStatement pstmt = conn.prepareStatement(sqlString)) {
-       for(Object[] registro: registros) {
-           pstmt.setInt(1, (int) registro[0]);
-           pstmt.setString(2, (String) registro[1]);
-           pstmt.setString(3, (String) registro[2]);
+       for(Centro centro: centros) {
+           pstmt.setInt(1, centro.getId());
+           pstmt.setString(2, centro.getNombre());
+           pstmt.setString(3, centro.getTitularidad());
            pstmt.addBatch();  // Añadimos la inserción al procedimiento.
        }
        pstmt.executeBatch(); // Ejecutamos todas las inserciones pendientes.

source/04.conector/04.pool.rst

@@ -158,6 +158,9 @@ Su uso, por otro lado es muy sencillo:
 
    ds.close();  // Se liberan recursos.
 
+.. tip:: Más adelante se sugiere una :ref:`estrategia para crear el pool
+   <conn-pool-extra>`.
+
 .. |JDBC| replace:: :abbr:`JDBC (Java DataBase Connectivity)`
 .. |SGBD| replace:: :abbr:`SGBD (Sistema Gestor de Bases de Datos)`
 .. |Connection| replace:: :java-sql:`Connection <Connection>`

source/04.conector/10.extras.rst

@@ -170,7 +170,7 @@ de él, en vez de encontrarse incrustadas en el código.
 
 Sin embargo, |JDBC| no tiene definido un método que nos permita ejecutar un
 guión |SQL| completo y que pasemos una cadena larga con todas instrucciones
-separadas por comas, no aegura que el |SGBD| las descomponga y ejecute
+separadas por comas, no asegura que el |SGBD| las descomponga y ejecute
 individualmente\ [#]_. La única forma segura de poder ejecutar sus sentencias
 es descomponerlas primero. Para ello podemos optar por dos estrategias:
 
@@ -179,16 +179,15 @@ es descomponerlas primero. Para ello podemos optar por dos estrategias:
   capaz de procesar el código |SQL| y, por tanto, reconocer los elementos de que
   se compone.
 
-+ Si el guión no es complejo y seguimos algunas premisas:
++ Podemos escribir una solución artesanal, si el guión no es complejo y seguimos
+  algunas premisas:
 
   a. Los ';' que completan sentencias deben encontrarse a final de línea.
   #. No pueden usarse las palabras ``begin`` o ``end`` en comentarios, nombres,
      valores, etc.
   #. No pueden usarse bloques ``IF`` en aquellos |SGBD| que los implementen
      (pero sí usarse el estándar ``CASE``).
 
-  podemos escribir una solución artesanal, que es la que proponemos.
-
 .. literalinclude:: files/splitSQL.java
    :language: java