Unit Test Harness. This is a Java codec that is useful for unit testing your plug-ins in isolation, by writing messages from the chain to a text file, and/or sending test messages into the chain from a text file (in either direction) without the need to use or configure the host or transport at either end of the chain.Null Transport. This is a trivial Java transport that does not send any messages towards the host and ignores any messages received from the host direction. If you are unit-testing a codec plug-in, no sending or receiving functionality is required for the transport. However, as a transport needs to exist at the end of a connectivity chain, you should use the Null Transport as the chain's transport.Configuration option | Description |
pluginUnderTest | Required. Either towardsTransport or towardsHost, indicating which direction the plug-in being tested is along the chain relative to this unitTestHarness instance. Messages from the readFrom file are sent down the chain towards the direction identified by pluginUnderTest, and messages received from that direction of the chain (that is, that were sent towards the opposite of the pluginUnderTest direction) are written to the writeTo file. For example, a chain might have the host plug-in followed by a unitTestHarness with pluginUnderTest=towardsTransport followed by a codec plug-in that you are testing, followed by a unitTestHarness with pluginUnderTest=towardsHost followed by a nullTransport instance. |
writeTo | The path of a UTF-8 text file to which messages from the plug-in under test are written. If empty, no messages are written to a text file. Default: empty. |
readFrom | The path of a UTF-8 text file from which messages are read and sent towards the plug-in under test, or a directory containing such text files. When this plug-in is started, messages are read from the file and sent towards the plug-in under test. If a directory is specified, then the same is done for any new files in that directory, including any files that are subsequently written to that directory while the plug-in is running. If empty, no messages are sent by the unitTestHarness. Default: empty. |
logOutput | By default, the unitTestHarness writes a single-line log message to the host's log file for each message from the plug-in under test, using the same format as writeTo. This may be useful as an alternative to writeTo, or as a way to create test cases that block until either the host log file contains the final expected message or an error message. If you want to disable this behavior because the log file is becoming too large, then set this to false. Default: true. |
passThrough | By default, any messages received by the unitTestHarness are not passed on to the next plug-in in the chain (typically the transport or the host), as usually writing or logging the messages is all that is required and passing them on would require extra configuration in the host or transport to avoid error messages. If you want to include the host or transport in your testing, then set this to true. Default: false. |
echoBack | If set to true, messages received from the plug-in under test are automatically sent back in the opposite direction towards the plug-in under test. This is useful for testing the round-trip mapping behavior of a codec plug-in. Default: false. |
Any message payload except for byte[] can be encoded using as a single-line JSON string. For example:Although JSON can be used to represent simple string payloads, it is sometimes simpler to use payload_string format for these as it removes the need to follow JSON quoting rules. For example:For binary payloads (that is, a message whose payload is a byte array), use payload_byte[], which takes a base64-encoded representation of binary data. For example: