1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one or more
3  * contributor license agreements.  See the NOTICE file distributed with
4  * this work for additional information regarding copyright ownership.
5  * The ASF licenses this file to You under the Apache License, Version 2.0
6  * (the "License"); you may not use this file except in compliance with
7  * the License.  You may obtain a copy of the License at
8  *
9  *     http://www.apache.org/licenses/LICENSE-2.0
10  *
11  *  Unless required by applicable law or agreed to in writing, software
12  *  distributed under the License is distributed on an "AS IS" BASIS,
13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  *
15  *  See the License for the specific language governing permissions and
16  *  limitations under the License.
17  */
18 
19 /**
20  * @author Vitaly A. Provodin
21  */
22 
23 /**
24  * Created on 31.01.2005
25  */
26 package org.apache.harmony.jpda.tests.share;
27 
28 import org.apache.harmony.jpda.tests.framework.LogWriter;
29 import org.apache.harmony.jpda.tests.framework.TestErrorException;
30 
31 /**
32  * All debuggee of unit tests must extend this class
33  */
34 public abstract class Debuggee {
35 
36     /**
37      * Instance of LogWriter implementation.
38      */
39     public LogWriter logWriter;
40 
41     /**
42      * Instance of JPDA options used in all JPDA/JDWP tests.
43      */
44     public JPDATestOptions settings;
45 
46     /**
47      * Executes main actions of debuggee. This method must be implemented by
48      * subclasses.
49      */
run()50     public abstract void run();
51 
52     /**
53      * Initializes debuggee
54      */
onStart()55     public void onStart() {
56         settings = new JPDATestOptions();
57         logWriter = new JPDALogWriter(System.out, null, settings.isVerbose());
58     }
59 
60     /**
61      * Executes final stage of debuggee.
62      */
onFinish()63     public void onFinish() {
64     }
65 
66     /**
67      * Starts debuggee specified by <code>debuggeeClass</code>.
68      *
69      * @param debuggeeClass
70      *            debuggee's class
71      */
runDebuggee(Class debuggeeClass)72     public static void runDebuggee(Class debuggeeClass) {
73         Debuggee debuggee = null;
74         try {
75             debuggee = (Debuggee) debuggeeClass.newInstance();
76         } catch (Exception e) {
77             throw new TestErrorException("Debuggee can not be started: "
78                     + debuggeeClass.getName(), e);
79         }
80 
81         debuggee.onStart();
82 
83         try {
84             debuggee.run();
85         } catch (Throwable e) {
86             debuggee.logWriter.printError(e);
87         } finally {
88             debuggee.onFinish();
89         }
90     }
91 }
92