uk.ac.sheffield.vtts.ground

Class JaxWsGrounding

java.lang.Object

uk.ac.sheffield.vtts.ground.AbstractGrounding

uk.ac.sheffield.vtts.ground.JaxWsGrounding

All Implemented Interfaces:

Grounding

public class JaxWsGrounding
extends AbstractGrounding

JaxWsGrounding assumes that the tested artifact is a SOAP web service that was created using JAX-WS. The service implementation may have been created bottom-up starting with the annotated Java service, from which the WSDL was generated (using JAX-WS wsgen); or top-down starting with the WSDL and generating the service resource classes (using JAX-WS wsimport). We then assume that a Java client is created from the WSDL (using JAX-WS wsdl2java). This creates two entities, a client implementation and a service interface, against which all service calls are made. The names of the interface methods must match the names used in the original service specification. If full testing of visited states and exercised transitions is requested, the SUT must provide two additional methods getState() and getScenario(). A JaxWsGrounding is supplied at creation with the PrintWriter to use for streaming the output. It is possible to set the name of the target package (for the Test Driver class) and the source packages (for the JAX-WS client implementation, service interface and any further user-defined parameters).

Version:

Broker@Cloud 1.0

Author:

Raluca Lefticaru

Field Summary

Fields inherited from class uk.ac.sheffield.vtts.ground.AbstractGrounding

dependency, metaCheck, stepIndex, testIndex, writer

Constructor Summary

Constructors

Constructor and Description
JaxWsGrounding(java.io.PrintWriter stream) Creates a JaxWsGrounding writing to a stream.

Method Summary

Methods

Modifier and Type	Method and Description
void	groundTestSequence(TestSequence sequence) Translates one abstract TestSequence into a JUnit test-method.
void	groundTestStep(TestStep testStep) Translates one abstract TestStep into Java set-up and evaluation code.
void	groundTestSuite(TestSuite testSuite) Translates an abstract TestSuite into a grounded suite of tests.
protected void	writeClassComment(TestSuite testSuite) Prints out a class-level comment for the JUnit test driver class source file.
protected void	writeDriverFields(TestSuite testSuite) Prints out the private attributes used by the JUnit Test Driver class.
protected void	writeInitialTestStep(TestStep testStep) Optionally prints out an assertion check on the result of the set-up code that created the service.
protected void	writeNormalTestStep(TestStep testStep) Prints out a method invocation expecting a normal return value.
protected void	writePackageInfo(TestSuite testSuite) Prints out package information at the head of the generated JUnit test driver class source file.
protected void	writeSystemSetUp(TestSuite testSuite) Prints out the set-up method for creating the System-Under-Test.

Methods inherited from class uk.ac.sheffield.vtts.ground.AbstractGrounding

setMetaCheck, useEndpoint, useSourcePackage, useTargetPackage, writeDriverConstructor, writeFactoryValue, writeFailureTestStep, writeInputList, writeJavaType, writeJavaValue, writeLiteralValue, writeMetaDataAssertions, writeMethodComment, writeOutputList, writeResultAssertions, writeResultVariables, writeVoidAssertion

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JaxWsGrounding

public JaxWsGrounding(java.io.PrintWriter stream)

Creates a JaxWsGrounding writing to a stream. By default, the target package is the default (unnamed) Java package.

Parameters:

stream - the output stream.

Method Detail

groundTestSuite

public void groundTestSuite(TestSuite testSuite)

Translates an abstract TestSuite into a grounded suite of tests.

Parameters:

testSuite - the abstract TestSuite.

groundTestSequence

public void groundTestSequence(TestSequence sequence)

Translates one abstract TestSequence into a JUnit test-method. Each test-method is styled "void testN() {...}", where N is the index of the TestSequence in the TestSuite. Each method is prefixed by "@Test" and has a body consisting of set-up and evaluation test steps. Thereafter, visits each TestStep to generate the method body.

Parameters:

sequence - the high-level test sequence.

groundTestStep

public void groundTestStep(TestStep testStep)

Translates one abstract TestStep into Java set-up and evaluation code. The first TestStep in a TestSequence translates into a creation step, which instantiates the SUT. Subsequent TestSteps translate into method calls on the SUT's interface. Methods that return results store these in variables of the given types, which are named according to the names of the Outputs, in the style "outputN", where N is the index of the TestStep in the TestSequence. If a TestStep is validated, generates code to compare the actual result(s) with the expected result(s) and invokes additional methods to query the state of the metadata.

Parameters:

testStep - the high-level test step.

writePackageInfo

protected void writePackageInfo(TestSuite testSuite)

Prints out package information at the head of the generated JUnit test driver class source file. If a target package was set, prints this out first; then prints the standard JUnit imports; then prints out any other Java package imports.

Parameters:

testSuite - the TestSuite.

writeDriverFields

protected void writeDriverFields(TestSuite testSuite)

Prints out the private attributes used by the JUnit Test Driver class. These field declarations store the JAX-WS interface to the service, the JAX-WS implementation of the service client and optionally a JavaFactory, if the TestSuite requires it.

Parameters:

testSuite - the TestSuite.

writeSystemSetUp

protected void writeSystemSetUp(TestSuite testSuite)

Prints out the set-up method for creating the System-Under-Test. This is a @Before method that resets the JAX-WS client before each test method.

Parameters:

testSuite - the test suite.

writeClassComment

protected void writeClassComment(TestSuite testSuite)

Prints out a class-level comment for the JUnit test driver class source file. This includes the name of the test driver and the date it was created. Prints out the test conditions under which the file was generated.

Parameters:

testSuite - the TestSuite.

writeInitialTestStep

protected void writeInitialTestStep(TestStep testStep)

Optionally prints out an assertion check on the result of the set-up code that created the service. This should only be done once, if this TestStep is to be verified.

Parameters:

testStep - the TestStep.

writeNormalTestStep

protected void writeNormalTestStep(TestStep testStep)

Prints out a method invocation expecting a normal return value. If this TestStep is to be verified, prints out variables to receive the return value(s) and adds assertion checks to compare expected with actual results.

Parameters:

testStep - the TestStep to be translated.