15f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes/* 25f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * Licensed to the Apache Software Foundation (ASF) under one or more 35f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * contributor license agreements. See the NOTICE file distributed with 45f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * this work for additional information regarding copyright ownership. 55f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * The ASF licenses this file to You under the Apache License, Version 2.0 65f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * (the "License"); you may not use this file except in compliance with 75f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * the License. You may obtain a copy of the License at 85f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 95f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * http://www.apache.org/licenses/LICENSE-2.0 105f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 115f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * Unless required by applicable law or agreed to in writing, software 125f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * distributed under the License is distributed on an "AS IS" BASIS, 135f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 145f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 155f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * See the License for the specific language governing permissions and 165f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * limitations under the License. 175f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 185f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 195f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes/** 205f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @author Vitaly A. Provodin 215f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 225f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 235f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes/** 245f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * Created on 26.01.2005 255f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 265f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughespackage org.apache.harmony.jpda.tests.framework; 275f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 285f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes/** 295f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * This class represents debuggee VM on debugger side. 305f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * <p> 315f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * This abstract class defines a set of commands to control debuggee VM. 325f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * To provide the safely start up and shoot down of debuggee, an instance of 335f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * <code>DebuggeeWrapper</code> should be registered in <code>DebuggeeRegister</code>. 345f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 355f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @see DebuggeeRegister 365f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 375f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughespublic abstract class DebuggeeWrapper { 385f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 395f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes protected TestOptions settings; 405f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes protected LogWriter logWriter; 415f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 425f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 435f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * Creates an instance of <code>DebuggeeWrapper</code>. 445f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 455f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @param settings specifies parameters for debuggee start 465f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @param logWriter provides unified facilities for logging 475f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 485f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public DebuggeeWrapper(TestOptions settings, LogWriter logWriter) { 495f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes super(); 505f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes this.settings = settings; 515f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes this.logWriter = logWriter; 525f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes } 535f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 545f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 555f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * An implementation of this method must initiate the debuggee to start. 565f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 575f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public abstract void start(); 585f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 595f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 605f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * An implementation of this method must cause the debuggee to stop. 615f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 625f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public abstract void stop(); 635f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 645f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 655f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * An implementation of this method must cause the debuggee to exit 665f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * with specified <code>exitStatus</code> . 675f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 685f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @param exitStatus 695f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 705f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public abstract void exit(int exitStatus); 715f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 725f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 735f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * An implementation of this method must cause the debuggee to resume. 745f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 755f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public abstract void resume(); 765f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 775f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 785f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * An implementation of this method must cause the debuggee to dispose. 795f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 805f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public abstract void dispose(); 815f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes 825f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes /** 835f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * Return associated logWriter object. 845f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * 855f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes * @return associated logWriter 865f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes */ 875f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes public LogWriter getLogWriter() { 885f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes return logWriter; 895f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes } 905f0a23683aa603d8c50b6dd071a565821b76067bElliott Hughes} 91