Escribir un servicio SOAP basado en RPC es muy trivial y realmente s�lo implica los dos siguientes pasos:
- Crear un c�digo de artefacto que sea soportado por uno de los proveedores de Apache SOAP;
una clase estandard Java (incluyendo Java Beans,) un EJB, o un BSF que soporte scripts. El c�digo del artefacto no tiene porque saber nada sobre Apache SOAP, mientras que simplemente expongamos un m�todo o una funci�n script que exista dentro del artefacto. Por ejemplo, si creamos una clase Java que tenga un m�todo llamado add(), podriamos exponer este m�todo como un servicio SOAP. Se pueden exponer varios metodos para un s�lo servicio, como se describe en la siguiente secci�n.
Observa que los par�metros de nuestro m�todo/funci�n deben ser serializados por SOAP, y tambi�n deben existir dentro del registro de mapeo SOAP. Para ver informaci�n sobre la creacci�n de mapeos de tipos, mira aqu�.
- Crear un descriptor de despliegue Apache SOAP para nuestro servicio.
El descriptor de despliege proporciona a la implementaci�n la informaci�n necesaria para manejar las solicitudes para un servicio ofrecido. Para una implementaci�n de servicio Java, esto incluye informaci�n como el nombre de la clase que proporciona la implementaci�n, as� como el nombre de los m�todos que van a ser expuestos. Puedes encontrar m�s informaci�n sobre los descriptores de despliegue aqu�.
En una implementaci�n de servicio basado en Java, podr�amos lanzar una SOAPException para indicar que ha ocurido alg�n error cuando se proces� la solicitud. Lanzar una SOAPException(FAULT_CODE_CLIENT, ...) permitir� a nuestra implementaci�n de servicio indicar que el fallo fu� debido a un error de cliente, mientras que lanzar una SOAPException(FAULT_CODE_SERVER, ...) indicar� que nuestra implementaci�n de servicio fue el causante de� fallo (Si lanzamos cualquier otro tipo de excepci�n, el servidor la capturar�, y la pasar� a un SOAPException(FAULT_CODE_SERVER, ...)). Ver la especificaci�n SOAP v1.1 para m�s informaci�n sobre fallos SOAP.