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.