Desarrollo J2EE: notas de release

1.0 Introducción
2.0 Problemas conocidos
   2.1 Añadir archivos de módulo a un proyecto de aplicación de empresa
   2.2 Elementos de descriptor de despliegue alternativo (alt-dd) en las aplicaciones de empresa
   2.3 Valores de la vía de construcción Java para proyectos EJB/Web/cliente de aplicaciones
   2.4 Los espacios no están soportados en los URI de JAR dentro de un EAR
   2.5 Los nombres de los proyectos de aplicación de empresa no deben contener caracteres DBCS
   2.6 Los proyectos binarios son solo de lectura
   2.7 Crear ejemplos múltiples veces
   2.8 La vía de construcción Java se actualiza al eliminar la dependencia de un archivo JAR de utilidades
   2.9 La página de dependencias JAR Java no consigue actualizar la vía de construcción Java
   2.10 Eliminación automática de enlaces de WebSphere con supresión
   2.11 Soporte de tareas ANT J2EE
   2.12 Bloqueo de recursos debido a la validación JSP
   2.13 Reserva automática en ClearCase al importar y sobrescribir archivos existentes
   2.14 Error 'Descripción de proyecto no válida' al utilizar una ubicación de proyecto que no es por omisión para un proyecto J2EE nuevo
   2.15 Soporte Ant sin cabecera J2EE: aplicación com.ibm.etools.j2ee.ant.RunAnt

1.0 Introducción

La perspectiva J2EE contiene las vistas que utilizará habitualmente al desarrollar recursos para proyectos de aplicación de empresa, EJB, Web y de cliente de aplicaciones. En este archivo readme se describen algunos de los problemas conocidos, limitaciones y métodos alternativos asociados a las herramientas de desarrollo J2EE de WebSphere Studio. En el archivo readme de las herramientas Web hallará documentación sobre otros elementos relacionados con las vistas J2EE y los proyectos Web de J2EE.

2.0 Problemas conocidos

2.1 Añadir archivos de módulo a un proyecto de aplicación de empresa

Al importar uno de los tipos de archivos de módulo (JAR de EJB, WAR, RAR y archivo JAR de cliente de aplicaciones) a un proyecto de aplicación de empresa, debe utilizar el asistente de importación correcto e importar el archivo de módulo al tipo de proyecto apropiado. No debe importarlo al proyecto de aplicación de empresa. Si el archivo de módulo se importa al proyecto de aplicación de empresa, no podrá añadir el módulo a la aplicación mediante el editor de descriptores de despliegue de la aplicación.

2.2 Elementos de descriptor de despliegue alternativo (alt-dd) en las aplicaciones de empresa

La utilización de alt-dd no está soportada actualmente en WebSphere Studio. El método alternativo consiste en editar los descriptores de despliegue de los módulos que contiene.

2.3 Valores de la vía de construcción Java para proyectos EJB/Web/cliente de aplicaciones

Siempre que sea posible, es aconsejable aceptar los valores por omisión de la vía de construcción Java para los tipos de proyecto J2EE. Para configurar dependencias entre proyectos contenidos en una aplicación de empresa, utilice el editor de dependencias de JAR o bien la página de propiedades de dependencias de JAR. Así mantendrá el atributo Class-Path del archivo MANIFEST.MF (utilizado para la unidad ejecutable del servidor) sincronizado con la vía de construcción Java del proyecto (utilizada para la compilación Java).

En general, las bibliotecas que se necesitan para un módulo deben estar en la aplicación de empresa o ser visibles para el servidor. Por lo tanto, tenga cuidado al añadir bibliotecas externas a la vía de construcción del proyecto, porque puede ser que el proyecto no funcione en el servidor. Por ejemplo, suponga que tiene una biblioteca off_the_shelf.jar a la que desea hacer referencia en un módulo WEB. Puede elegir de entre estos procedimientos:

  1. Añada off_the_shelf.jar a la aplicación de empresa mediante el asistente de importación del sistema de archivos; a continuación, utilice el editor de dependencias de JAR para hacer que el módulo WEB dependa del JAR, o bien
  2. Utilice las propiedades de la vía de construcción Java para el proyecto WEB para añadir el JAR a la vía de construcción; entonces el servidor deberá tener visibilidad del JAR.

Para cumplir estas condiciones para la prueba unitaria, edite la configuración del servidor y añada el JAR a la vía de acceso de clases.

2.4 Los espacios no están soportados en los URI de JAR dentro de un EAR

Los espacios no están soportados en el URI para los módulos o archivos JAR de utilidades en una aplicación de empresa. El atributo "Class-Path:" de un archivo MANIFEST.MF de un archivo JAR o un módulo es una lista delimitada por espacios de vías de acceso relativas dentro de un EAR. Un JAR no podrá hacer referencia a otro JAR del EAR si el URI del JAR referenciado contenía espacios.

2.5 Los nombres de los proyectos de aplicación de empresa no deben contener caracteres DBCS

Cuando crea un proyecto de aplicación de empresa, le recomendamos que no le dé un nombre que contenga caracteres DBCS.

2.6 Los proyectos binarios son solo de lectura

Los proyectos binarios creados por la importación de EAR (disponible como opción en el asistente de impostación) están destinados a ser solo de lectura. No debe tratar de modificar el contenido de un proyecto binario. No obstante, puede suprimir el proyecto binario y sustituirlo por una versión fuente procedente de un depósito. La mayoría de las acciones deben estar inhabilitadas para los proyectos binarios. Si utiliza proyectos binarios, intente evitar las acciones que modifiquen el contenido del proyecto o del JAR.

2.7 Crear ejemplos múltiples veces

Para crear múltiples instancias de los ejemplos de aplicación de empresa incorporados, hay que redenominar el proyecto de ejemplo existente y todos sus proyectos de módulo antes de volver a importar el ejemplo. Si no sigue estos pasos, la segunda importación sobrescribirá los proyectos de módulo sin previo aviso.

En la vista Jerarquía J2EE, pulse con el botón derecho del ratón cada módulo cuyo nombre deba cambiarse y seleccione Redenominar. En el diálogo que se abre, teclee el nombre nuevo y marque los recuadros Redenominar módulo en todas las aplicaciones de empresa y Redenominar dependencias de módulo que hagan referencia al proyecto seleccionado. Es importante utilizar la opción de redenominar en la vista Jerarquía J2EE y seleccionar estas dos opciones para que las interdependencias de los módulos permanezcan intactas.

2.8 La vía de construcción Java se actualiza al eliminar la dependencia de un archivo JAR de utilidades

Al eliminar la dependencia de un JAR de utilidades, el proyecto Java correspondiente se eliminará de la vía de construcción Java solamente si el proyecto EAR sigue haciendo referencia al JAR dependiente.

Por ejemplo, supongamos que crea un proyecto Web J2EE 1.3 y un EAR junto con el proyecto de ejemplo Java JUnit. A continuación, añade el proyecto JUnit como JAR de utilidades en el EAR y, seguidamente, añade JUnit como dependencia JAR Java del proyecto Web.

Si entonces desea eliminar la dependencia entre JUnit y el proyecto Web, elimine primero la dependencia JAR Java del proyecto Web y, a continuación, elimine el JAR de utilidades del EAR. Siga este orden para asegurarse de que funciona correctamente.

2.9 La página de dependencias JAR Java no consigue actualizar la vía de construcción Java

La página de dependencias JAR Java no está sincronizada con la página de vía de construcción Java en el diálogo de propiedades del proyecto. Por consiguiente, un cambio aplicado en una podría no mostrarse en la otra dentro de la misma sesión de diálogo.

Existen también algunos casos en los que al pasar de una página a otra en ambos sentidos provocará que la actualización desde una cancele la actualización desde la otra al pulsar el botón Aceptar o si se pulsa el botón Aplicar antes que el botón Aceptar. Normalmente, parecerá que se ha añadido una dependencia JAR, pero el proyecto no se ha añadido a la vía de construcción Java.

Una manera de salir al paso de este problema consiste en abrir de nuevo los diálogos de propiedades, pasar a la página de dependencias de JAR, deseleccionar los JAR dependientes, volver a seleccionarlos y pulsar Aceptar.

2.10 Eliminación automática de enlaces de WebSphere con supresión

Al suprimir un objeto que contenga enlaces de WebSphere, también quedan suprimidos automáticamente los enlaces. Por ejemplo, si suprime un cometido de seguridad con enlaces en la página Seguridad del editor de descriptores de despliegue de la aplicación, los enlaces del cometido de seguridad también quedan suprimidos. Si vuelve a añadir un cometido de seguridad que tenga el mismo nombre, no olvide reenlazarlo si es necesario.

2.11 Soporte de tareas ANT J2EE

En la versión 4.x, se podía bajar un archivo zip (com.ibm.ant.extras.zip) de la Web en el que había tareas Ant y J2EE adicionales del área de trabajo para exportación. Ahora, estas tareas adicionales se proporcionan en el producto base, en el conector com.ibm.etools.j2ee.ant.

Si tiene construcciones ANT existentes basadas en el conector antiguo, deberá migrarlas porque se han realizado los siguientes cambios en 4.0.x:

  1. Los conectores que había en el archivo zip "extras" que se podía bajar en la versión 4.0.x han cambiado de nombre, por lo tanto, se ha actualizado el archivo runAnt.bat de ejemplo empleado para ejecutarse sin cabecera. Concretamente, el ID de la aplicación de inicio, que era "com.ibm.ant.extras.RunAnt", ha pasado a ser "com.ibm.etools.j2ee.ant.RunAnt". Habrá que modificar los archivos .bat existentes que se empleen para iniciar el área de trabajo sin cabecera.
  2. Ahora, la tarea utilJAR ha caído en desuso. Tan solo se ha dejado por cuestión de compatibilidad, pero ahora hay que usar el soporte de JAR de utilidades del editor de aplicaciones. También debe tener en cuenta que la tarea se ha simplificado y que algunos parámetros han dejado de ser aplicables. Hallará más información en la documentación de las tareas.
  3. Se ha añadido un parámetro a la tarea de exportación de EAR, para que incluya el distintivo nuevo soportado por el asistente, que incluye los metaarchivos del proyecto durante la exportación. Esto resulta útil para los proyectos binarios. En la documentación del producto hallará más información sobre cómo optimizar el desarrollo con los proyectos binarios.
  4. El parámetro "use35rules" de la tarea EJBDeploy ha cambiado de nombre y ahora se llama "compatible35".

2.12 Bloqueo de recursos debido a la validación JSP

Si el validador JSP ha validado recientemente un proyecto Web, es posible que los archivos JAR de biblioteca o archivos de clase referenciados por ese proyecto se estén aún utilizando. Como resultado, tal vez no sea posible suprimir o mover los archivos de clase o JAR individuales (por ejemplo, si optó por suprimir el directorio /WEB-INF/lib). Si un proyecto Web hace referencia a un archivo JAR de un proyecto EAR como dependencia JAR Java, podría ser imposible suprimir el proyecto EAR o el archivo JAR que hay en él. Con el fin de "liberar" estos recursos para las actividades de gestión de archivos, cierre el proyecto Web y vuelva a abrirlo.

2.13 Reserva automática en ClearCase al importar y sobrescribir archivos existentes

Cuando importa un módulo J2EE y decide sobrescribir los archivos existentes que se reincorporan a ClearCase, para poder sobrescribirlos, primero hay que reservarlos. En cuanto la acción de importar detecta uno o varios archivos que se reincorporan a ClearCase, aparece un cuadro de aviso con la pregunta de si desea intentar reservar los archivos especificados. Si pulsa el botón "Sí a todo", WebSphere Studio intentará reservar silenciosamente los archivos especificados y además cualquier otro archivo reincorporado que encuentre más adelante durante la operación de importar.

2.14 Error 'Descripción de proyecto no válida' al utilizar una ubicación de proyecto que no es por omisión para un proyecto J2EE nuevo

Al crear un proyecto J2EE nuevo (incluyendo proyectos Java, aplicación de empresa, Web, EJB, cliente de aplicación y conector), no puede utilizar una ubicación de proyecto que otro proyecto del entorno de trabajo ya haya utilizado. Si elige una ubicación de proyecto utilizada por otro proyecto, el asistente visualiza un diálogo de error o mensaje de tipo "Descripción de proyecto no válida". Si después de recibir este mensaje selecciona una ubicación de proyecto válida pulsando el botón Examinar, la creación del proyecto tampoco finalizará. La solución consiste en pulsar Cancelar y reabrir el asistente de creación de proyectos.

2.15 Soporte Ant sin cabecera J2EE: aplicación com.ibm.etools.j2ee.ant.RunAnt

Al ejecutar tareas Ant J2EE o EJB, utilice la aplicación com.ibm.etools.j2ee.ant.RunAnt en lugar de la aplicación org.eclipse.ant.core.antRunner.

La utilización de RunAnt tiene dos ventajas:

Volver al archivo readme principal