Applies to ReadyAPI 3.5, last modified on December 29, 2020

PluginTestAssertion adds a new assertion for validating messages in functional and load tests.

Property Description
id A unique identifier for this Assertion type
label The name for the type of the assertion
description The description of the assertion
category The category the assertion belongs to.
Available categories are defined in AssertionCategoryMapping

The annotated class must extend the WsdlMessageAssertion class and implement the RequestAssertion interface and/or the ResponseAssertion interface.


Sample Assertion

package com.smartbear.ready.plugin.template.factories;

import com.eviware.soapui.config.TestAssertionConfig;
import com.eviware.soapui.impl.wsdl.panels.assertions.AssertionCategoryMapping;
import com.eviware.soapui.impl.wsdl.TestSteps.WsdlMessageAssertion;
import com.eviware.soapui.model.iface.MessageExchange;
import com.eviware.soapui.model.iface.SubmitContext;
import com.eviware.soapui.model.testsuite.Assertable;
import com.eviware.soapui.model.testsuite.AssertionError;
import com.eviware.soapui.model.testsuite.AssertionException;
import com.eviware.soapui.model.testsuite.ResponseAssertion;
import com.eviware.soapui.plugins.auto.PluginTestAssertion;
import com.eviware.soapui.support.StringUtils;
import net.sf.json.JSONSerializer;

@PluginTestAssertion(id = "SampleTestAssertionId", label = "Sample JSON Content Assertion",
category = AssertionCategoryMapping.VALIDATE_RESPONSE_CONTENT_CATEGORY,
description = "Asserts that the response message is a valid JSON string")

public class SampleTestAssertion extends WsdlMessageAssertion implements ResponseAssertion {

* Assertions need to have a constructor that takes TestAssertionConfig and ModelItem to be asserted

public SampleTestAssertion(TestAssertionConfig assertionConfig, Assertable modelItem) {
super(assertionConfig, modelItem, true, false, false, true);

protected String internalAssertResponse(MessageExchange messageExchange, SubmitContext submitContext) throws AssertionException {

try {
String content = messageExchange.getResponse().getContentAsString();
if (StringUtils.isNullOrEmpty(content)) {
return "Response is empty – not a valid JSON response";

} catch (Exception e) {
throw new AssertionException(new AssertionError("JSON Parsing failed; [" + e.toString() + "]"));

return "Response is valid JSON";

See Also

Test Objects

Highlight search results