RAW

From Commander4j
Revision as of 12:17, 1 April 2026 by Dgarratt (talk | contribs) (Updated by push_wiki.py)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The RAW connector copies or moves files from one location to another without any format conversion, transformation, or interpretation of the file contents. Unlike other connectors, it does not convert the file into an internal XML representation — the bytes are passed through unchanged.

When to Use RAW

Use the RAW connector when you need to:

  • Transfer files between directories or network shares without modifying them
  • Monitor a remote file share and pull files to a local directory for processing by another application
  • Replicate files to multiple destinations simultaneously
  • Move large or binary files efficiently (no XML overhead)

Because RAW bypasses the XML conversion step, it uses significantly less memory and CPU than other connector types — making it the right choice whenever transformation is not required.

Input Configuration

<input>
  <id>in1</id>
  <type>RAW</type>
  <url>
    <path>./interface/input/Map07 RAW to RAW</path>
    <mask/>
    <pollingInterval>5000</pollingInterval>
  </url>
</input>

No XSLT stylesheet can be applied to a RAW input, as the file is not converted to XML.

Output Configuration

<output>
  <id>out1</id>
  <type>RAW</type>
  <url>
    <path>./interface/output/Map07 RAW to RAW</path>
  </url>
</output>

Multiple Output Paths

The output path can include multiple destinations separated by semicolons. The file will be written to all specified paths:

<path>./interface/output/Map07 Path1;./interface/output/Map07 Path2;\\server\share\output</path>

Notes

  • No XSLT transformation is possible with RAW connectors — the data is not parsed.
  • The RAW connector supports UNC network paths (\\server\share\path) as well as local paths, making it suitable for file distribution across a network.
  • Polling interval can be set longer than other connector types (e.g. 5000 ms) since RAW operations are lightweight.

See also: Connectors, Maps, Overview_Middleware4j