In this section:
Introduction
The File Transfer Listener monitors a specified local or shared directory. It detects new files in that directory and sends the content of those files as a request to the virtual asset that uses this listener. The virtual asset then passes the request to its responders. The matching responder provides a response for that request, then the File Transfer Listener writes the response to another directory. For example, this functionality could be used to simulate an application that listens to a file showing up within a specific directory, processes it, and then responds by placing a modified version of that file—or a different file— in another local or shared directory.
Requirements
- Virtualize 9.9.0 or later.
Installation
The listener can be installed from the UI or command line.
UI Installation
- Choose Parasoft > Preferences and select System Properties in the sidebar menu.
- Click Add JARs and choose the filetransferlistener.jar file in the file chooser.
- Restart Virtualize.
Command Line Installation
Add the filetransferlistener.jar file to the system.properties.classpath property in your localsettings properties file. For example:
system.properties.classpath=<path to jar>/filetransferlistener.jar
Usage
After installation, the File Transfer Listener will be available in the Transports> Custom tab of the Virtual Asset configuration panel. Double-click a virtual asset’s Virtualize Server node to open this panel.
If multiple custom listeners are available, you can select the one you want to use from the Select Implementation drop-down menu.
You can configure correlations, transformations, responses, etc. in the responders associated with the virtual asset.
Configuration
You configure the listener using the following options.
| Source Directory | Specify which local or shared directory you want to monitor for new files. You can enter an absolute path, a relative path (in relation to the VirtualAssets project), or a directory (for example, |
|---|---|
| Source Encoding | Specify the character encoding for the contents of the source file. The system default is used if this option is not specified. If the source file contains a recognized BOM (UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, UTF-32LE), it will be used to determine the character encoding. |
| Target Directory | Specify the local or shared directory to which you want files transferred. You can enter an absolute path, a relative path (in relation to the VirtualAssets project), or a directory (for example, \\file.parasoft.com\Development\tmp\user\OUT). |
| Target File Name | Specify the desired name for the transferred file. You can use variables such as %d (current date) %t (current time), %b (base filename without extension), and %e (extension). If this field is empty, the original file name will be used. |
| Poll Interval | Specify how frequently you want to check the specified directory. The default is 1000 milliseconds. |
| Log Level | Specify how much information you want logged to the console and the Event Monitoring view. The default is 2 (warn). |
Third-Party Content
This extension includes items that have been sourced from third parties as outlined below.
- Commons IO (Apache license)
Additional license details are available in this plugin's licenses folder.
