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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
/*
* Copyright (c) 2008, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package nsk.share.aod;
import java.io.*;
import nsk.share.*;
import nsk.share.jpda.SocketIOPipe;
/*
Class AODTestRunner is part of the framework used in the AttachOnDemand tests
(tests against Attach API, API from package com.sun.tools.attach).
AODTestRunner is used as main class in AttachOnDemand tests, it performs following
actions:
- starts target application
- finds VM id for target VM (this id is needed for dynamic attach)
- by default AODTestRunner tries to attach specified via command line agents to target VM
(subclasses can override this default behavior)
- waits for target application completion
Target application class, agents that should be attached, JDK used to run target application and
VM options passed to target VM should be specified via command line.
*/
public class AODTestRunner {
public static final String targetAppIdProperty = "vmsqe.aod.targetAppId";
public static final String appIdProperty = "vmsqe.aod.AppId";
public static final long TARGET_APP_CONNECT_TIMEOUT = 5 * 60 * 1000; // 5 min
public static final long TARGET_APP_WORK_TIMEOUT = 30 * 60 * 1000; // 30 min (standard VM testbase test timeout)
protected Log log;
protected SocketIOPipe pipe;
protected ProcessExecutor targetAppExecutor;
// target application ready for attach
public static final String SIGNAL_READY_FOR_ATTACH = "ready";
// target application may finish execution
public static final String SIGNAL_FINISH = "finish";
protected AODRunnerArgParser argParser;
protected AODTestRunner(String[] args) {
log = new Log(System.out, true);
argParser = createArgParser(args);
}
/*
* This method is introduced to let subclasses to create its own parsers
*/
protected AODRunnerArgParser createArgParser(String[] args) {
return new AODRunnerArgParser(args);
}
protected void doTestActions(String targetVMId) throws Throwable {
AgentsAttacher attacher = new AgentsAttacher(targetVMId, argParser.getAgents(), log);
attacher.attachAgents();
}
protected String getCurrentVMId() {
String currentVMId = "" + ProcessHandle.current().pid();
log.display("Current VM id was identified: " + currentVMId);
return currentVMId;
}
protected void runTest() {
try {
String targetAppId = System.getProperty(targetAppIdProperty);
if(targetAppId == null || targetAppId.isEmpty()) {
// use PID as default appID
targetAppId = "" + ProcessHandle.current().pid();
}
/*
* Create target application id required by the Utils.findVMIdUsingJPS
*/
String targetAppCmd =
// path to java
argParser.getTestedJDK() + File.separator + "bin" + File.separator + "java " +
// VM property to identify VM running target application
"-D" + appIdProperty + "=" + targetAppId + " " +
// VM opts
argParser.getJavaOpts() + " -XX:+EnableDynamicAgentLoading " +
// target application class
argParser.getTargetApp() + " " +
// additional target application parameter - number of
// agents that will be attached
"-" + AODTargetArgParser.agentsNumberParam + " " + argParser.getAgents().size();
pipe = SocketIOPipe.createServerIOPipe(log, 0, TARGET_APP_CONNECT_TIMEOUT);
targetAppCmd += " -" + AODTargetArgParser.socketPortParam + " " + pipe.getPort();
log.display("Starting target application: " + targetAppCmd);
targetAppExecutor = new ProcessExecutor(targetAppCmd, TARGET_APP_WORK_TIMEOUT, "TargetApp");
targetAppExecutor.startProcess();
/*
* Don't try to attach agents until target application isn't initialized
*/
String signal = pipe.readln();
log.display("Signal received: '" + signal + "'");
if ((signal == null) || !signal.equals(SIGNAL_READY_FOR_ATTACH))
throw new TestBug("Unexpected TargetApplication signal: '" + signal + "'");
String targetVMId = Long.toString(targetAppExecutor.pid());
log.display("Target VM id was identified: " + targetVMId);
doTestActions(targetVMId);
/*
* When test actions finished let target application finish execution
*/
log.display("Sending signal: '" + SIGNAL_FINISH + "'");
pipe.println(SIGNAL_FINISH);
targetAppExecutor.waitForProcess();
File file = new File(targetAppId);
if (file.exists()) {
file.deleteOnExit();
}
if (targetAppExecutor.getExitCode() != 0) {
throw new Failure("Target application finished with non-zero code " + targetAppExecutor.getExitCode());
}
postTargetExitHook();
} catch (Failure f) {
throw f;
} catch (Throwable t) {
throw new Failure("Unexpected exception during test execution: " + t, t);
} finally {
if (pipe != null) {
pipe.close();
}
if (targetAppExecutor != null) {
targetAppExecutor.destroyProcess();
}
}
}
/*
* Allow users of this class to specify actions to be taken after the target exits
*/
protected void postTargetExitHook() {
// do nothing by default
}
public static String createApplicationId() {
return new Long(System.currentTimeMillis()).toString();
}
public static void main(String[] args) {
new AODTestRunner(args).runTest();
}
}
|
