com.airepublic.microverse.core.common

Class ServiceUtils

java.lang.Object

com.airepublic.microverse.core.common.ServiceUtils

public class ServiceUtils
extends Object

Common methods used by various classes.

Author:

Torsten Oltmanns

Field Summary

Fields

Modifier and Type	Field and Description
static String	MULTICAST_GROUP_ADDRESS
static int	MULTICAST_PORT

Constructor Summary

Constructors

Constructor and Description
ServiceUtils()

Method Summary

Modifier and Type	Method and Description
static String	buildURL(String host, int port, boolean useSSL, String uri) Gets the fully qualified URL string to the service.
static IMarshaller	determineCommonMimeType(List<String> remoteSupportedMimeTypes) Determine which mime-type and corresponding marshaller is mutually supported.
static org.apache.http.HttpResponse	executeRequest(org.apache.http.client.methods.HttpUriRequest request, boolean useSSL) Executes the specified request.
static org.apache.http.HttpResponse	executeRequest(RegistryDescriptor registryDescriptor, WebCall webCall, Serializable entity)
static org.apache.http.HttpResponse	executeRequest(ServiceDescriptor serviceDescriptor, WebCall webCall, Serializable entity)
static org.apache.http.HttpResponse	executeRequest(String host, int port, boolean useSSL, WebCall webCall, List<String> remoteSupportedMimeTypes, Serializable entity)
static String	getAcceptedMimeTypes() Creates a comma-separated string of all mime-types supported by the MarshallerFactory.
static IMarshaller	getMarshallerToCommunicateWithRestServer(String host, int port, String restServerUri) Gets a IMarshaller by querying the REST server's supported mime-types and trying to find a match by the clients supported mime-types.
static String	getMimeTypeForResponse(org.apache.http.Header acceptHeader) Gets the mime-type from the request header 'accept' to determine the content-type of the response content.
static String	getMimeTypeFromResponse(org.apache.http.HttpResponse response) Gets the mime-type from the response header 'content-type' to determine how to deserialize the response entity.
static String	getServiceURL(ServiceDescriptor serviceDescriptor) Gets the fully qualified URL string to the service.
static List<String>	getSupportedMediaTypesOfRestServer(String host, int port, String mediaTypesQueryUri) Queries the supported mime-types from the REST server.
static void	validateResponse(org.apache.http.HttpRequest httpRequest, org.apache.http.HttpResponse httpResponse) Validates the response if the status OK was returned, otherwise it will throw a ServiceException.

Methods inherited from class java.lang.Object

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

Field Detail

MULTICAST_GROUP_ADDRESS

public static final String MULTICAST_GROUP_ADDRESS

See Also:

Constant Field Values

MULTICAST_PORT

public static final int MULTICAST_PORT

See Also:

Constant Field Values

Constructor Detail

ServiceUtils

public ServiceUtils()

Method Detail

getAcceptedMimeTypes

public static String getAcceptedMimeTypes()

Creates a comma-separated string of all mime-types supported by the MarshallerFactory.

Returns:

a comma-separated string of all supported mime-types

getMimeTypeForResponse

public static String getMimeTypeForResponse(org.apache.http.Header acceptHeader)

Gets the mime-type from the request header 'accept' to determine the content-type of the response content.

Parameters:

headers - the request headers

Returns:

the response mime-type

getMimeTypeFromResponse

public static String getMimeTypeFromResponse(org.apache.http.HttpResponse response)

Gets the mime-type from the response header 'content-type' to determine how to deserialize the response entity.

Parameters:

response - the response

Returns:

the mime-type

getSupportedMediaTypesOfRestServer

public static List<String> getSupportedMediaTypesOfRestServer(String host,
                                                              int port,
                                                              String mediaTypesQueryUri)
                                                       throws ServiceException

Queries the supported mime-types from the REST server.

Throws:

ServiceException

getMarshallerToCommunicateWithRestServer

public static IMarshaller getMarshallerToCommunicateWithRestServer(String host,
                                                                   int port,
                                                                   String restServerUri)
                                                            throws ServiceException

Gets a IMarshaller by querying the REST server's supported mime-types and trying to find a match by the clients supported mime-types.

Parameters:

host - the host of the REST server

port - the port of the REST server

restServerUri - the URI which returns the mime-types in text/plain

Returns:

the IMarshaller

Throws:

ServiceException

validateResponse

public static void validateResponse(org.apache.http.HttpRequest httpRequest,
                                    org.apache.http.HttpResponse httpResponse)
                             throws ServiceException

Validates the response if the status OK was returned, otherwise it will throw a ServiceException.

Parameters:

httpResponse - the response

Throws:

ServiceException

getServiceURL

public static String getServiceURL(ServiceDescriptor serviceDescriptor)

Gets the fully qualified URL string to the service.

Parameters:

serviceDescriptor - the ServiceDescriptor

Returns:

the URL string

buildURL

public static String buildURL(String host,
                              int port,
                              boolean useSSL,
                              String uri)

Gets the fully qualified URL string to the service.

Parameters:

host - the host

port - the port

useSSL - the flag whether to use SSL

uri - the uri to the resource

Returns:

the URL string

executeRequest

public static org.apache.http.HttpResponse executeRequest(RegistryDescriptor registryDescriptor,
                                                          WebCall webCall,
                                                          Serializable entity)
                                                   throws ServiceException

Throws:

ServiceException

executeRequest

public static org.apache.http.HttpResponse executeRequest(ServiceDescriptor serviceDescriptor,
                                                          WebCall webCall,
                                                          Serializable entity)
                                                   throws ServiceException

Throws:

ServiceException

executeRequest

public static org.apache.http.HttpResponse executeRequest(String host,
                                                          int port,
                                                          boolean useSSL,
                                                          WebCall webCall,
                                                          List<String> remoteSupportedMimeTypes,
                                                          Serializable entity)
                                                   throws ServiceException

Throws:

ServiceException

executeRequest

public static org.apache.http.HttpResponse executeRequest(org.apache.http.client.methods.HttpUriRequest request,
                                                          boolean useSSL)
                                                   throws ServiceException

Executes the specified request.

Parameters:

request - the request

useSSL - whether to use SSL for the connection

Returns:

the response

Throws:

ServiceException

determineCommonMimeType

public static IMarshaller determineCommonMimeType(List<String> remoteSupportedMimeTypes)
                                           throws ServiceException

Determine which mime-type and corresponding marshaller is mutually supported.

Parameters:

remoteSupportedMimeTypes - the mime-types supported by the remote server

Returns:

a IMarshaller or null

Throws:

ServiceException