org.apache.xmlrpc.client

Class TimingOutCallback

public class TimingOutCallback extends Object implements AsyncCallback

A callback object that can wait up to a specified amount of time for the XML-RPC response. Suggested use is as follows:

   // Wait for 10 seconds.
   TimingOutCallback callback = new TimingOutCallback(10 * 1000);
   XmlRpcClient client = new XmlRpcClient(url);
   client.executeAsync(methodName, aVector, callback);
   try {
       return callback.waitForResponse();
   } catch (TimeoutException e) {
       System.out.println("No response from server.");
   } catch (Exception e) {
       System.out.println("Server returned an error message.");
   }
 
Nested Class Summary
static classTimingOutCallback.TimeoutException
This exception is thrown, if the request times out.
Constructor Summary
TimingOutCallback(long pTimeout)
Waits the specified number of milliseconds for a response.
Method Summary
voidhandleError(XmlRpcRequest pRequest, Throwable pError)
voidhandleResult(XmlRpcRequest pRequest, Object pResult)
ObjectwaitForResponse()
Called to wait for the response.

Constructor Detail

TimingOutCallback

public TimingOutCallback(long pTimeout)
Waits the specified number of milliseconds for a response.

Method Detail

handleError

public void handleError(XmlRpcRequest pRequest, Throwable pError)

handleResult

public void handleResult(XmlRpcRequest pRequest, Object pResult)

waitForResponse

public Object waitForResponse()
Called to wait for the response.

Throws: InterruptedException The thread was interrupted. TimeoutException No response was received after waiting the specified time. Throwable An error was returned by the server.

Copyright © 2001-2007 Apache Software Foundation. All Rights Reserved.