RvTest uses a RvFixture to define a test. A RvFixture is defined by composed of a name, stimuli, responses, and additional data. Once an RvFixture is defined it can be executed using the testing framework.
Test fixtures are loaded by a Java test case and are specified using a URI.
| Fixture Format | URI Scheme | URI Locator | Description |
|---|---|---|---|
| XML Fixture | xmlfile | path to fixture file | This defines a test fixture and should conform to the xml fixture schema. |
| Load Test Fixture | loadtest | path to fixture file | Use this to specify a RV Load Test. |
| Custom RvFixture | class | Fully qualified class name | The class creator constructs concrete implementations of the interface RvFixture. |
When specifying a URI the scheme and locator are combined. For
example xmlfile://mytestfixture.xml.
Stimuli contain any number of Stimulus nodes and are used to drive an RV test fixture. A Stimulus represents one or more TibRv messages that should be sent as part of a test fixture.
Each fixture defines a series of Responses. The test fixture uses these as reference messages and performs a comparison between the actual and expected messages. This comparison is configurable.
Each Response specified in a test fixture represents a messages that the test expects to receive. After the recording window has closed the expected messages are compared to the messages received. Each Response is specified with a comparison method which determines how this comparison works.
| Comparison Method | Descriptions |
|---|---|
| EQUALS | This method will require that the message received is exactly the same as the expected. This involves a RV Field comparison for each expected field. If the actual message is missing a field or has an unexpected field the comparsion fails. For XML Messages XMLUnit is used to compare the messages. |
| EQUALSIGNORE | This method will perform a comparison of the message where es all expected fields are validated. However if ignoredFields are specified then their content will not be validated. For XML Messages XPath expressions are used to specify the ignored fields. |
| NONE | This method performs no validation of the message received. Using this comparison will only validate that the correct number of messages were received on the response subject. |