Notas técnicas de Address Book


Para obtener una explicación de los servicios Web, consulte la documentación Servicios web de IBM WebSphere en InfoCenter.

El ejemplo de AddressBook muestra el acceso de servicio Web de diversas maneras. El ejemplo incluye dos clientes y cuatro variantes del mismo bean de AddressBook. Estos dos clientes son un cliente de Java 2 Standard Edition (J2SE) y un cliente de Java 2 Enterprise Edition (J2EE). Cada cliente ejerce las cuatro variantes del bean de AddressBook que están desplegadas en el servidor.

Búsqueda del código fuente

Puede buscar el código fuente para el ejemplo de AddressBook en los subdirectorios de raíz_perfilsamples/src/WebServicesSamples. El código fuente de cada uno de los beans de aplicación de AddressBook se encuentra en un subdirectorio denominado tal como se muestra en la tabla que aparece a continuación. El código fuente de cliente J2SE sencillo se encuentra en el directorio Clients/simpleClients/samples/address. El código fuente de cliente de aplicación J2EE se encuentra en el directorio Clients/applicationClients/AddressBookClient.

Clientes de z/OS: no se proporciona el árbol de código fuente de los ejemplos en la plataforma z/OS porque las aplicaciones de ejemplo no están creadas en plataformas z/OS.

Las cuatro variantes de los beans de aplicación muestran distintos enfoques para desarrollar una aplicación habilitada para servicios Web. Hay dos Enterprise JavaBeans (EJB), cada uno de los cuales se construye con un enfoque diferente. Un enfoque demuestra la construcción de un bean de servicios Web empezando por un archivo WSDL (Web Service Definition Language) y utiliza la herramienta WSDL2Java para generar el código o las vinculaciones Java.

Los artefactos de este EJB incluyen "W2JE" para distinguirlos de las otras versiones. Un segundo enterprise bean se construye empezando por un EJB implementado y utilizando la herramienta Java2WSDL para generar su archivo WSDL. El archivo WSDL se utiliza para generar los descriptores de despliegue. Los artefactos de este enterprise bean se diseñan con "J2WE".

De forma similar, los artefactos de ambos JavaBeans contienen la serie "J2WB" o "W2JB", que indica el enfoque específico.

La tabla siguiente muestra cómo se denominan los cuatro beans de AddressBook.

 
Puerto Directorio Clase de implementación Demuestra
AddressBookW2JE addrEJBTopDown AddressBookSoapBindingImpl.java Un enterprise bean de servicios Web desarrollado al iniciar con un archivo WSDL y utilizando la herramienta WSDL2Java para generar el código Java para el enterprise bean.
AddressBookJ2WE addrEJBBottomUp AddressBookBeanImpl.java Un enterprise bean de servicios Web desarrollado al iniciar con un archivo bean y utilizando la herramienta Java2WSDL para generar un archivo WSDL a partir del cual se crean los descriptores de despliegue.
AddressBookJ2WB addrBeanBottomUp AddressBookBean.java Un JavaBean de servicios Web desarrollado al iniciar con un archivo bean y utilizando la herramienta Java2WSDL para generar un archivo WSDL a partir del cual se crean los descriptores de despliegue.
AddressBookW2JB addrBeanTopDown AddressBookBean.java Un JavaBean de servicios Web desarrollado al iniciar con WSDL y utilizando la herramienta WSDL2Java para generar el código Java para el bean.

Puede buscar los directorios indicados en la tabla bajo el directorio raíz_perfilsamples/src/WebServicesSamples.

Cada implementación del servicio AddressBook da soporte a la operación getAddressFromName. La operación devuelve una respuesta estática al cliente. No hay ningún almacenamiento de base de datos de las direcciones. La finalidad de este ejemplo es mostrar la relación entre un archivo bean y un servicio Web.

Todas las versiones del servicio AddressBook están en el archivo WebServicesSamples.ear. Los nombres exclusivos de contexto de raíz y archivos jar les permiten desplegarse simultáneamente. Además, las clases de implementación de EJB tienen nombres exclusivos y difieren de las clases de implementación de JavaBean. Esta exclusividad asegura que el cargador de clases del servidor localizará la clase de implementación adecuada.

Revisión de las relaciones de bean de AddressBook

El ejemplo incluye dos clientes, un cliente J2SE y un cliente J2EE. Cada cliente ejerce las cuatro variantes del bean de AddressBook que están desplegadas en el servidor.

La relación entre los cuatro beans desplegados en el servidor puede verse en el archivo WSDL de cliente, que se elabora para el acceso de clientes a cualquiera de los cuatro beans. El archivo WSDL define un servicio, AddressBookService, con cuatro puertos. El cliente AddressBook.wsdl se encuentra en el directorio de ejemplos, src/WebServicesSamples/Clients/applicationClients/META-INF.