uk.ac.sheffield.vtts

Class GroundTests

java.lang.Object

uk.ac.sheffield.vtts.GroundTests

public class GroundTests
extends java.lang.Object

Program that reads a high-level test suite and generates an executable JUnit test driver. Use this program to ground high-level tests supplied in a technology-neutral format, converting these into a specific concrete executable format that is appropriate for a given service implementation technology. We provide three translations, as a demonstration of how to build your own. One option generates a JUnit driver for a POJO service; another generates a JUnit driver for a JAX-WS SOAP service; and the third option generates a JUnit driver for a JAX-RS REST service. All use JUnit as the mechanism to run the concrete tests. There is an option to include or exclude full state and transition checking, if the tested service exposes this information in test-mode. Requires ASTReader, ASTError, NodeError from the JAST package.

Version:

Broker@Cloud 1.0

Author:

Raluca Lefticaru, Anthony J H Simons

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLIENT_PACKAGE_PATH The client package path in your Java IDE (Eclipse or NetBeans, etc).
static java.lang.String	DEFAULT_REST_URI The default dummy URI for a RESTful web service.
static java.lang.String	SOURCE_CODE_ROOT The root source directory in your Java IDE (Eclipse or NetBeans, etc).
static java.lang.String	TEST_PACKAGE_PATH The test package path in your Java IDE (Eclipse or NetBeans, etc).

Constructor Summary

Constructors

Constructor and Description
GroundTests()

Method Summary

Methods

Modifier and Type	Method and Description
static void	main(java.lang.String[] args) Reads a high-level XML test suite from the input file and, if no errors are found, generates an output file containing the source code for a JUnit test driver, using the grounding parameter to select a particular grounding strategy, and the meta-check parameter to indicate whether to generate extra service calls to verify full state and transition behaviour.

Methods inherited from class java.lang.Object

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

Field Detail

SOURCE_CODE_ROOT

public static java.lang.String SOURCE_CODE_ROOT

The root source directory in your Java IDE (Eclipse or NetBeans, etc). This is by default the directory "src" which sits under the top-level project directory in your Java IDE. Edit this constant, if you expect your Java packages to live somewhere else; otherwise all Java package names are presumed to correspond to a directory structure under this root directory.

CLIENT_PACKAGE_PATH

public static java.lang.String CLIENT_PACKAGE_PATH

The client package path in your Java IDE (Eclipse or NetBeans, etc). This is by default the package "uk.ac.sheffield.vtts.client", which sits under the root source directory in your Java IDE. Sub-packages of this are used to store Java clients for web services.

TEST_PACKAGE_PATH

public static java.lang.String TEST_PACKAGE_PATH

The test package path in your Java IDE (Eclipse or NetBeans, etc). This is by default the package "uk.ac.sheffield.vtts.test", which sits under the root source directory in your Java IDE. Sub-packages of this are used to store generated JUnit test-drivers for web services.

DEFAULT_REST_URI

public static java.lang.String DEFAULT_REST_URI

The default dummy URI for a RESTful web service. This is provided for demonstration purposes only, so that REST test-drivers may refer to a URI for the REST service that they test. Edit this constant, if you wish to test REST services on a particular REST server; or supply a URI as a command-line argument.

Constructor Detail

GroundTests

public GroundTests()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException,
                        java.lang.IllegalArgumentException,
                        org.jast.ast.ASTError,
                        org.jast.ast.NodeError,
                        SemanticError

Reads a high-level XML test suite from the input file and, if no errors are found, generates an output file containing the source code for a JUnit test driver, using the grounding parameter to select a particular grounding strategy, and the meta-check parameter to indicate whether to generate extra service calls to verify full state and transition behaviour. By default, generated code is placed in one of the standard packages: uk.ac.sheffield.vtts.test.pojo, uk.ac.sheffield.vtts.test.ws, or uk.ac.sheffield.vtts.test.rs, according to the grounding. If optional package-name arguments are supplied, these are assumed to be (1st) the target package for the generated JUnit driver, and (2nd-nth) source packages containing the Java service client and other definitions. All of these packages are then presumed to exist in an IDE, under a root source code directory, SOURCE_ROOT (by default "src"). If a REST service is to be tested, the optional parameters must also include a REST URI name, starting with "http". The high-level test suite may define a preferred grounding and value for meta-check; otherwise these values must be supplied.

Parameters:

args - the XML high-level test suite file, containing a root TestSuite node; and optionally, a concrete grounding format chosen from: "Java" | "JAX-WS" | "JAX-RS" ("Java", by default), a boolean meta-check flag indicating whether to verify all states and transitions (true, by default); and after these, an optional service URI (needed for REST grounding only) and 0..n Java package names in which the generated test driver, and sources for the tested service client, are to be found (the URI is distinguished by its "http" prefix; and any package names are processed in order, with the first package assumed to be the target package and further packages assumed to be source packages).

Throws:

java.io.IOException - if a file system related I/O error occurs.

java.lang.IllegalArgumentException - if an invalid argument is supplied.

org.jast.ast.ASTError - if an XML syntax error is found in the input.

org.jast.ast.NodeError - if marshalling or unmarshalling the model fails.

SemanticError - if a semantic error is detected in the model.