Comentarios en una aplicación JDBC

Para documentar su programa JDBC, es necesario que incluya comentarios. Puede utilizar comentarios Java fuera de los métodos JDBC y comentarios Java o SQL en series de sentencia de SQL.

Puede incluir comentarios Java fuera de los métodos de l JDBC, siempre que el lenguaje Java los permita. Dentro de una serie de sentencia de SQL en una llamada a método JDBC, puede utilizar comentarios en las ubicaciones siguientes:

Para las conexiones a servidores de datos de Db2 en sistemas Linux®, UNIX y Windows o servidores de datos Informix®, los comentarios pueden ser:
- En cualquier lugar de la cadena de la instrucción SQL, y entre pares de caracteres /* y */. /* y los pares */ pueden anidarse.
- Al final de la serie de sentencia de SQL, y precedidos por dos guiones (--).
Para las conexiones con servidores de datos Informix únicamente, los comentarios pueden especificarse entre pares de llave izquierda ({) y llave derecha (}).
Restricción : Un comentario que esté incluido en un par de códigos de respuesta cortos ( { and } ) no es válido si se cumple alguna de las siguientes condiciones:
- La serie de sentencia de SQL no es una llamada de procedimiento almacenado, la serie de sentencia de SQL va precedida y seguida de comentarios especificados entre pares { y } y el comentario del inicio de la serie de la sentencia de SQL empieza con la palabra call.
- La serie de sentencia de SQL es una llamada de procedimiento almacenado y el comentario {call} se encuentra al inicio de la sintaxis de escape para la llamada de procedimiento almacenado.
- El comentario contiene cualquiera de los caracteres siguientes:
  - Comilla simple (')
  - Comillas dobles (")
  - Llave de apertura ({)
  - Llave de cierre (})
  - /*
- El comentario puede interpretarse como sintaxis de escape de SQL. Los comentarios que empiezan con los caracteres siguientes pueden interpretarse como sintaxis de escape de SQL:
  - d seguida de un espacio
  - t seguida de un espacio
  - ts seguidas de un espacio
  - escape seguido de un espacio
  - oj seguidas de un espacio
  - fn seguidas de un espacio
Por ejemplo, no son válidas las siguientes series de sentencia de SQL:
```
"{call comment at beginning} select * from systables {ending comment}"
"{{call} call mysp(?, ?)}"
```