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
159
160
161
162
163
164
165
166
167
168
169
|
/*
Derby - Class org.apache.derbyTesting.functionTests.tests.compatibility._Suite
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.
*/
package org.apache.derbyTesting.functionTests.tests.compatibility;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import junit.framework.Test;
import org.apache.derbyTesting.junit.BaseJDBCTestCase;
import org.apache.derbyTesting.junit.BaseTestSuite;
import org.apache.derbyTesting.junit.Derby;
import org.apache.derbyTesting.junit.DerbyDistribution;
import org.apache.derbyTesting.junit.DerbyVersion;
import org.apache.derbyTesting.junit.SecurityManagerSetup;
import org.apache.derbyTesting.junit.ServerSetup;
import org.apache.derbyTesting.junit.TestConfiguration;
/**
* Runs a minimal set of compatibility tests aimed at discovering
* incompatibilities introduced in the latest development version (trunk).
* <p>
* Only combinations where trunk is the client or the server qualify for the
* MATS (Minimal Acceptance Test Suite), and only the latest releases from
* older branches are tested. For more coverage see
* {@link VersionCombinationConfigurator#getInstanceDevFull()}.
*/
public class _Suite
extends BaseJDBCTestCase {
/** Property for specifying versions to include. */
static final String INCLUDE_RELEASES =
"derby.tests.compat.includeReleases";
/** Property for specifying versions to exclude. */
static final String EXCLUDE_RELEASES =
"derby.tests.compat.excludeReleases";
/** Lazily set in {@linkplain #addVersionCombinations}, or by a subclass. */
protected static VersionCombinationConfigurator configurator;
/**
* Adds compatibility tests to the specified suite according to the
* current version combination configuration.
*
* @param suite the suite to add the tests to
* @return The number of tests added.
*/
private static int addVersionCombinations(BaseTestSuite suite) {
String include = getSystemProperty(INCLUDE_RELEASES);
String exclude = getSystemProperty(EXCLUDE_RELEASES);
List<DerbyVersion> toInclude = parseVersionList(include);
List<DerbyVersion> toExclude = parseVersionList(exclude);
if (configurator == null) {
// MATS = minimal acceptance test suite
configurator = VersionCombinationConfigurator.getInstanceDevMATS();
}
suite.setName("Compatibility suite, " + configurator.getName());
configurator.setIncludes(toInclude);
configurator.setExcludes(toExclude);
return configurator.addTests(suite);
}
/**
* Parses the list of version strings and returns a list of version objects.
* <p>
* <strong>NOTE</strong>: If invalid versions are found a warning is simply
* printed to the console.
*
* @param versions list of Derby versions, i.e '10.8.1.2,10.7.1.1'
* @return A list of parsed Derby versions.
*/
private static List<DerbyVersion> parseVersionList(String versions) {
if (versions == null || versions.length() == 0) {
return Collections.emptyList();
}
String[] vlist = versions.split(",");
List<DerbyVersion> ret = new ArrayList<DerbyVersion>(vlist.length);
for (String v : vlist) {
try {
ret.add(DerbyVersion.parseVersionString(v));
} catch (IllegalArgumentException iae) {
alarm("badly formatted version string: " + v);
}
}
return ret;
}
/** Don't use this. @see #suite() */
public _Suite(String name) {
super(name);
throw new IllegalStateException("invoke suite() instead");
}
/**
* Returns the default set of compatibility tests, intended to be run
* as part of suites.All.
*
* @return A default suite of compatibility tests.
*/
public static Test suite() {
// DERBY-5889: Disabling tests on Windows where the old releases are
// run off of UNC paths (network drives).
if (suffersFromDerby5889()) {
String msg = ("tests.compatibility disabled on Windows " +
"with UNC paths, see DERBY-5889");
println(msg);
return new BaseTestSuite(msg);
}
// DERBY-6610: the compatibility tests don't run with classes;
// return an empty suite rather than hit the IllegalStateException
// from VersionCombinationConfigurator.getJarDirectoryOf
if (!TestConfiguration.loadingFromJars())
return new BaseTestSuite("Compatibility tests skipped becasue " +
"they need to run from jars");
if (!Derby.hasClient() || !Derby.hasServer()) {
return new BaseTestSuite("Compatibility tests skipped because " +
"client or server is missing");
}
BaseTestSuite suite = new BaseTestSuite();
addVersionCombinations(suite);
TestConfiguration config = TestConfiguration.getCurrent();
return new SecurityManagerSetup(
new ServerSetup(suite, "localhost", config.getPort()),
// Need permission for getProtectionDomain to determine what
// to put on the classpath for the spawned process(es).
VersionCombinationConfigurator.class.getName().
replaceAll("\\.", "/") + ".policy",
true);
}
/**
* Tells if we are running in an environment that suffers from DERBY-5889.
* <p>
* Description: operating system is Windows and the old Derby releases are
* residing on an UNC path (network drive).
*/
public static boolean suffersFromDerby5889() {
if (!isWindowsPlatform()) {
return false;
}
DerbyDistribution[] dists =
TestConfiguration.getReleaseRepository().getDistributions();
for (int i=0; i < dists.length; i++) {
if (dists[i].getDerbyEngineJarPath().startsWith("\\\\")) {
return true;
}
}
return false;
}
}
|
