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
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
// serverAbstractThread.java
// -----------------------
// (C) by Michael Peter Christen; mc@anomic.de
// first published on http://www.yacy.net
// Frankfurt, Germany, 2005
// last major change: 14.03.2005
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
//
// This program 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 for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
//
// Using this software in any meaning (reading, learning, copying, compiling,
// running) means that you agree that the Author(s) is (are) not responsible
// for cost, loss of data or any harm that may be caused directly or indirectly
// by usage of this softare or this documentation. The usage of this software
// is on your own risk. The installation and usage (starting/running) of this
// software may allow other people or application to access your computer and
// any attached devices and is highly dependent on the configuration of the
// software which must be done by the user of the software; the author(s) is
// (are) also not responsible for proper configuration and usage of the
// software, even if provoked by documentation provided together with
// the software.
//
// Any changes to this file according to the GPL as documented in the file
// gpl.txt aside this file in the shipment you received can be done to the
// lines that follows this copyright notice here, but changes must not be
// done inside the copyright notive above. A re-distribution must contain
// the intact and unchanged copyright notice.
// Contributions and changes to the program code must be marked as such.
/*
an Implementation of a serverRunnable must only extend this class and impement
the methods:
open(),
job() and
close()
*/
package de.anomic.server;
public abstract class serverAbstractThread extends Thread implements serverThread {
private long startup = 0, idlePause = 0, busyPause = 0, blockPause = 0;
private boolean running = true;
private serverLog log = null;
private long idletime = 0, busytime = 0;
private String shortDescr = "", longDescr = "";
private long threadBlockTimestamp = System.currentTimeMillis();
private long idleCycles = 0, busyCycles = 0;
protected void announceThreadBlockApply() {
// shall only be used, if a thread blocks for an important reason
// like a socket connect and must renew the timestamp to correct
// statistics
this.threadBlockTimestamp = System.currentTimeMillis();
}
protected void announceThreadBlockRelease() {
// shall only be used, if a thread blocks for an important reason
// like a socket connect and must renew the timestamp to correct
// statistics
long thisBlockTime = (System.currentTimeMillis() - this.threadBlockTimestamp);
this.blockPause += thisBlockTime;
this.busytime -= thisBlockTime;
}
protected void announceMoreExecTime(long millis) {
this.busytime += millis;
}
protected void announceMoreSleepTime(long millis) {
this.idletime += millis;
}
public void setDescription(String shortText, String longText) {
// sets a visible description string
this.shortDescr = shortText;
this.longDescr = longText;
}
public void setStartupSleep(long milliseconds) {
// sets a sleep time before execution of the job-loop
startup = milliseconds;
}
public void setIdleSleep(long milliseconds) {
// sets a sleep time for pauses between two jobs
idlePause = milliseconds;
}
public void setBusySleep(long milliseconds) {
// sets a sleep time for pauses between two jobs
busyPause = milliseconds;
}
public String getShortDescription() {
return this.shortDescr;
}
public String getLongDescription() {
return this.longDescr;
}
public long getIdleCycles() {
// returns the total number of cycles of job execution with idle-result
return this.idleCycles;
}
public long getBusyCycles() {
// returns the total number of cycles of job execution with busy-result
return this.busyCycles;
}
public long getBlockTime() {
// returns the total time that this thread has been blocked so far
return this.blockPause;
}
public long getSleepTime() {
// returns the total time that this thread has slept so far
return this.idletime;
}
public long getExecTime() {
// returns the total time that this thread has worked so far
return this.busytime;
}
public void setLog(serverLog log) {
// defines a log where process states can be written to
this.log = log;
}
public void terminate(boolean waitFor) {
// after calling this method, the thread shall terminate
this.running = false;
// wait for termination
if (waitFor) while (this.isAlive())
try {this.sleep(100);} catch (InterruptedException e) {break;}
// If we reach this point, the process is closed
}
private void logError(String text) {
if (log == null)
serverLog.logError("THREAD-CONTROL", text);
else
log.logError(text);
}
private void logSystem(String text) {
if (log == null)
serverLog.logSystem("THREAD-CONTROL", text);
else
log.logSystem(text);
}
public void jobExceptionHandler(Exception e) {
// default handler for job exceptions. shall be overridden for own handler
logError("thread '" + this.getName() + "': " + e.toString());
e.printStackTrace();
}
public void run() {
if (startup > 0) {
// do a startup-delay
logSystem("thread '" + this.getName() + "' deployed, delaying start-up.");
ratz(startup);
if (!(running)) return;
}
this.open();
if (log != null) {
if (startup > 0)
logSystem("thread '" + this.getName() + "' delayed, " + ((this.busyPause < 0) ? "starting now job." : "starting now loop."));
else
logSystem("thread '" + this.getName() + "' deployed, " + ((this.busyPause < 0) ? "starting job." : "starting loop."));
}
int outerloop;
long innerpause;
long timestamp;
boolean isBusy;
while (running) {
try {
// do job
timestamp = System.currentTimeMillis();
isBusy = this.job();
busytime += System.currentTimeMillis() - timestamp;
// interrupt loop if this is supposed to be a one-time job
if ((this.idlePause < 0) || (this.busyPause < 0)) break; // for one-time jobs
// process scheduled pause
timestamp = System.currentTimeMillis();
ratz((isBusy) ? this.busyPause : this.idlePause);
idletime += System.currentTimeMillis() - timestamp;
if (isBusy) busyCycles++; else idleCycles++;
} catch (Exception e) {
// handle exceptions: thread must not die on any unexpected exceptions
// if the exception is too bad it should call terminate()
this.jobExceptionHandler(e);
busyCycles++;
}
}
this.close();
logSystem("thread '" + this.getName() + "' terminated.");
}
private void ratz(long millis) {
int loop = 1;
while (millis > 1000) {
loop = loop * 2;
millis = millis / 2;
}
while ((loop-- > 0) && (running)) {
try {this.sleep(millis);} catch (InterruptedException e) {}
}
}
public void open() {} // dummy definition; should be overriden
public void close() {} // dummy definition; should be overriden
}
|
