Puede crear Java Emitter Templates (JET) para generar archivos SQLJ que utilicen la información que recopila el asistente de nuevos archivos SQLJ.
Requisito previo: cree un proyecto JET en el entorno de trabajo.
Para realizar esta tarea, debe tener experiencia en la creación de Java Emitter Templates. Para obtener más información sobre la creación de Java Emitter Templates, consulte los siguientes artículos en el sitio web de eclipse.org:
Para ahorrar espacio en los pasos de la tarea, se omite la vía de acceso completa del directorio ...\com.ibm.datatools.sqlj. La vía de acceso completa es directorio_instalación\eclipse\plugins\com.ibm.datatools.sqlj.
Para crear e implementar una plantilla JET para el asistente de nuevos archivos SQLJ:
- Añada un esqueleto al proyecto JET:
- Importe el archivo SQLJFileSkeleton.skel en el proyecto JET. El archivo se encuentra en el directorio ...\com.ibm.datatools.sqlj\templates\skeleton.
- Cree un esqueleto en el proyecto JET. El esqueleto debe definir una clase que implemente la interfaz ISQLTemplate con un método generate() que acepte IBeanData como parámetro.
- Cree la plantilla en el proyecto JET. Puede crear un archivo o importar uno de las plantillas que se proporcionan con el área de trabajo y cambiar su contenido para adaptarlo a sus necesidades. Los archivos de plantilla se encuentran en el directorio ...\com.ibm.datatools.sqlj\templates.
La norma JET de la plantilla debe contener:
- Un nombre de clase exclusivo en todas las plantillas del directorio ...\com.ibm.datatools.sqlj\templates.
Es recomendable que el nombre de clase sea igual al nombre de la plantilla.
- Un atributo skeleton que haga referencia al esqueleto que va a utilizar.
- Añada el archivo JAR de tiempo de ejecución para el plug-in SQLJ a la vía de acceso de compilación Java del proyecto. En la ventana Propiedades del proyecto, pulse Vía de acceso de construcción Java y, a continuación, realice una de las siguientes acciones en la página Bibliotecas:
- Si ha creado un archivo SQLJ con el asistente de nuevos archivos SQLJ, pulse Añadir variable y, a continuación, efectúe una doble pulsación sobre SQLJPLUGIN en la ventana Nueva entrada de la variable Classpath.
- Si no utilizó el asistente de nuevos archivos SQLJ, pulse Añadir JAR externos, vaya al directorio ...\com.ibm.datatools.sqlj en la ventana Selección de JAR y efectúe una doble pulsación sobre el archivo sqlj.jar.
El archivo JAR de tiempo de ejecución para el plug-in SQLJ resuelve las referencias de la plantilla en clases del plug-in SQLJ.
- Cuando la plantilla se haya compilado satisfactoriamente, copie el archivo .sqljjet en el directorio ...\com.ibm.datatools.sqlj\templates.
Si creó un archivo esqueleto nuevo, cópielo en el subdirectorio de ...\com.ibm.datatools.sqlj que coincide con la referencia de la norma JET.
- Añada la descripción de la plantilla en el archivo user.properties del directorio ...\com.ibm.datatools.sqlj\template\properties. Abra el archivo en un editor de texto y añada las dos líneas siguientes después de las líneas con comentarios:
nombre_archivo_plantilla.label=Nombre de plantilla
nombre_archivo_plantilla.desc=Descripción de la plantilla.
El nombre de la plantilla que se especifica en la etiqueta se incluye en la lista Plantilla del asistente de nuevos archivos SQLJ. Cuando se selecciona la plantilla de la lista, su descripción se muestra en el cuadro de visualización situado al lado de la lista.
- Utilice el asistente para crear un archivo SQLJ, seleccione la plantilla y, a continuación, revise el código resultante en el archivo SQLJ generado.
Si tiene que realizar cambios en la plantilla, puede utilizar uno de los métodos siguientes:
- Utilice un editor de texto para cambiar el archivo de plantilla directamente en el directorio ...\com.ibm.datatools.sqlj\templates.
- Utilice el área de trabajo para cambiar la plantilla en el proyecto JET y, a continuación, copie el archivo actualizado en el directorio del plug-in SQLJ (...\com.ibm.datatools.sqlj\templates).
La próxima vez que utilice el asistente de nuevos archivos SQLJ para crear un nuevo archivo SQLJ, el plug-in SQLJ detectará que el archivo de plantilla ha cambiado y utilizará la plantilla actualizada.