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
|
/*******************************************************************************
* Copyright (c) 2009, 2018 Mountainminds GmbH & Co. KG and Contributors
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Brock Janiczak - initial API and implementation
*
*******************************************************************************/
package org.jacoco.ant;
import static java.lang.String.format;
import java.io.File;
import java.io.IOException;
import java.net.InetAddress;
import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.Task;
import org.jacoco.core.runtime.AgentOptions;
import org.jacoco.core.tools.ExecDumpClient;
import org.jacoco.core.tools.ExecFileLoader;
/**
* Ant task for remotely controlling an application that is running with the
* tcpserver output mode
*/
public class DumpTask extends Task {
private boolean dump = true;
private boolean reset = false;
private File destfile = null;
private String address = AgentOptions.DEFAULT_ADDRESS;
private int port = AgentOptions.DEFAULT_PORT;
private int retryCount = 10;
private boolean append = true;
/**
* Sets the location of the execution data file to write. This parameter is
* required when dump is <code>true</code>. Default is
* <code>jacoco.exec</code>
*
* @param destfile
* Location to write execution data to
*/
public void setDestfile(final File destfile) {
this.destfile = destfile;
}
/**
* IP Address or hostname to connect to. Defaults to <code>localhost</code>
*
* @param address
* IP Address or hostname to connect to
*/
public void setAddress(final String address) {
this.address = address;
}
/**
* Port number to connect to. Default is <code>6300</code>
*
* @param port
* Port to connect to
*/
public void setPort(final int port) {
this.port = port;
}
/**
* Number of retries which the goal will attempt to establish a connection.
* This can be used to wait until the target JVM is successfully launched.
*
* @param retryCount
* number of retries
*/
public void setRetryCount(final int retryCount) {
this.retryCount = retryCount;
}
/**
* <code>true</code> if the destination file it to be appended to.
* <code>false</code> if the file is to be overwritten
*
* @param append
* <code>true</code> if the destination file should be appended
* to
*/
public void setAppend(final boolean append) {
this.append = append;
}
/**
* Sets whether execution data should be downloaded from the remote host.
* Defaults to <code>true</code>
*
* @param dump
* <code>true</code> to download execution data
*/
public void setDump(final boolean dump) {
this.dump = dump;
}
/**
* Sets whether a reset command should be sent after the execution data has
* been dumped. Defaults to <code>false</code>
*
* @param reset
* <code>true</code> to reset execution data
*/
public void setReset(final boolean reset) {
this.reset = reset;
}
@Override
public void execute() throws BuildException {
if (port <= 0) {
throw new BuildException("Invalid port value", getLocation());
}
if (dump && destfile == null) {
throw new BuildException(
"Destination file is required when dumping execution data",
getLocation());
}
final ExecDumpClient client = new ExecDumpClient() {
@Override
protected void onConnecting(final InetAddress address,
final int port) {
log(format("Connecting to %s:%s", address,
Integer.valueOf(port)));
}
@Override
protected void onConnectionFailure(final IOException exception) {
log(exception.getMessage());
}
};
client.setDump(dump);
client.setReset(reset);
client.setRetryCount(retryCount);
try {
final ExecFileLoader loader = client.dump(address, port);
if (dump) {
log(format("Dumping execution data to %s",
destfile.getAbsolutePath()));
loader.save(destfile, append);
}
} catch (final IOException e) {
throw new BuildException("Unable to dump coverage data", e,
getLocation());
}
}
}
|
