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 */
26package org.apache.harmony.jpda.tests.share;
27
28import org.apache.harmony.jpda.tests.framework.LogWriter;
29import org.apache.harmony.jpda.tests.framework.TestErrorException;
30
31/**
32 * All debuggee of unit tests must extend this class
33 */
34public 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     */
50    public abstract void run();
51
52    /**
53     * Initializes debuggee
54     */
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     */
63    public void onFinish() {
64    }
65
66    /**
67     * Starts debuggee specified by <code>debuggeeClass</code>.
68     *
69     * @param debuggeeClass
70     *            debuggee's class
71     */
72    public static void runDebuggee(Class<? extends Debuggee> debuggeeClass) {
73        Debuggee debuggee = null;
74        try {
75            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