El producto ofrece archivos de ejemplo que soportan especificaciones
SCA (Service Component Architecture). Puede utilizar estos archivos
SCA de ejemplo en aplicaciones de nivel empresarial. Los servicios SCA están empaquetados en archivos JAR (Java archive) que se importan como activos al repositorio del producto y a continuación, se añaden como unidades de composición a aplicaciones de nivel empresarial.
Cada ejemplo incluye instrucciones de despliegue detalladas en un archivo
readme.html.
Requisitos previos para su uso
WebSphere Application
Server Versión 8.5
Importante: Los ejemplos Oasis han sido probados con WebSphere Application Server
Version 8.5. Todos los demás ejemplos se han probado con WebSphere Application Server versión 8.0 y versión 8.5.
Descarga de ejemplos
Para utilizar los ejemplos, descargue los archivos SCA de ejemplo desde una página de descarga del producto:
- Elija uno de los métodos siguientes para descargar el archivo sca.zip a un directorio de su estación de trabajo: FTP o HTTP.
Puede crear la vía de acceso de directorios
/samples/sca en la estación de trabajo y descargar
los archivos de ejemplo SCA en esa vía de acceso de directorios.
- En el diálogo que aparece, especifique el directorio de destino
en el que guardar los documentos y pulse Aceptar.
El archivo comprimido
SCA.zip, contiene archivos de
ejemplo en la estructura de directorios siguiente:
/CandyStore
/common
/HelloJee
/helloworld-ws-asynch
/helloworld-ws-asynch_Oasis
/installableApps
/installableApps_Oasis
/jms
/jms_Oasis
/jobbankejb
/jobbankejb_Oasis
/MultiService
/MultiService_Oasis
/MyBank
/MyBank_Oasis
readme.html
notices.txt
Atención: El archivo readme.htmlcontiene información para instalar y ejecutar el ejemplo.
Debe desplegar los archivos de ejemplo SCA como activos de una
aplicación a nivel empresarial en un
Versión 8.5 servidoro clúster o en un destino de la versión 7.0 que esté habilitado
para el paquete de características para SCA. El directorio
/installableApps contiene archivos creados
previamente que puede desplegar como activos. Los demás directorios
contienen archivos de origen, scripts e instrucciones específicos del
ejemplo, para crear los archivos desplegables.
Descripción de los ejemplos
- CandyStore (sólo OSOA)
- El archivo CandyStore.jar utiliza el enlace
predeterminado, el enlace de servicios web y el enlace EJB, y muestra el
uso del modelo recursivo, además de los mecanismos de autenticación y
autorización mediante el enlace predeterminado. El ejemplo
muestra los dos planteamientos de boca abajo (Java a WSDL) y boca arriba (WSDL a Java)
en el desarrollo de aplicaciones SCA.
Puede desplegar el archivo
predefinido CandyStore.jar en el directorio
/installableApps o crear un archivo JAR desplegable.
Para obtener una descripción de los diez compuestos de CandyStore y
detalles sobre el despliegue, consulte
/CandyStore/documentation/readme.html.
- HelloJee (sólo OSOA)
- Este ejemplo muestra cómo utilizar las anotaciones SCA en los componentes
Java Platform, Enterprise Edition (Java EE) para que estos componentes puedan
consumir servicios SCA. Las aplicaciones Java EE se pueden beneficiar del modelo de programación SCA con prácticamente ningún cambio en el código de implementación de la aplicación. El ejemplo utiliza definiciones implementation.jee para habilitar archivos Java EE como implementaciones de componentes SCA. El ejemplo tiene un archivo
Java EE sin ningún artefacto SCA en el mismo y un archivo Java EE con un archivo de definición de compuesto que define los componentes y compuestos SCA. Los componentes utilizan las definiciones implementation.ejb e implementation.web.
Muestra cómo exponer servicios EJB y servicios SCA y acceder a los valores inyectados de anotaciones de referencia y propiedades en beans de sesión sin estado y servlets.
Puede desplegar los archivos predefinidos
HelloJeeEar.ear,
HelloJeeEnhancedEar.ear y
HelloJeeSca.jar en el directorio
/installableApps o crear archivos desplegables.
Para obtener más detalles sobre el despliegue, consulte
/HelloJee/documentation/readme.html o el tema sobre
cómo utilizar módulos Java EE y componentes existentes como
implementaciones SCA.
- helloworld-ws-asynch (helloworld-ws-asynch_Oasis)
- Este ejemplo utiliza servicios web y un servicio de conversor
asíncrono.
El ejemplo tiene tres archivos desplegables: el cliente
helloworld-ws-client-war y dos servicios web,
helloworld-ws-asynchclient y
helloworld-ws-asynch.jar.
El cliente utiliza un archivo JSP (Java ServerPages) para obtener un
contexto compuesto SCA e invocar el servicio HelloWorldClient mediante un
enlace predeterminado SCA. A continuación, el servicio cliente invoca el
servicio HelloWorld mediante un enlace de servicios web. Después de invocar el servicio,
éste realiza una devolución de llamada al servicio cliente. La JSP de cliente espera durante 5 segundos a que se complete la
devolución de llamada y, a continuación, visualiza el resultado de la
devolución de llamada.
Puede desplegar los archivos predefinidos
helloworld-ws-asynch.jar,
helloworld-ws-client-war y
helloworld-ws-asynchclient en el directorio
/installableApps o crear archivos desplegables.
Para obtener una descripción de los archivos JAR y detalles sobre el
despliegue, consulte /helloworld-ws-asynch html.
Para obtener instrucciones detalladas sobre cómo desplegar
el archivo helloworld-ws-asynch.jar
en una aplicación de nivel empresarial, consulte "Ejemplo: Creación de una
aplicación de nivel empresarial SCA con la consola" y
"Ejemplo: Creación una aplicación de nivel empresarial SCA
con scripts" en el centro de información.
- JMS (JMS_Oasis)
- Los ejemplos JMS muestra cómo invocar un servicio de componentes SCA utilizando
un cliente JMS (Java Message Service). Hay tres ejemplos de enlace JMS:
- TwoWay, que proporciona un método bidireccional que devuelve un valor
- TwoWay-OneWay, que proporciona un método bidireccional que invoca LoggingService
a través de un método unidireccional para registrar el mensaje en el
archivo SystemOut de servidor
- TwoWay-OneWay-Callback, que proporciona un método unidireccional que realiza
una devolución de llamada al componente HelloServiceComponent de POJO
También se proporcionan con los ejemplos de enlace JMS un
componente POJO y un cliente ligero:
- HelloServiceComponent, un componente POJO simple que recibe el mensaje JMS
a través del enlace de servicio JMS, ejecuta el método de componente POJO y
devuelve al emisor de la llamada el resultado como un mensaje de respuesta
- thinClient, un cliente JMS no SCA empaquetado en el archivo
jms-client.jar que invoca el servicio SCA
HelloService de POJO enviando un mensaje JMS al proveedor de mensajes
JMS
Puede desplegar los archivos predefinidos
service-jms-devolución de llamada,
jms-twoway-oneway-service y
jms-twoway-service en el directorio
/installableApps o crear archivos desplegables.
Para obtener más información sobre cómo crear artefactos de ejemplo JMS,
crear recursos JMS para los ejemplos y desplegar los ejemplos, consulte
/jms/documentation/readme.html.
- JobbankTargetEJBApp (JobbankTargetEJBApp_Oasis)
- Este ejemplo muestra cómo un cliente Java EE,
JobbankClientApp.ear,
puede invocar un componente SCA, jobbankejb.jar, utilizando un
enlace de servicio EJB remoto así como la manera en que un componente
con un enlace de referencia EJB puede invocar un EJB externo remoto,
que está en JobbankTargetEJBApp.ear. El enlace de bean de sesión sin estado es un enlace de protocolo que proporciona
la posibilidad de integrar SCA con servicios basados en EJB. El soporte SCA
está en jobbankejb.jar.
Puede desplegar los
archivos predefinidos JobbankClientApp.ear,
jobbankejb.jar y
JobbankTargetEJBApp.ear en el directorio
/installableApps o crear archivos desplegables.
Para obtener una descripción de los archivos y detalles sobre su despliegue, consulte /jobbankejb/documentation/readme.html.
- MultiService (MultiService_Oasis)
- Ejemplo muestra la composición de servicio utilizando servicios existentes.
El
ejemplo MultiService se conecta a varios ejemplos existentes:
- Stock Quote, WebServicesSamples.ear
- HelloWorldAsync, helloworld-ws-asynch.jar
- JobbankTargetEJBApp, JobbankTargetEJBApp.ear
- EJB Counter, EJB3CounterSample.ear
Puede desplegar los archivos predefinidos
Multiservice.jar,
MultiService.war,
helloworld-ws-asynch.jar y
JobbankTargetEJBApp.ear en el directorio
/installableApps o crear archivos desplegables.
Puede desplegar los archivos predefinidos WebServicesSamples.ear y EJB3CounterSample.ear en el directorio /installableApps.
Hay una opción en el ejemplo para implementar el servicio SCA como aplicación OSGi con
enlaces de datos SDO.
Para obtener más detalles sobre el despliegue, consulte
/MultiService/documentation/readme.html.
- MyBank (MyBank_Oasis)
- Este ejemplo muestra cómo crear una aplicación SCA que utilice JAXB siguiendo
un planteamiento de boca abajo. Utilice AccountService.wsdl
para generar clases JAXB que proporcionan un enlace de datos entre archivos
XML y Java. A continuación, utilice una referencia en el archivo WAR del
lado del cliente para conectarse al servicio de cuentas mediante del
enlace de servicios web.
También existe una opción para implementar el servicio SCA como aplicación OSGi con
enlaces de datos SDO.
Puede desplegar los archivos predefinidos mybank-accountservice.jar y mybank-client.war en el directorio /installableApps o crear archivos desplegables.
Para obtener más detalles sobre el despliegue, consulte
/MyBank/documentation/readme.html.