El API Apache SOAP v2.2
Introducción al API Apache SOAP v2.2
Apache SOAP es una implementación Java de código abierto de las especificaciones SOAP v1.1 y SOAP Messages with Attachments. Apache SOAP está desarrollado por la comunidad Apache SOAP.
Apache SOAP se puede usar como una librería cliente para invocar servicios SOAP disponibles en cualquier lugar o como una herramienta del lado del servidor para implementar servicios SOAP accesibles. Como una librería cliente proporciona un API para invocar servicios SOAP RPC así como un API para enviar y recibir mensajes SOAP. Como un mecanismo para escribir un nuevo Servicios RPC accessibles o Servicios de Mensajes Accesibles, espera ser hospedado por un contendor de servlets (como Apache Tomcat, por ejemplo). Aunque el código base se puede ampliar para soportar transporte no-HTTP. el código proporcionado sólo tiene límitado el soporte para transporte no-HTTP (especificamente, sólo para SMTP).
Si eres nuevo en SOAP, y te gustaría aprender más sobre él y los servicios Web en general, hay muchos recursos maravillosos disponibles en la Web. Abajo hay una lista incompleta (sin ningún orden particular) de grandes sitios donden empezar:
- http://www.xmethods.net
- http://www.webservices.org
- http://www.ibm.com/developerworks/webservices/
- http://msdn.microsoft.com/soap
- http://www.develop.com/soap
- http://www.soapware.org/
Puedes encontrar una FAQ en http://xml.apache.org/soap/faq.
Requerimientos y Limitaciones
Apache SOAP tiene los siguientes requerimientos:
- Java 1.1 o superior y motor sevlet que soporte la versión 2.1 siperior del API Java Servlet
- Un JAXP compatible, analizador XML con cuidado de espacio de nombres.
- JavaMail (mail.jar) y el JavaBeans Activation Framework (activation.jar)
- La codificación XML requiere el uso de Java 1.2.2 y XML4J 2.0.15. Nuestro classpath debe tener xerces.jar y después xml4j.jar en este orden.
- La Implementación de servicios en lenguajes de script requieren el uso de Bean Scripting Framework.
- El soporte SSL (HTTPS) requiere Java 1.2.1 o posterior y la Java Secure Socket Extension.
- El transporte SMTP requiere las Suites de Beans SMTP y POP3.
Las siguientes caracterísiticas de la especificación SOAP v1.1 no están soportadas actualmente:
- El atributo encodingStyle debe tener sólo un estilo de codificación dado (ver la sección 4.1.1 de la especicación)
- El atributo mustUnderstand sólo soporta chequear peticiones rechazadas que requieren el chequeo mustUnderstand
- Atributo root
- Atributo actor y SOAP intermediarios
- No usa los accesores multi-ref durante la serialización
Existen las siguientes limitaciones sobre los Mensajes SOAP con Attachments:
- La URI del documento base no se coge de la cabecera multiparte Content-Location.
- El soporte para URIs relativas en las cabeceras Content-Location está limtiado a la concatenación de la URI del documento base a la URI relativa.
- El transporte SMTP proporcionado no soporta mensajes multiparte.
- Los métodos RPC del lado del servidor no tienen ninguna otra forma de añadir attachments a la respuesta que mediante el objeto devuelto. Los métodos de Messaging ya pueden hacer esto.
