• Introducción al API Apache SOAP v2.2
• Requerimientos y Limitaciones

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.