The StringCodec/JStringCodec codec plug-ins read transport events as simple text strings and breaks them into fields, names and values, using delimiter strings supplied by configuration properties.

Events are assumed to have the following general format:

where <name> corresponds to the field name, followed by a delimiter character or string <sepA>, followed by the field's value, <value>. The complete <name> and <value> pair is then separated from another such sequence by a <sepB> delimiter. This pattern is assumed to repeat itself.

Fields with empty values are permitted. Because the terminator is optional, the codec will consume names and values up to the end of the input string if no terminator is found.

In order to load this plug-in, the <codecs> element in the adapter's configuration file must load the StringCodec library (this represents the filename of the library that implements the plug-in). Note that for the Java version, the full path to the plug-in's .jar file must be specified.

A configuration file for C/C++ would use this:

In a configuration file for Java:

The String codec plug-in takes the following properties:

All properties must be specified in the adapter configuration file.

For more information on specifying plug-ins in an adapter's configuration file, see Transport and codec plug-in configuration.

This is one of the sample plug-ins for which source code is available – see the IAF samples for more information.