java.lang.Object
- org.astrogrid.samp.xmlrpc.internal.InternalClient
- - org.astrogrid.samp.test.TestXmlrpcClient

All Implemented Interfaces:

SampXmlRpcClient
```
class TestXmlrpcClient
extends InternalClient
```
SampXmlrpcClient implementation for testing success or failure of XML-RPC method invocations. Note the return value of the InternalClient.callAndWait(java.lang.String, java.util.List) method is either SUCCESS or FAILURE, rather than the actual result of the call. Methods may throw TestExceptions to indicate assertion failures.

Since:

28 Aug 2009

Author:

Mark Taylor

Field Summary

Fields
Modifier and Type Field Description

static java.lang.Object FAILURE

static java.lang.Object SUCCESS

Constructor Summary

Constructors
Constructor Description

TestXmlrpcClient(java.net.URL endpoint)
Constructor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`checkFailureCall(java.lang.String method, java.util.List params)`	Makes a call, and asserts that the result is an XML-RPC fault.
`void`	`checkSuccessCall(java.lang.String method, java.util.List params)`	Makes a call, and asserts that the result is a normal XML-RPC response.
`protected java.lang.Object`	`deserializeResponse(java.io.InputStream in)`	Returns `SUCCESS` or `FAILURE`.

Methods inherited from class org.astrogrid.samp.xmlrpc.internal.InternalClient
callAndForget, callAndWait, serializeCall

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SUCCESS
```
public static final java.lang.Object SUCCESS
```
  - FAILURE
```
public static final java.lang.Object FAILURE
```
- Constructor Detail
  - TestXmlrpcClient
```
TestXmlrpcClient(java.net.URL endpoint)
```
    Constructor.
    
    Parameters:
    
    endpoint - hub HTTP endpoint
- Method Detail
  - deserializeResponse
```
protected java.lang.Object deserializeResponse(java.io.InputStream in)
                                        throws java.io.IOException
```
    Returns SUCCESS or FAILURE.
    
    Overrides:
    
    deserializeResponse in class InternalClient
    
    Parameters:
    
    in - input stream containing response document
    
    Throws:
    
    java.io.IOException
  - checkSuccessCall
```
public void checkSuccessCall(java.lang.String method,
                             java.util.List params)
                      throws java.io.IOException
```
    Makes a call, and asserts that the result is a normal XML-RPC response.
    
    Parameters:
    
    method - XML-RPC method name
    
    params - parameters for XML-RPC call (SAMP-compatible)
    
    Throws:
    
    TestException - if the response is not a success
    
    java.io.IOException
  - checkFailureCall
```
public void checkFailureCall(java.lang.String method,
                             java.util.List params)
                      throws java.io.IOException
```
    Makes a call, and asserts that the result is an XML-RPC fault.
    
    Parameters:
    
    method - XML-RPC method name
    
    params - parameters for XML-RPC call (SAMP-compatible)
    
    Throws:
    
    TestException - if the response is not a fault
    
    java.io.IOException

Modifier and Type	Field	Description
`static java.lang.Object`	`FAILURE`
`static java.lang.Object`	`SUCCESS`

Class TestXmlrpcClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.astrogrid.samp.xmlrpc.internal.InternalClient

Methods inherited from class java.lang.Object

Field Detail

SUCCESS

FAILURE

Constructor Detail

TestXmlrpcClient

Method Detail

deserializeResponse

checkSuccessCall

checkFailureCall