Accessing a Windows Share using VFS¶
This example demonstrates how the VFS transport in WSO2 Micro Integrator can be used to access a windows share.
Synapse configuration¶
Following are the integration artifacts (proxy service) that we can used to implement this scenario.
<proxy xmlns="http://ws.apache.org/ns/synapse" name="StockQuoteProxy" transports="vfs">
<parameter name="transport.vfs.FileURI">vfs:smb://host/test/in</parameter>
<parameter name="transport.vfs.ContentType">text/xml</parameter>
<parameter name="transport.vfs.FileNamePattern">.*\.xml</parameter>
<parameter name="transport.PollInterval">15</parameter>
<parameter name="transport.vfs.MoveAfterProcess">vfs:smb://host/test/original</parameter>
<parameter name="transport.vfs.MoveAfterFailure">vfs:smb://host/test/failed</parameter>
<parameter name="transport.vfs.ActionAfterProcess">MOVE</parameter>
<parameter name="transport.vfs.ActionAfterFailure">MOVE</parameter>
<target>
<inSequence>=
<header name="Action" value="urn:getQuote"/>
<send>
<endpoint>
<address uri="http://localhost:9000/services/SimpleStockQuoteService"/>
</endpoint>
</send>
</inSequence>
<outSequence>
<property name="transport.vfs.ReplyFileName"
expression="fn:concat(fn:substring-after(get-property('MessageID'), 'urn:uuid:'), '.xml')" scope="transport"/>
<property action="set" name="OUT_ONLY" value="true"/>
<send>
<endpoint>
<address uri="vfs:smb://host/test/out"/>
</endpoint>
</send>
</outSequence>
</target>
<publishWSDL key="conf:custom/sample_proxy_1.wsdl"/>
</proxy>
Build and run¶
To test this sample, the following files and directories should be created:
1. Download the provider jar and place it in
-
Create the file directories:
- Create a directory named test on a windows machine and create three sub directories named in , out and original within the test directory.
- Grant permission to the network users to read from and write to the test directory and sub directories.
- Be sure to update the in, original, and original directory locations with the values given as the
transport.vfs.FileURI
,transport.vfs.MoveAfterProcess
,transport.vfs.MoveAfterFailure
parameter values in your synapse configuration. - You need to set both
transport.vfs.MoveAfterProcess
andtransport.vfs.MoveAfterFailure
parameter values to point to the original directory location. - Be sure that the endpoint in the
<outSequence>
points to the out directory location. Make sure that the prefixvfs:
in the endpoint URL is not removed or changed.
-
Add sample_proxy_1.wsdl as a registry resource. Change the registry path of the proxy accordingly.
-
Set up the back-end service.
- Download the back-end service
- Extract the downloaded zip file.
- Open a terminal, navigate to the
axis2Server/bin/
directory inside the extracted folder. -
Execute the following command to start the axis2server with the SimpleStockQuote back-end service:
sh axis2server.sh
axis2server.bat
-
Create the
test.xml
file shown below and copy it to the location specified bytransport.vfs.FileURI
in the configuration (i.e., the in directory). This contains a simple stock quote request in XML/SOAP format.
When the sample is executed, the VFS transport listener picks the file from the in directory and sends it to the back service over HTTP. Then the request XML file is moved to the original directory and the response is saved to the out directory.<?xml version='1.0' encoding='UTF-8'?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsa="http://www.w3.org/2005/08/addressing"> <soapenv:Body> <m0:getQuote xmlns:m0="http://services.samples"> <m0:request> <m0:symbol>IBM</m0:symbol> </m0:request> </m0:getQuote> </soapenv:Body> </soapenv:Envelope>
Using SMB2 for VFS transport¶
SMB3 Support in VFS Transport
Starting from version API-M 4.1.0, the VFS (Virtual File System) transport in MI now supports both SMB2 and SMB3 protocols for Windows share URI configurations. This enhancement allows for improved performance, security, and compatibility with modern SMB implementations.
Windows share URI format for SMB v⅔ use cases is shown below.
vfs:smb2://[username]:[password]@[hostname]:[port]/[absolute-path]
You can use the proxy given below to test the SMB2 functionality.
<?xml version="1.0" encoding="UTF-8"?>
<proxy xmlns="http://ws.apache.org/ns/synapse"
name="smb2proxy"
transports="vfs"
startOnLoad="true">
<description/>
<target>
<inSequence>
<property name="transport.vfs.ReplyFileName"
expression="fn:concat(fn:substring-after(get-property('MessageID'), 'urn:uuid:'), '.xml')"
scope="transport"/>
<property name="OUT_ONLY" value="true"/>
<send>
<endpoint>
<address uri="vfs:smb2://username:password@host/SMBFileShare/out"/>
</endpoint>
</send>
</inSequence>
</target>
<parameter name="transport.PollInterval">15</parameter>
<parameter name="transport.vfs.FileURI">vfs:smb2://username:password@host/SMBFileShare/in</parameter>
<parameter name="transport.vfs.ContentType">text/plain</parameter>
<parameter name="transport.vfs.ActionAfterProcess">MOVE</parameter>
<parameter name="transport.vfs.MoveAfterFailure">vfs:smb2://username:password@host/SMBFileShare/fail</parameter>
<parameter name="transport.vfs.ActionAfterFailure">MOVE</parameter>
<parameter name="transport.vfs.FileNamePattern">.*\.txt</parameter>
<parameter name="transport.vfs.MoveAfterProcess">vfs:smb2://username:password@host/SMBFileShare/original</parameter>
</proxy>
Top