Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<p>This page discusses <table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=INLINE" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUlOTElORX0&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>how to test Web Services using Groovy directly and in conjunction with WebTest and SoapUI</p></td></tr></table>.</p>

<p>Testing Web Services can be done in several ways. Here are three:</p>
<ul>
	<li>act like a normal web services client and perform asserts on the returned result</li>
	<li>use <a href="http://webtest.canoo.com">WebTest</a> (with either the XML or Groovy syntax)</li>
	<li>use <a href="http://soapui.org">SoapUI</a> (for functional and load testing)</li>
</ul>

<p>We are going to use the Web Service example at:</p>

<p> <a href="http://groovy.codehaus.org/Groovy+SOAP">http://groovy.codehaus.org/Groovy+SOAP</a></p>

<h2>Being a client</h2>

<p>You can be a normal client web service client and perform asserts on the returned results:</p>
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
import groovy.net.soap.SoapClient

def proxy = new SoapClient("http://localhost:6980/MathServiceInterface?wsdl")

def result = proxy.add(1.0, 2.0)
assert (result == 3.0)

result = proxy.square(3.0)
assert (result == 9.0)
</pre></td></tr></table>

<h2>Using WebTest</h2>

<p>Using the WebTest variations makes sense if you are combining your tests into an acceptance test suite.</p>

<p>Here is how you would test it using traditional WebTest:</p>
<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;steps>
    &lt;invoke method="POST" contentFile="addreq.xml" soapAction=""
        url="http://localhost:6980/MathServiceInterface"/>
    &lt;verifyXPath xpath="//addResponse/out[ text()='3.0' ]"/>
    &lt;invoke method="POST" contentFile="squarereq.xml" soapAction=""
        url="http://localhost:6980/MathServiceInterface"/>
    &lt;verifyXPath xpath="//squareResponse/out[ text()='9.0' ]"/>
&lt;/steps>
</pre></td></tr></table>
<p>Where addreq.xml would look something like:</p>
<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;?xml version='1.0' encoding='UTF-8'?>
&lt;soap:Envelope
        xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    &lt;soap:Body>
        &lt;add xmlns="http://DefaultNamespace">
            &lt;in0 xmlns="http://DefaultNamespace">1.0&lt;/in0>
            &lt;in1>2.0&lt;/in1>
        &lt;/add>
    &lt;/soap:Body>
&lt;/soap:Envelope>
</pre></td></tr></table>
<p>and squarereq.xml would look something like:</p>
<table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;?xml version='1.0' encoding='UTF-8'?>
&lt;soap:Envelope
        xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    &lt;soap:Body>
        &lt;square xmlns="http://DefaultNamespace">
            &lt;in0 xmlns="http://DefaultNamespace">3.0&lt;/in0>
        &lt;/square>
    &lt;/soap:Body>
&lt;/soap:Envelope>
</pre></td></tr></table>
<p>Alternatively, testing using groovy within WebTest would look like:</p>
<table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>
&lt;steps>
    &lt;groovy>
        import groovy.net.soap.SoapClient

def proxy = new SoapClient("http://localhost:6980/MathServiceInterface?wsdl")

def result = proxy.add(1.0, 2.0)
        assert (result == 3.0)

result = proxy.square(3.0)
        assert (result == 9.0)
    &lt;/groovy>
&lt;/steps>
</pre></td></tr></table>
<p>Note: you will need to place the jars mentioned on that page in your webtest lib directory (i.e. groovysoap, stax, jaf and mail jars) when using this variation.</p>

<p>The first approach (traditional webtest) produces more information in the test summary reporting but requires you to do more work (i.e. keep the requests around as XML). It depends if you already have those XML files around for other purposes, e.g. manual testing.</p>

<h2>Using SOAPUI</h2>

<p><a href="http://soapui.org/">soapui</a> is a SOAP functional and load testing tool. It can use Groovy steps within its testcases. For further details, see the soapui documentation for the <a href="http://soapui.org/userguide/functional/groovystep.html">Groovy Step</a>. This step supports data-driven tests, allows control of test execution and allows customised reporting.</p>

<p><img class="confluence-embedded-image" src="/download/attachments/231080033/screenshot_soapui.gif?version=1&amp;modificationDate=1369248628028" data-image-src="/download/attachments/231080033/screenshot_soapui.gif?version=1&amp;modificationDate=1369248628028" data-linked-resource-id="231375273" data-linked-resource-type="attachment" data-linked-resource-default-alias="screenshot_soapui.gif" data-base-url="http://docs.codehaus.org" data-linked-resource-container-id="231080033" title="null > screenshot_soapui.gif"></p>