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<? extends Debuggee> debuggeeClass)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