Tutorial: Envío de archivos a IPFS mediante WSO2 EI (Parte I)

Como se puede observar en la imagen anterior, se muestra del lado derecho una paletas con elementos que se ocuparán como pueden ser los Mediator Logs, Mediator Enrich, Mediator Call, entre otros.

Otra manera de crear es seleccionar la opción de Source en vez de Design en la cual se puede copiar el siguiente código.

<?xml version="1.0" encoding="UTF-8"?>
<proxy name="envio_v1_ipfs-sp" startOnLoad="true" transports="vfs"
    xmlns="http://ws.apache.org/ns/synapse">
    <target>
        <inSequence>
            <enrich>
                <source clone="true" type="body" />
                <target property="originalBody" type="property" />
            </enrich>
            <property name="messageType" scope="axis2" type="STRING" value="multipart/form-data" />
            <payloadFactory media-type="xml">
                <format>
                    <root>
                        <file filename="file" name="file" xmlns="http://org.apache.axis2/xsd/form-data">$1</file>
                    </root>
                </format>
                <args>
                    <arg evaluator="xml" expression="$ctx:originalBody" />
                </args>
            </payloadFactory>
            <header name="Content-Type" scope="transport" value="multipart/form-data" />
            <property name="messageType" scope="axis2" type="STRING" value="multipart/form-data" />
            <property name="OUT_ONLY" scope="default" type="STRING" value="false" />
            <log level="custom">
                <property name="======================== Envio de Archivo =========================" expression="$ctx:originalBody" />
            </log>
            <call blocking="true">
                <endpoint>
                    <http method="POST" uri-template="http://127.0.0.1:5001/api/v0/add" />
                </endpoint>
            </call>
            <filter regex="200" source="$axis2:HTTP_SC">
                <then>
                    <log level="full" />
                    <call-template target="file">
                        <with-param name="message" value="HELLO WORLD!!!!!!" />
                    </call-template>
                </then>
                <else>
                    <log level="full" />
                    <call-template target="file">
                        <with-param name="message" value="HELLO WORLD!!!!!!" />
                    </call-template>
                </else>
            </filter>
            <send />
        </inSequence>
        <outSequence />
        <faultSequence />
    </target>
    <parameter name="transport.PollInterval">5</parameter>
    <parameter name="transport.vfs.FileURI">file:///home/chakray/Documentos/WSO2/EI/test
    </parameter>
    <parameter name="transport.vfs.ContentType">application/octet-stream; charset="UTF-8"
    </parameter>
    <parameter name="transport.vfs.ActionAfterProcess">DELETE</parameter>
    <parameter name="transport.vfs.FileNamePattern">.*\..*</parameter>
    <parameter name="transport.vfs.Locking">disable</parameter>
</proxy>

Posteriormente se solicitará que se guarde el cambio en el archivo xml y se procederá a generar el CAR, para ello se debe seleccionar el modulo de demoipfsCompositeExporter y dar clic derecho para que se pueda desplegar en menú emergente con la opción de “Export Composite Application Project“ y se mostrará la siguiente ventana.

Donde se solicitará la siguiente información:

1. El nombre del CAR.

2. La versión del CAR.

3. La ruta donde se depositara el CAR.

Posteriormente al dar clic en el botón de Next, se mostrará la lista de los artefactos que se agregan al CAR, en la cual se debe seleccionar el modulo de “demoipfsConfigs”.

Para finalizar se debe dar clic en el botón de Finish, con ello se mostrará el siguiente mensaje si el proceso finalizó con éxito.

Se puede comprobar el archivo CAR en la ruta ingresada anteriormente.

9. Instalación de CAR en WSO2 EI

Para realizar el proceso de instalación del archivo CAR, previamente creado, se debe realizar los siguientes pasos.

• Ingresar a la consola web de Enterprise Integrator con el usuario administrador en la url https://172.17.0.1:9443/carbon.

• Al acceder a la consola, se mostrará el menú en el lado izquierdo en el cual en el apartado de Carbon Applications se deberá dar clic en la opción de “Add” para agregar el CAR que se ha creado previamente.

• A continuación se mostrará un formulario donde se deberá dar clic en el botón de “Seleccionar archivo”.

• Posteriormente se mostrará un cuadro emergente en el cual se solicitará seleccionar en la carpeta el CAR que se instalará.

• Para finalizar en el formulario anterior se mostrará el nombre del CAR que se seleccionó, con ello se se procederá a dar clic en el botón “Upload”.

• Si el despliegue se realizo con éxito se deberá observar 2 puntos:

1.- Mensaje de despliegue exitoso de CAR.

2.- Muestra en la lista de “Carbon Applications“.

• De manera extra se puede observar el la lista de los services el service proxy que se creó. Para ello se debe dar clic en la opción “List“ en la apartado del menú de Services.

Para comprobar la integración de los servicios de IPFS con WSO2 EI, se podrá probar si en el file system al que si hacía referencia (/home/[absolutePath]/[absolutePath]/WSO2/EI/test) en el service proxy se coloca un archivo. Como respuesta de del servicio se muestra en el log el hash que se generó en el IPFS.

Para comprobarlo en el nodo de IPFS se puede consultar en la consola web, copiando el hash generado y buscarlo en la consola.

Para ello se pega el hash generado y en buscador se da clic en Examinar de esta manera se mostrará el documento previamente cargado.

10. Conclusiones

Como sea podido revisar en este tutorial de envío de archivos a IPFS mediante WSO2 EI, IPFS es un filesystem que encripta los documentos para su posterior exposición a la red (local) dentro de la organización, al trabajar en nodos se puede agregar “N“ nodos a la red según se requiera en el negocio.

Al integrarlo con IPFS la herramienta WSO2 EI se puede configurar para la entrega o almacenamiento garantizado de los documentos ya que por sus características se tanto fallas como errores se pueden controlar de manera eficiente.

Para concluir se muestra el esquema del flujo de operación del ejemplo.

Referencias

• Documentación de la API HTTP: https://docs.ipfs.io/reference/http/api/#getting-started  
• Documentación para trabajar por línea de comandos con ipfs: https://docs.ipfs.io/reference/cli/#ipfs-cat
• Documentación del mediador PlayloadFactory: https://docs.wso2.com/display/EI650/PayloadFactory+Mediator
• Información general sobre el concepto de una API REST: https://www.redhat.com/es/topics/api/what-is-a-rest-api
• Documentación sobre el concepto de RPC: https://es.wikipedia.org/wiki/Llamada_a_procedimiento_remoto
• Documentación WSO2 para utilizar VFS: https://docs.wso2.com/display/ESB500/VFS+Transport
• Ejemplo práctico de PlayloadFactory: https://medium.com/think-integration/construct-and-send-multipart-form-data-using-wso2-ei-5cd548d095ee

Ebook

Kit WSO2 ESB: Fórmate y conviértete en un experto

¿Estás interesado en WSO2 ESB?No te pierdas este Ebook para comenzar a utilizar esta solución de WSO2 tan flexible e implementada por grandes empresas.

Descargar Ebook