Historial de cambios de OBCOM SQL Wizard

Versión 1.204 – 8 de Mayo de 2024

• Los parámetros de salida (output) de tipo bytea de PostgreSQL se definían incorrectamente de tipo VARBINARY de JDBC. Ahora, estos parámetros se definen correctamente de tipo LONGVARBINARY. Este cambio corrige el comportamiento de parámetros que retornan un arreglo de bytes (byte[]) muy largo.

Versión 1.202 – 26 de Febrero de 2024

• Se agregan textos a la ventana "Acerca de SQL Wizard..." para dejar más clara la información entregada.

Versión 1.200 – 22 de Diciembre de 2023

• Se actualiza la versión de los controladores (drivers) JDBC que utiliza OBCOM SQL Wizard.
• La ventana "Acerca de SQL Wizard..." muestra la versión del controlador (driver) y la URL de la conexión JDBC.

Versión 1.198 – 14 de Septiembre de 2023

• Se corrige el código Java generado cuando se usa una clase para seleccionar la fuente de datos (DataSource) de un Servicio Rest o Web.

Versión 1.196 – 18 de Mayo de 2023

• Los Servicio REST ahora implementan la interfaz ContainerRequestFilter, que es llamada justo antes de ejecutar una API del servicio.
• Los Servicio REST ahora implementan la interfaz ContainerResponseFilter, que es llamada justo después de ejecutar una API del servicio.

Versión 1.194 – 15 de Febrero de 2023

• Se agrega soporte a procedimientos de PostgreSQL (PROCEDURE). Los procedimientos están disponibles a partir de PostgreSQL versión 11. Se programan igual que las funciones (FUNCTION), pero tienen capacidades nuevas, y la forma de invocarlos es distinta.

Versión 1.192 – 15 de Noviembre de 2022

• Se agrega la propiedad Action a todos los métodos de Servicios Web JEE de tipo SOAP. Esta modificación asegura que distintos servidores JEE (tales como WebLogic, Payara o JBoss) generen archivos WSDL equivalentes. Esto último es importante cuando se genera código a partir del archivo WSDL de un Servidor Web, pero este código se usa para acceder a otro tipo de Servidor Web.

Versión 1.190 – 13 de Julio de 2022

• Se corrige la generación de código para Jakarta EE: faltaba migrar algunas clases de "javax.*" al espacio de nombres "jakarta.*".

Versión 1.188 – 23 de Septiembre de 2021

• Se corrige un error en el cuadro de díalogo para solicitar una licencia de uso de OBCOM SQL Wizard.

Versión 1.186 – 24 de Junio de 2021

• Se modifica el código Java generado de modo que los métodos private ahora son protected. Esto facilita la programación de nuevas clases que extienden (extends) las clases generadas. Estas nuevas clases pueden aportar nueva lógica, o ajustar (override) la lógica extendida.

Versión 1.184 – 23 de Junio de 2021

• Si se selecciona la opción Retornar encabezado HTTP Access-Control-Allow-Origin (CORS), ahora el Servicio REST generado retorna resultados que incluyen los encabezados HTTP Access-Control-Allow-Headers, Access-Control-Allow-Methods y Access-Control-Allow-Origin.

Versión 1.182 – 15 de Junio de 2021

• Los tipos de datos obsoletos SqlDbType.Image, SqlDbType.NText y SqlDbType.Text se reemplazan por SqlDbType.VarBinary(max), SqlDbType.NVarChar(max) y SqlDbType.VarChar(max), respectivamente.

Versión 1.180 – 13 de Junio de 2021

• Se agrega la opción Retornar encabezado HTTP Access-Control-Allow-Origin (CORS) al panel Generar componente JEE variante Generar un Servicio Web (REST). Si se selecciona esta opción, el Servicio REST generado retorna resultados que incluyen el encabezado HTTP Access-Control-Allow-Origin. Esto permite invocar al Servicio REST desde código JavaScript descargado por un navegador (browser) desde una dirección distinta a la del Servicio REST (origen cruzado).

Versión 1.178 – 3 de Mayo de 2021

• Se corrige la generación de código para Jakarta EE: faltaba migrar algunas clases de "javax.*" al espacio de nombres "jakarta.*".

Versión 1.176 – 25 de Marzo de 2021

• Se agrega la opción Generar usando clases de la biblioteca estándar Jakarta EE al panel Generar componente JEE. Si se selecciona esta opción, el código generado utiliza clases del nuevo espacio de nombres "jakarta.*". De lo contrario, se usan clases del espacio de nombres clásico "javax.*".

Versión 1.174 – 25 de Septiembre de 2020

• En términos generales, el contexto de un servicio web (WebServiceContext) no se puede obtener vía JNDI. Por este motivo, el método que retorna este contexto ya no usa JNDI, y ahora dispara una excepción si dicho contexto no fue injectado por @Resource.

Versión 1.172 – 29 de Agosto de 2020

• Se corrige el código generado en caso de procedimientos almacenados SQL Server con parámetros de salida (output) de tipo NVARCHAR(MAX), VARCHAR(MAX) y VARBINARY(MAX). Ahora los valores retornados no se truncan a un largo máximo de 8000 bytes.

Versión 1.170 – 22 de Agosto de 2020

• Se corrige un problema con la activación de la licencia de uso de OBCOM SQL Wizard.

Versión 1.168 – 8 de Junio de 2020

• El método ProcedureCaller.blobToBytes(blob) ahora invoca a blob.free() para liberar todos los recursos que posee el blob.
• El método ProcedureCaller.clobToString(clob) ahora invoca a clob.free() para liberar todos los recursos que posee el clob.
• Todos los archivos jar utilizados por OBCOM SQL Wizard se firmaron con un nuevo certificado digital.

Versión 1.166 – 17 de Abril de 2020

• Se modifica la lógica para búsquedas JNDI usando InitialContext. Si el código es para Java 6 ó superior, la lógica generada es más compacta porque las búsquedas se realizan usando el método estático InitialContext.doLookup("…").

Versión 1.164 – 30 de Marzo de 2020

• Se corrige el código que convierte un ResultSet JDBC en una lista o un arreglo de elementos. Ahora no se permite que el ResultSet sea null, porque este valor sólo se produce por un error de programación del procedimiento almacenado. Además, el ResultSet es ahora liberado usando un try-with-resource, en vez de llamar al método close.

Versión 1.162 – 23 de Marzo de 2020

• Se corrige el código generado para Servicios REST JEE cuya lógica de negocio está provista por una componente EJB.
• Se corrige la lógica de los métodos que retornan los parámetros de seguridad validados por el Filtro de Seguridad.

Versión 1.160 – 29 de Enero de 2020

• El código generado para Servicios REST JEE utiliza ahora la clase WebApplicationException en vez de InternalServerErrorException. La clase InternalServerErrorException está disponible sólo en versiones nuevas de JAX-RS, en cambio WebApplicationException está disponible en todas las versiones.

Versión 1.158 – 19 de Noviembre de 2019

• Se mejoran las descripciones de las características de la licencia de uso de OBCOM SQL Wizard.

Versión 1.156 – 11 de Noviembre de 2019

• Cuando ocurre un error al invocar un Servicio Web (SOAP) construido con C#.NET o VB.NET, el Web Service Fault retornado ahora incluye los campos State, Number y Message de excepciones de tipo System.Data.SqlException. Los clientes del servicio pueden consultar estos valores para obtener información detallada del error.

Versión 1.154 – 7 de Noviembre de 2019

• Se agrega el campo de texto Grabe la excepción de tipo SQLException con el siguiente procedimiento a la pestaña Servicio Web del panel Generar componente JEE. Este campo permite especificar el nombre de un procedimiento almacenado que es invocado cada vez que ocurre una excepción de tipo SQLException. Este procedimiento debe tener los siguientes cuatro parámetros de entrada (input):

  CREATE PROCEDURE <nombre-del-procedimiento> (
      method_name   VARCHAR(200),   -- Nombre de la Clase y Método
      sql_state     CHAR(5),        -- SQL State de la SQLException
      error_code    INTEGER,        -- Error Code de la SQLException
      message       VARCHAR(500)    -- Message de la SQLException
  )

  El objetivo de este procedimiento es almacenar los errores que ocurren en otros procedimientos. Esto no lo puede hacer directamente el procedimiento donde ocurre el error, porque el error produce un ROLLBACK que deshace las actualizaciones realizadas en la base de datos. El archivo StoreSqlException.rar contiene implementaciones sugeridas para Oracle, PostgreSQL y SQL Server.
• Se elimina la opción Registre errores de base de datos (SQLException) sin un stack trace de la pestaña Servicio Web del panel Generar componente JEE. Ahora este tipo de errores siempre se registran sin un stack trace, porque el stack trace no aportaba información útil, y sólo aumentaba el tamaño de los archivos de registro (logging).
• Cuando ocurre un error al invocar un Servicio Web (SOAP), el Web Service Fault retornado ahora incluye los campos SQL State, Error Code y Message de excepciones de tipo SQLException. Los clientes del servicio pueden consultar estos valores para obtener información detallada del error.

Versión 1.152 – 16 de Octubre de 2019

• Se corrige un problema con la activación de la licencia de uso de OBCOM SQL Wizard.

Versión 1.150 – 14 de Marzo de 2019

• Se agrega soporte para servidores certificados Java EE 8, tales como: GlassFish 5, JBoss EAP 7.2, Payara 5, WebLogic 12cR2 y WildFly 14+.

Versión 1.148 – 27 de Febrero de 2019

• Al terminar de ejecutar, OBCOM SQL Wizard ahora guarda un respaldo con todas las preferencias. Este respaldo se importa en la próxima sesión de trabajo. Esto se hace porque al actualizar o desinstalar Oracle Java, a veces se borran los valores de todas las preferencias.

Versión 1.146 – 14 de Enero de 2019

• Se mejora el código de Servicios Web de tipo REST. Ya no se genera el conversor de parámetros por ser innecesario. Tampoco se genera una excepción especial, y en cambio se usa la excepción estándar InternalServerErrorException. Esta última incluye un Response con status HTTP 500 y un mensaje de error compacto.

Versión 1.144 – 22 de Septiembre de 2018

• Se agrega la opción Ignorar los códigos de estado retornados por procedimientos SQL Server a los paneles Generar páginas ASP/ASPX. Al seleccionar esta opción, se genera código ASP/ASPX que no retorna los códigos de estado (RETURN_VALUE) de procedimientos SQL Server. Esto permite generár páginas ASP/ASPX que operan correctamente con otros servidores de bases de datos que no pueden retornar estos códigos (como MySQL).

Versión 1.142 – 30 de Agosto de 2018

• Se corrige el código Java generado para los tipos IMAGE (SQL Server) y LONG RAW (Oracle) debido a que se los trataba como BLOB en vez de LONGVARBINARY. También se corrigen los tipos NTEXT y TEXT (SQL Server) y LONG (Oracle) debido a que se los trataba como CLOB en vez de LONGVARCHAR. Finalmente, se corrige el tipo NUMBER (Oracle) porque se lo trataba como NUMERIC en vez de DECIMAL.

Versión 1.140 – 16 de Julio de 2018

• Se corrige el código Java generado para procedimientos con parámetros de salida (output) con tipo numérico de punto flotante (FLOAT, REAL, DOUBLE).

Versión 1.138 – 3 de Abril de 2018

• Se corrige el nombre asignado a los loggers de Servicios Web.

Versión 1.136 – 15 de Marzo de 2018

• Se agrega la opción Registre errores de base de datos (SQLException) sin un stack trace a la pestaña Servicio Web del panel Generar componente JEE. Al seleccionar esta opción, se genera código Java que registra (logging) los errores de base de datos (SQLException) en forma compacta, sin incluir el stack trace. Todas las demás excepciones se registran con el stack trace.

Versión 1.134 – 21 de Enero de 2018

• Ahora el nombre <plural> en la marca #ResultSet <singular> <plural> es opcional. Si no se especifica el nombre <plural>, se entenderá que dicho nombre es igual al nombre <singular> con la letra S agregada al final. Por ejemplo, el nombre <plural> de la marca #ResultSet PRODUCTO será PRODUCTOS. Este comportamiento no siempre produce los resultados deseados. Por ejemplo, la marca #ResultSet PROPERTY tendrá un nombre <plural> igual a PROPERTYS, y no el nombre plural correcto PROPERTIES (en inglés).

Versión 1.132 – 23 de Septiembre de 2017

• Cuando se ordenaba la tabla de procedimientos por la columna Paquete o Tipo, y luego se seleccionaba un procedimiento, muchas veces se mostraba los parámetros o el código fuente de otro procedimiento. Esto se corrigió, y ahora se muestran los datos correctos, independiente del ordenamiento de la tabla de procedimientos.
• La tabla de procedimientos se puede filtrar por nombre y/o esquema del procedimiento. Ahora también es posible filtrar la tabla por el nombre del paquete del procedimiento. El nombre del paquete es un patrón, así que, por ejemplo, el nombre emp* muestra sólo los procedimientos que pertenecen a un paquete cuyo nombre comienza con emp.
• La opción Guardar nombres… se usa para escribir un archivo de texto con los nombres de los procedimientos seleccionados. Ahora esta opción escribe el nombre de los procedimientos en paquetes Oracle usando el formato Paquete.Nombre. De esta forma, las opciones Incluir nombres… y Excluir nombres… seleccionan correctamente los procedimientos del paquete, sin confundirlos con otros procedimientos de igual nombre, pero fuera del paquete.

Versión 1.130 – 11 de Septiembre de 2017

• Se corrige el generador de código VB.NET, porque estaba generando código incorrecto cuando se seleccionaba la opción Usar tipos que puedan representar el valor NULL de base de datos. Además, ahora el código VB.NET generado es compatible con Option Strict On.

Versión 1.128 – 7 de Septiembre de 2017

• El servidor Oracle GlassFish 3 produce una descripción WSDL errónea cuando los Servicios Web se generan con clases que incluyen la anotación @XmlRootElement. Por este motivo, cuando se genere código para este servidor, las clases no incluirán esta anotación. La anotación @XmlRootElement si se incluye en servidores más modernos, como Oracle GlassFish 4, los cuales generan un WSDL correcto.
• Se agrega el servidor Oracle WebLogic 11g a la lista de servidores que uno puede seleccionar en la página Generar componentes JEE. El servidor Oracle WebLogic 11g es equivalente a seleccionar Oracle GlassFish 3.
• Ahora, cuando se generen componentes JEE y no se especifique un Espacio de nombres de destino (XML) (Target Namespace) (TNS), se usará un TNS construido en base a el Nombre del paquete y el Nombre de la configuración. De esta forma, dos Servicios Web distintos que usan el mismo Nombre del paquete tendrán un TNS distinto.

Versión 1.126 – 31 de Agosto de 2017

• Los Servicios Web de tipo REST ahora pueden recibir parámetros en formato JSON o XML. El formato de los parámetros se indica con el encabezado HTTP Content-Type, cuyo valor debe ser application/json o application/xml, respectivamente. Este encabezado pueden incluir el atributo charset para especificar la codificación del texto suministrado, por ejemplo: Content-Type: application/xml; charset=UTF-8.
• Los Servicios Web de tipo REST pueden retornar los resultados en formato JSON o XML. La aplicación cliente especifica el formato deseado enviando el encabezado HTTP Accept, cuyo valor debe ser application/json o application/xml, respectivamente. Para solicitar una codificación de texto, se usa el encabezado HTTP Accept-Charset, por ejemplo: Accept-Charset: ISO-8859-1. Algunos Servidores de Aplicación permiten especificar la codificación directamente en el encabezado Accept, por ejemplo: Accept: application/json; charset=ISO-8859-1.
• Ahora los Servicios Web de tipo SOAP pueden ser generados de modo que los métodos reciban sus parámetros de entrada (input) empaquetados en un solo objeto de tipo Request. Los Servicios Web de tipo REST siempre reciben los parámetros de entrada (input) de esta forma.
• Se corrige la generación de código asociada a parámetros de entrada y salida (IN OUT) de tipo REF CURSOR de Oracle. Estos parámetros son ahora tratados como si fueran sólo de salida (OUT), porque JDBC estándar no sabe cómo suministrar un valor de entrada (IN) de tipo REF CURSOR.
• Se corrige la generación de código C#.NET y VB.NET asociado a tipos de valor a los que no se les puede asignar null (Nothing en VB.NET). A tipos tales como int, long o DateTime no se les puede asignar null, salvo que el valor esté empaquetado dentro de una estructura .NET llamada Nullable<T>.

Versión 1.124 – 22 de Noviembre de 2016

• Los comentarios Java ya no usan la secuencia <code><pre>…</pre></code>. La herramienta javadoc considera inválida esta agrupación de marcas HTML, y no genera correctamente la documentación. Ahora sólo se usa la secuencia <pre>…</pre>.

Versión 1.122 – 17 de Agosto de 2016

• Se modifica la generación de las clases de valor (VO) de los Servicios Web JEE. Si el Servicio Web es de tipo REST, las clases de valor (VO) incluyen la anotación @XmlRootElement. Si el Servicio Web es de tipo SOAP, las clases de valor (VO) no incluyen la anotación. Esta anotación se generaba incondicionalmente, pero sólo es necesaria en Servicios Web de tipo REST.

Versión 1.120 – 12 de Agosto de 2016

• Ahora se puede generar Servicios Web tipo REST (Representational State Transfer) para ambientes JEE. Este tipo de servicio es especialmente útil en aplicaciones HTML5, las cuales se programan con JavaScript, y pueden usar el formato JSON (JavaScript Object Notation) o XML (Extensible Markup Language) para transmitir datos.
• La lista de procedimientos ahora se pueden filtrar por nombre del esquema. Este nuevo filtro se puede combinar con el filtro clásico por nombre de procedimiento.
• El filtro de procedimientos ahora se almacena en forma permanente. Este filtro almacenado se aplica en la siguiente conexión a un servidor del mismo tipo. Cuando la lista de procedimientos está filtrada, la barra de estado muestra el mensaje Filtro Activo.
• Se elimina la generación de programas Adobe Flex para probar los Servicios Web generados. Esta capacidad ya no es necesaria, porque en el mercado existen excelentes herramientas gratuitas para probar Servicios Web. En particular, se recomienda la herramienta SoapUI de la empresa SmartBear.

Versión 1.118 – 11 de febrero de 2016

• Ahora se puede generar los archivos que invocan a procedimientos almacenados sin necesidad de generar una Componente EJB o un Servicio Web. Esto es útil cuando se necesitan sólo las clases Caller para usarlas dentro de una aplicación o biblioteca (librería) que no opera en un ambiente JEE.

Versión 1.116 – 28 de enero de 2016

• Se agrega una nueva opción para generar componentes EJB con interfaces locales o remotas. Por defecto, las componentes se generan con interfaces remotas, lo que permite invocar estas componentes desde otras aplicaciones EAR, o desde otros servidores JEE. Una componente EJB generada con interfaz local sólo puede ser utilizada dentro de la aplicación EAR que la contiene, pero su ejecución debería es más eficiente.
• Se agrega una nueva opción que permite especificar el tipo de registro (logging) que debe ocurrir cuando se produce un error al ejecutar un método de un Servicio Web. Por defecto, los errores se registran con las API de Java. Ahora los errores se pueden registrar con log4j o slf4j. También se puede indicar que los errores no se registren.

Versión 1.114 – 9 de diciembre de 2015

• El generador de componentes JEE ahora genera un método que crea los objetos de los conjuntos de resultado (#ResultSet). Este método pueden ser reemplazado (overriden) de modo que genere objetos extendidos. Estos objetos extendidos pueden tener métodos adicionales que, por ejemplo, permitan traducir tipos de la base de datos por tipos Java.

Versión 1.112 – 24 de Octubre de 2015

• Se mejoran los comentarios de las clases y métodos generados por OBCOM SQL Wizard. La idea es que estos comentarios permitan generar documentación de buena calidad usando herramientas como Javadoc para Java, o Sandcastle para .NET.

Versión 1.110 – 22 de Septiembre de 2015

• Se agrega la opción Generar clases requeridas por clientes del EJB en un proyecto separado al cuadro de dialogo de generación de Componentes JEE. Si se selecciona esta opción, las clases e interfaces requeridas por clientes de la componente EJB se generan en un proyecto separado. Si no se selecciona esta opción, las clases e interfaces se generan en el proyecto de la componente EJB, y no es necesario tener un proyecto separado para los clientes.

Versión 1.108 – 27 de Agosto de 2015

• El Nombre JNDI de la fuente de datos (DataSource) del cuadro de diálogo de generación JEE ahora puede comenzar con @. En este caso, el texto (sin el @ inicial) debe ser el nombre completo de una clase que implementa el siguiente método:

  javax.sql.DataSource getDataSource(javax.xml.ws.WebServiceContext)

  Cada vez que un Servicio Web necesite una fuente de datos (DataSource), el código generado llamará a este método para obtener el valor que debe utilizar.

  En caso de necesitar esta funcionalidad en una componente EJB, la clase antes mencionada debe implementar el siguiente método alternativo:

  javax.sql.DataSource getDataSource(javax.ejb.SessionContext)

  Se recomienda construir una sola clase utilitaria que implemente ambos métodos (overloaded).

Versión 1.106 – 6 de Julio de 2015

• Se agrega la opción Historial de cambios… al menú Ayuda. Al seleccionar esta opción, se abre el programa navegador predeterminado mostrando el documento con la historia de cambios de la herramienta OBCOM SQL Wizard (este documento).
• Se modifica la ventana de Acerca de SQL Wizard… para que muestre la versión y el directorio (home) del intérprete Java que está ejecutando OBCOM SQL Wizard. Esta información facilita la depuración de problemas de funcionamiento de la herramienta.
• El corrige el comportamiento del botón Borrar de los paneles Generar componente .NET y Generar componente JEE. Ahora este botón elimina la configuración seleccionada sin cerrar el panel.

Versión 1.104 – 27 de Junio de 2015

• Se agrega un botón D a la derecha del campo Espacio de nombres de destino (XML) del panel Generar componente .NET. Este botón genera el valor predeterminado usando el valor especificado en el campo Espacio de nombres de código.
• Se agrega un botón D a la derecha del campo Espacio de nombres de destino (XML) del panel Generar componente JEE. Este botón genera el valor predeterminado usando el valor especificado en el campo Nombre del paquete.

Versión 1.102 – 30 de Mayo de 2015

• Se agrega soporte para el driver ADO.NET nativo del servidor de base de datos SAP Sybase ASE. Ahora OBCOM SQL Wizard es capaz de generar código C# y VB.NET que utiliza el driver ADO.NET Sybase.AdoNet4.AseClient.dll.
• Se actualiza el driver JDBC de comunicación con el servidor de base de datos SAP Sybase ASE. Ahora OBCOM SQL Wizard utiliza la versión 1.3.1 del driver jTDS.

Versión 1.100 – 7 de Mayo de 2015

• Se agrega soporte para Oracle GlassFish 4 o cualquier servidor JEE que utilice Java 7. El campo Servidor de aplicaciones del panel Generar componente JEE permite seleccionar el valor Oracle GlassFish 4. Si se selecciona este valor, OBCOM SQL Wizard genera código Java 7 que usa la instrucción try-with-resources.
• Ahora OBCOM SQL Wizard puede usarse cuando no hay conectividad con Internet. Si Java no puede conectarse al servidor Internet www.obcom.cl, entonces ejecuta la versión de OBCOM SQL Wizard que se encuentra instalada localmente en la estación de trabajo. La próxima vez que Java logre conectarse con el servidor www.obcom.cl, actualizará la versión de OBCOM SQL Wizard, si es que hay una versión nueva.
• La marca #ResultSet se utiliza para definir un conjunto resultado retornado por un procedimiento. Por ejemplo, si se escribe #ResultSet Producto en un procedimiento llamado BuscarProductos, se generará una clase llamada BuscarProductosProducto, la cual posee una propiedad por cada columna definida con la marca #Column. Ahora se puede escribir #ResultSet @Producto (nótese el @). En este caso, se genera una clase llamada Producto, sin agregarle un prefijo. Si dos o más procedimientos utilizan el mismo nombre (en este caso, @Producto), se verifica que la definición del conjunto resultado sea el mismo en todos estos procedimientos (es decir, todos deben tener el mismo número de columnas, con iguales nombres y tipos). Este nuevo mecanismo permite tener distintos procedimientos que retornan conjuntos de resultado iguales, todos los cuales son representados por la misma clase.
• Se mejoran los mensajes de error cuando hay problemas de conversión a objetos Integer y Long de Java.

Versión 1.96 – 21 de Enero de 2015

• Se corrige el código generado para aquellos tipos .NET que no pueden tener el valor null o Nothing, como los tipos int o char. Este problema se presentaba cuando se especificaba la opción Usar tipos que puedan representar el valor NULL de base de datos en el panel Generar componente .NET.