Skip to main content
Skip table of contents

Using Testable Classes

Example File (Builder project Testing Concepts):

<your example path>\Testing Concepts\uml\priceCalculation.xml

The priceCalculation example - an example performing a very simple calculation of price, quantity and exchange rate - contains a class CurrencyCalculator having one attribute (exchangeRate) and two class operations (calculatePrice and createCurrencyCalculator). By applying the stereotype <<E2ETestable>> to the class this class is marked as testable.

If the flag generateTestService on the service composite is set to true, the compiler will generate test SOAP services for all testable classes of the model.

By the following tagged values you can configure the test settings:

Tagged ValueDescriptionAllowed Values
generateTestService

Enables or disables testing.

If true, a test SOAP service will be generated for all <<E2ETestable>> classes.

truetest service generated
falseno test service generated
testEncoding

Defines the encoding of the test SOAP operations. rpc/soap is recommended, because this matches well with the semantics of UML operations.

If this value is set and other services of the composite have different encodings, the tag wsdlPerService must be set to true.

rpc/soapuse rpc/soap encoding (default)

doc/literal

use doc/literal encoding
testPort

Defines the number of the test service port.

any number (default: 55555)
testServiceName

Defines the name of the generated test service.

any string (default: E2ETestService)
testProxyHost

Specifies the deployment host.

any string (default: localhost)
testProxyProtocol

Specifies the used protocol.

HTTP or HTTPS.
testProxyPath

Specifies the part of the overall URL that is mapped to the actual host name and port.

If this tagged value is used, the modeler must ensure, that this value is unique within the proxy.

any string (default: <proxy URL>/<service host>/<configuration name>)
testProxyPort

Specifies the proxy port the test service is listening to.

any number (defaults: 80 (HTTP) and 443 (HTTPS))
externalTestProxyHost

Specifies the host name as seen by the client. If a server certificate is used, it must be issued for this name.If this value is not set, the name of the node hosting the proxy is being used.

any string

We recommend creating a separate service for all testable classes (e.g. TestingService) and to set the tagged value wsdlPerService to true on the <<E2EComposite>>. By that means, a mix-up between main and testing service is avoided. The testing features get a separate WSDL and a separate service entry on the Bridge and can be started and stopped within the Bridge by the Activation checkbox as needed.

Please note that the compiler will not generate test SOAP services for testable classes from imported modules.
Modules must be tested separately. Add a component diagram to the module in this case and test the classes from a deployed module service.

For more information on the Bridge and service preferences refer to the Integration (Bridge) User's Guide .

Once the class is part of the SOAP interface, it is possible to test all class operations with the xUML SOAP Test Tool (or any other SOAP test tool) and with the Analyzer. The testable class may even be part of regression tests defined with the Analyzer.
Within each test case, attributes of the testable class are addressed via the self context, so that all information relevant for the execution of the test case can be provided.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.