1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
~~ Licensed to the Apache Software Foundation (ASF) under one
~~ or more contributor license agreements. See the NOTICE file
~~ distributed with this work for additional information
~~ regarding copyright ownership. The ASF licenses this file
~~ to you under the Apache License, Version 2.0 (the
~~ "License"); you may not use this file except in compliance
~~ with the License. You may obtain a copy of the License at
~~
~~ http://www.apache.org/licenses/LICENSE-2.0
~~
~~ Unless required by applicable law or agreed to in writing,
~~ software distributed under the License is distributed on an
~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
~~ KIND, either express or implied. See the License for the
~~ specific language governing permissions and limitations
~~ under the License.
Usage
The <<<tuscany-itest-plugin>>> is associated with the <<<integration-test>>> phase of the build lifecycle.
The plugin can be invoked directly from the command line:
+---+
mvn org.apache.tuscany.sca:tuscany-itest-plugin:test
+---+
or can be included in the build definition for your project:
+---+
<build>
<plugins>
<plugin>
<groupId>org.apache.tuscany.sca</groupId>
<artifactId>tuscany-itest-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>test</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
+---+
* Writing Integration Tests
Integration tests are written as JUnit TestCases (currently only JUnit 3.8.1 is supported but other frameworks
may be added later) that use SCA references to access services provided by the components under test. The
references are injected into your testcase before its setUp method is called (using constructor, setter or field
injection).
For example, to test a component that implemented the <<<MyService>>> interface you could write:
+---+
public class ServiceTestComponent extends TestCase {
@Reference
public MyService service;
public void testSomething() {
assertEquals(result, service.doSomething);
}
}
+---+
This TestCase is used as a component within a SCA composite that defines the test suite
as described in the next section. This separates TestCase's for normal unit tests from
those that are integration tests.
If any methods have an SCA <<<@Init>>> or <<<@Destroy>>> annotation they will be called
before and after executing tests; if no methods are annotated in this way the normal
JUnit <<<setUp>>> and <<<tearDown>>> methods will be called.
If the component's scope is <<<STATELESS>>> (the default), then a new instance of the
test component will used to run each test; if the component's scope is <<<COMPOSITE>>>
then a single instance will be used to run all tests. The scope can be set with the
standard SCA <<<@Scope>>> annotation.
* Defining an SCA Test Suite
The Test Suite for your integration tests is defined by an SCA composite file that contains
the test components written above wired to the production components for the application.
The test components must use an implementation type of <<< <tuscany:junit> >>>.
A simple way to achieve this is to use a SCDL <include> element to include the content of
production composite in the test harness; this gives the test components access to all of
the components and references in the production composite.
For example, the following SCDL configures the <<<ServiceTestComponent>>> above
to test the <<<MyServiceComponent>>> in the production composite <<<ProductionComposite>>>:
+---+
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/2.0-alpha"
name="PropertyTestHarnessComposite">
<include name="ProductionComposite" scdlResource="META-INF/sca/default.scdl"/>
<component name="testMyService">
<tuscany:junit class="ServiceTestComponent"/>
<reference name="service">MyServiceImpl</reference>
</component>
</composite>
+---+
Alternatively, the production composite can be tested as a black box by using it to
implement a component and wiring test components to it. This allows the externally
visible services to be tested without knowledge of the internals of the composite.
For example, the following SCDL tests the <<<ProductionComposite>>> in this way:
+---+
<composite xmlns="http://www.osoa.org/xmlns/sca/1.0"
xmlns:tuscany="http://tuscany.apache.org/xmlns/sca/2.0-alpha"
name="PropertyTestHarnessComposite">
<component name="ProductionComponent">
<implementation.composite name="ProductionComposite"
scdlResource="META-INF/sca/default.scdl"/>
</component>
<component name="testMyService">
<tuscany:junit class="ServiceTestComponent"/>
<reference name="service">ProductionComponent</reference>
</component>
</composite>
+---+
The location of this test composite definition can be specified using the <<<testScdl>>>
plugin configuration property; the default location is <<<${project.build.testOutputDirectory}/itest.scdl>>>
which allows the <<<itest.scdl>>> source file to be placed in the test resources (<<<src/test/resources>>>).
* Test Result Output
The test results are output using Surefire's reporting framework for integration with other test reports.
XML and test results are stored in the normal test output directory (<<<target/surefire-reports>>>) with
a summary displayed on the console:
+---+
[INFO] [tuscany-itest:test {execution: default}]
[INFO] Starting Tuscany...
[INFO] Deploying test SCDL from .../target/test-classes/itest.scdl
[INFO] Executing tests...
-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running testMyService
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.002 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] Stopping Tuscany...
+---+
|
