Home | History | Annotate | Download | only in jdwp 
      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 Aleksey V. Yantsen
     21  */
     22 
     23 /**
     24  * Created on 10.25.2004
     25  */
     26 package org.apache.harmony.jpda.tests.framework.jdwp;
     27 
     28 import org.apache.harmony.jpda.tests.framework.DebuggeeWrapper;
     29 import org.apache.harmony.jpda.tests.framework.LogWriter;
     30 import org.apache.harmony.jpda.tests.framework.TestErrorException;
     31 import org.apache.harmony.jpda.tests.framework.TestOptions;
     32 import org.apache.harmony.jpda.tests.framework.jdwp.TransportWrapper;
     33 import org.apache.harmony.jpda.tests.framework.jdwp.VmMirror;
     34 
     35 /**
     36  * This class represents specific kind of <code>DebuggeeWrapper</code> for JDWP tests.
     37  * It encapsulates JDWP connection and communicates with debuggee using
     38  * command, reply, and event packets.
     39  */
     40 public abstract class JDWPDebuggeeWrapper extends DebuggeeWrapper {
     41 
     42     public VmMirror vmMirror;
     43 
     44     /**
     45      * Creates an instance of JDWPDebuggeeWrapper.
     46      *
     47      * @param settings test run options
     48      * @param logWriter logWriter for messages
     49      */
     50     public JDWPDebuggeeWrapper(TestOptions settings, LogWriter logWriter) {
     51         super(settings, logWriter);
     52         vmMirror = createVmMirror(settings, logWriter);
     53     }
     54 
     55     /**
     56      * Creates new instance of appropriate TransportWrapper.
     57      *
     58      * @return new instance of TransportWrapper
     59      */
     60     public TransportWrapper createTransportWrapper() {
     61         String name = settings.getTransportWrapperClassName();
     62         try {
     63             Class<?> cls = Class.forName(name);
     64             return (TransportWrapper) cls.newInstance();
     65         } catch (Exception e) {
     66             throw new TestErrorException(e);
     67         }
     68     }
     69 
     70     /**
     71      * Creates new instance of VmMirror.
     72      *
     73      * @return new instance of VmMirror
     74      */
     75     protected VmMirror createVmMirror(TestOptions settings, LogWriter logWriter) {
     76         return new VmMirror(settings, logWriter);
     77     }
     78 
     79     /**
     80      * Returns opened JDWP connection or null.
     81      *
     82      * @return JDWP connection or null
     83      */
     84     public TransportWrapper getConnection() {
     85         return vmMirror.getConnection();
     86     }
     87 
     88     /**
     89      * Sets opened JDWP connection.
     90      *
     91      * @param connection to set
     92      */
     93     public void setConnection(TransportWrapper connection) {
     94         vmMirror.setConnection(connection);
     95     }
     96    /**
     97      * Resumes debuggee VM.
     98      */
     99     @Override
    100     public void resume() {
    101         vmMirror.resume();
    102     }
    103 
    104     /**
    105      * Disposes debuggee VM.
    106      */
    107     @Override
    108     public void dispose() {
    109         vmMirror.dispose();
    110     }
    111 
    112     /**
    113      * Exit target Virtual Machine
    114      */
    115     @Override
    116     public void exit(int exitStatus) {
    117         vmMirror.exit(exitStatus);
    118     }
    119 
    120 
    121 }
    122