No utilizar descriptor de despliegue de servicios web de WebLogic

Esta regla detecta la presencia de servicios Web de JAX-RPC basándose en los siguientes criterios:

• La presencia del archivo, web-services.xml
• La presencia del archivo, weblogic-webservices.xml y el archivo webservices.xml, en la misma carpeta

Arreglo rápido
En el explorador de orígenes, esta regla produce un script Ant con tareas IBM(R) Ant específicas. Estas tareas generan servicios Web de JAX-RPC basados en los descriptores de despliegue de servicios Web de J2EE de WebLogic. El arreglo rápido explora los descriptores de despliegue de servicios web y produce un script Ant si no existe un archivo generado por IBM Ant en la carpeta raíz del proyecto. El script contiene tareas IBM Ant para generar los servicios Web de JAX-RPC.

Propiedades de la regla
Se deben proporcionar los valores correctos para las propiedades de la regla. Para cambiar los valores de las propiedades de esta regla, seleccione la regla en la ventana Configuraciones de analizador de software. A continuación, utilice los campos que aparecen en la pestaña Propiedades. Las propiedades de esta regla son:

• Nombre del script Ant generado: 
  Especifica el nombre del nuevo script Ant que se va a generar.  El nombre de script debe ser un nombre de archivo válido.  El valor no debe incluir barras inclinadas ni barras inclinadas invertidas. El script generado estará en la carpeta raíz del proyecto.
  Valor por omisión: build-ibm-ws.xml
  
  
• Nombre de la carpeta de generación:
  Especifica el nombre de la carpeta donde residirán los artefactos de generación.  El valor no debe incluir barras inclinadas ni barras inclinadas invertidas. La carpeta de generación estará en la carpeta raíz del proyecto.
  Valor por omisión: ibm-ws-gen
  

Classpath Ant
La classpath de Ant se calcula a partir del proyecto Eclipse. Es importante comprobar que todos los elementos que son necesarios para la compilación estén en la classpath de Eclipse.

Servicios JAX-RPC definidos en el archivo web-services.xml
Según la información y el tipo de servicios definidos en web-services.xml, se genera un script Ant y probablemente un código Java adicional que representa la interfaz de punto final de servicio Web para reproducir el servicio JAX-RPC.

• Componentes soportados 
  Sólo pueden reconocerse y convertirse componentes de enterprise beans de sesión sin estado (<stateless-ejb>) y Java(R) (<java-class>).
• Componentes EJB sin estado:
  El archivo JAR de Enterprise JavaBeans(TM) (EJB), tal como se define en el atributo de vía de acceso del elemento <ejb-link>, debe existir en el proyecto. El arreglo rápido explora el archivo JAR de EJB y genera una nueva clase de Interfaz de punto final de servicio (SEI) basándose en la clase remota EJB.
  Las interfaces SEI varían de las interfaces remotas EJB en que la clase debe ampliar java.rmi.Remote y cada método debe generar la excepción java.rmi.RemoteException.
  El arreglo rápido utiliza la reflexión Java en la interfaz remota EJB para generar la nueva SEI.  Por lo tanto, la vía de acceso de clases del proyecto Eclipse se debe configurar con todas las clases necesarias, los archivos JAR, las carpetas, etc. para que el arreglo rápido cargue correctamente la clase remota EJB.
  La SEI se genera en la carpeta sei, dentro de la carpeta de generación, tal como ha especificado el usuario en las propiedades de la regla.  El paquete SEI coincide con el paquete de la interfaz remota EJB y el nombre de SEI será el mismo que el de la interfaz remota EJB con la palabra SEI añadida.  Asimismo, se añade la nueva carpeta SEI a la classpath del proyecto.
  
  
• Componentes de clase Java:
  De forma parecida a los componentes EJB, el arreglo rápido genera una Interfaz de punto final de servicio a partir de la clase Java definida en el atributo <class-name>.
  
  
• Destinos Ant generados:
  El script Ant generado contiene destinos para generar el archivo WSDL y el servicio JAX-RPC basándose en la nueva SEI que se ha creado durante el arreglo rápido.
  El destino de generación WSDL tendrá el nombre genWSDL_ssss, donde ssss es el nombre del servicio JAX-RPC que se ha proporcionado en el campo de atributo name del elemento <web-service>.
  Los destinos de generación de servicios tienen el nombre genService_pppp, donde pppp es el nombre del componente del atributo name del elemento <stateless-ejb> o <java-class>.
  El arreglo rápido no utiliza la información proporcionada en otros elementos como, por ejemplo, <handlers-chain>, <types>, <operations>, <security>, etc.
  

Servicios JAXRPC definidos en el archivo webservices.xml
Según la información y el tipo de servicios definidos en el archivo webservices.xml, se genera un script Ant para reproducir el servicio JAX-RPC.

• Destinos Ant generados:
  El script Ant generado contiene destinos para generar el archivo WSDL y el servicio JAX-RPC.
  El destino de generación WSDL sólo se genera si el arreglo rápido no puede ubicar el archivo WSDL tal como se ha definido en el elemento <wsdl-file>.
  Si se crea, el destino de generación WSDL tiene el nombre genWSDL_ssss, donde ssss es el nombre del servicio tal como se ha definido en el elemento <webservice-description-name>.
  Los destinos de generación de servicios tendrán el nombre genService_pppp, donde pppp es el nombre del puerto tal como se ha definido en el elemento <port-component-name>.
  

Tareas Ant de IBM WebSphere Application Server
WebSphere(R) Application Server incluye tareas Ant como, por ejemplo, java2wsdl y wsdl2java, para generar los artefactos necesarios para los servicios JAX-RPC. El script Ant generado utiliza estas tareas para compilar el servicio.
Puede obtenerse información adicional sobre estas tareas en la documentación de WebSphere Application Server.

Ejecución del script Ant
Una vez el arreglo rápido produce el script Ant, consulte el script y añada personalizaciones adicionales si es necesario. Consulte la documentación del servidor de aplicaciones sobre personalizaciones adicionales de las tareas Ant de IBM. Hay que ejecutar el script con las herramientas Ant que se incluyen en WebSphere Application Server.  El script Ant de IBM se puede ejecutar desde:

• WAS_HOME\bin\ws_ant.bat en los sistemas operativos Windows(R)
• WAS_HOME\bin\ws_ant.sh en los sistemas operativos UNIX(R)
  

Por ejemplo: c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

Una vez ejecutados los destinos Ant, los artefactos producidos residen en la carpeta de generación.  A continuación, el usuario puede inspeccionar el código generado y los descriptores de despliegue, y añadir estos artefactos a sus módulos.