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 29.01.2005 25 */ 26 package org.apache.harmony.jpda.tests.framework; 27 28 /** 29 * This interface is aimed to provide another way to synchronize execution of 30 * debugger and debuggee beyond the scope of JDWP channel. 31 * <p> 32 * Synchronization is performed by sending text messages. As an example, 33 * it can be implemented via TCP/IP sockets. 34 */ 35 public interface DebuggeeSynchronizer { 36 37 /** 38 * Sends specified string <code>message</code> to the channel. 39 * 40 * @param message message to be sent 41 */ sendMessage(String message)42 abstract public void sendMessage(String message); 43 44 /** 45 * Waits for specified message. If received string is equal to 46 * <code>message</code> then <code>true</code> returns. 47 * 48 * @param message expected message 49 * @return <code>true</code> if received message is equal to 50 * expected or <code>false</code> otherwise 51 */ receiveMessage(String message)52 abstract public boolean receiveMessage(String message); 53 54 /** 55 * Waits for any message from synchronized channel. 56 * 57 * @return received message 58 */ receiveMessage()59 abstract public String receiveMessage(); 60 } 61