package edu.vt.marian.uip;

import java.io.*;
import java.net.*;
import java.util.*;



/**
	Any system which wants to use the service of uip needs to implement this 
		interface. When client_uip or server_uip recieve a function from
		the other side it will call one of the processCallBack(..) methods
		to process the function.  Different systems may have different 
		code processing functions, but any can be specified in an rpc_function.
	<P>uses the services of class(es): none
	<P>designer(s): Jianxin Zhao (jxzhao@csgrad.cs.vt.edu)
	<P>implementator(s): 
	<P>finished time: 
	<P>known bugs: 
	<P>JDK version: 1.1.5
	<P>side effects:

*/

public interface call_back_processor
{

	/** possible method return values
	*/
	public final static int OK = 0;

	/**
		this method will be called when client_uip recieves
			a function from its server_uip
		@param	cu	the client_uip object which recieved the function 
		@param	rf	the function recieved by client_uip that needs to
				be processed
		@return	OK -- every thing is fine, the function has been processed correctly
		<BR>	other -- defined by each system
		<P>synchronization consideration: none
    */      
	public int process_call_back(client_uip cu, rpc_function rf);


	/**
		method description: this method will be called when server uip recieve
			a function from a client uip
		@param	clientID	used to identify from which client the server 
				gets the function
		@param	rf	the function recieved by server_uip that needs to be 
				processed
		@return	OK -- everything is fine, the function has been processed correctly
		<BR>	other -- defined by each system
 		<P>synchronization consideration: none
    */      
	public int process_call_back(int clientID, rpc_function rf);
}