org.dmilne.xjsf

Class ServiceCaller

java.lang.Object

org.dmilne.xjsf.ServiceCaller

public class ServiceCaller
extends java.lang.Object

A utility class for calling XJSF web services from within Java.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ServiceCaller.ServiceException

Constructor Summary

Constructors

Constructor and Description
ServiceCaller(java.net.URL wmServer)

Method Summary

Methods

Modifier and Type	Method and Description
<M extends Service.Message> M	callService(java.lang.String serviceName, java.lang.Class<M> messageClass, java.util.HashMap<java.lang.String,java.lang.String> params) Calls the given service with the given parameters, and retrieves the response, parsed into a convenient Java object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceCaller

public ServiceCaller(java.net.URL wmServer)

Parameters:

wmServer - the URL of the wikipedia miner server to call.

Method Detail

callService

public <M extends Service.Message> M callService(java.lang.String serviceName,
                                        java.lang.Class<M> messageClass,
                                        java.util.HashMap<java.lang.String,java.lang.String> params)
                                      throws java.io.IOException,
                                             ServiceCaller.ServiceException

Calls the given service with the given parameters, and retrieves the response, parsed into a convenient Java object.

Type Parameters:

M - The type of message expected from the given service

Parameters:

serviceName - The name of the service to call

messageClass - The expected class of message this service returns

params - Your query parameters. Note that 'responseFormat' will be ignored.

Returns:

the response to your request

Throws:

java.io.IOException - If there was a problem communicating with the Wikipedia Miner server

ServiceCaller.ServiceException - If there was a problem processing your request (missing parameters, invalid ids, etc)