WSO2 EI: Como crear un servicio con acceso a BBDD

Hoy vamos a ver algo muy facil de hacer y muy util. Vamos ver como crear un data service, asociarle un data source y crear una operación asociada. 

Los datasources son los elementos de configuración que nos permiten conectarnos con diferentes origenes de datos. Desde base de datos tradicionales, a hojas de excel o google sheet, CSV o base de datos NoSQL como Cassandra o MongoDB. 

Otra cosa que debemos saber de estos Datasources, es que podemos configurarlos de distintas formas:

• Desde el fichero custom-datasources.xml
• Desde la consola de administración. Accediendo a la pestaña Configure y la  opción de menú Datasources.
• Desde el propio Data service.  

Los data services serán aquellos servicios que teniendo como origen esos datasources, expondrán mediante operaciones o recursos los datos del mismo. Para exponer esos datos deberremos realizar los siguientes pasos:

• Crear el data service e indicar los protocolos de acceso al mismo. 
• Asociar al menos un datasource. 
• Crear un consulta SQL.
• Crear una operación o recurso asociado a la consulta. 

 Al crear una consulta debemos realizar tres pasos fundamentales:

• Escribir la propia consulta SQL. 
• Indicar los parámetros de entrada
• Indicar los parámetros de salida y su formato. 

Tanto la creación de parámetros de entrada y salida se pueden crear de forma automática con los botones Generate Input Mappings y Generate Response. A ambos se les puede indicar el tipo de elemento (por defecto, String). En los parámetros de entrada se pueden incluir validaciones y respecto a la salida, por defecto será en formato XML y podemos indicarle el nombre de los objetos que envuelvan esos registros. 

El siguiente paso es la creación de la operación o recurso. En ambos casos es relativamente sencillo, solo debemos indicar la consulta que estará asociada a estos y de forma automática se creará el propio mapeo del propio recurso u operación. La diferencia principal, es que una operación habilitará un servicio de tipo SOAP para realizar la consulta asociada. Y si creamos un recurso, el servicio será de tipo REST. 

Si queremos probarlo, en el listado de servicios hay un botón denominado Try this service que abrirá una nueva ventana para realizar las pruebas. En el caso de las operaciones para poder invocarlo realizaremos la siguiente llamada:

curl --insecure \

--request POST 'https://localhost:8243/services/sampleDataservice.SecureSOAP12Endpoint' \
--header 'Content-Type: application/xml' \
--data-raw '<p:SELECT_OP xmlns:p="http://ws.wso2.org/dataservice">
      <xs:ID xmlns:xs="http://ws.wso2.org/dataservice">1</xs:ID>
   </p:SELECT_OP>'

La ruta del servicio estará compuesta por el nombre del servidor, el puerto (8280 para HTTP y 8243 para HTTPS, por defecto). De contexto /services/ y el nombre del data service, y por último el sufijo en función del tipo de endpoint SOAP que vayamos a usar.

El cuerpo del mensaje tendra como raiz el elemento con nombre de la operación (SELECT_OP en este caso) y compuesto por los distintos atributos de la consulta.
asdfad