uk.nhs.interoperability.consumer.appemulator

Class RoutedApplicationEmulator

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

uk.nhs.interoperability.consumer.ITKServlet

uk.nhs.interoperability.consumer.AbstractRoutedMessageServlet

uk.nhs.interoperability.consumer.appemulator.RoutedApplicationEmulator

All Implemented Interfaces:

Serializable, Runnable, javax.servlet.Servlet, javax.servlet.ServletConfig, ITKMessageConsumer

public class RoutedApplicationEmulator
extends AbstractRoutedMessageServlet
implements ITKMessageConsumer, Runnable

The Class RoutedApplicationEmulator.

Since:

0.1

Author:

Michael Odling-Smee, Nicholas Jones

See Also:

Serialized Form

Field Summary

Fields inherited from class uk.nhs.interoperability.consumer.ITKServlet

dos

Constructor Summary

Constructors

Constructor and Description
RoutedApplicationEmulator() Instantiates a new routed application emulator.

Method Summary

Methods

Modifier and Type	Method and Description
ITKMessageConsumer	getMessageConsumer() Gets the message consumer.
void	onMessage(ITKMessage request) Call to process a request message where no application response is returned synchronously.
ITKMessage	onSyncMessage(ITKMessage request) Call to process a request message where the application response is returned synchronously (in the same thread)
void	run()

Methods inherited from class uk.nhs.interoperability.consumer.AbstractRoutedMessageServlet

doPost, init

Methods inherited from class uk.nhs.interoperability.consumer.ITKServlet

addITKWrappers, checkProfileId, checkServiceId, sendInfrastructureAck, validateDistributionEnvelope

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPut, doTrace, getLastModified, service, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log

Methods inherited from class java.lang.Object

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

Constructor Detail

RoutedApplicationEmulator

public RoutedApplicationEmulator()

Instantiates a new routed application emulator.

Method Detail

getMessageConsumer

public ITKMessageConsumer getMessageConsumer()

Description copied from class: AbstractRoutedMessageServlet

Gets the message consumer.

Specified by:

getMessageConsumer in class AbstractRoutedMessageServlet

Returns:

the message consumer

onSyncMessage

public ITKMessage onSyncMessage(ITKMessage request)
                         throws ITKMessagingException

Description copied from interface: ITKMessageConsumer

Call to process a request message where the application response is returned synchronously (in the same thread)

Specified by:

onSyncMessage in interface ITKMessageConsumer

Parameters:

request - The itk request message to process. Examples might include an Spine Mini Services getPatientDetailsByNHSNumberRequest-v1-0 message

Returns:

an ITKMessage representing the application/business response to the provided request. The response may represent business processing success or failure depending on the contents of the request and the implementation of the underlying service.

Throws:

ITKMessagingException - if there are any syntactic, semantic or more general application processing issues when processing the request or constructing the response. In this context the ITKMessagingException should not be used to represent business processing failures such as a query returned no results - in general the underlying messaging specifications support "error" business response to support these types of failure.

onMessage

public void onMessage(ITKMessage request)
               throws ITKMessagingException

Description copied from interface: ITKMessageConsumer

Call to process a request message where no application response is returned synchronously. This may be because no application response is expected, or because the resulting response will be sent back to the request originator asynchronously.

Specified by:

onMessage in interface ITKMessageConsumer

Parameters:

request - The itk request message to process. Examples might include an Spine Mini Services nonCodedCDADocument-v2-0 message

Throws:

ITKMessagingException - if there are any syntactic, semantic or more general application processing issues when processing the request or constructing the response. In general it is recommended that full syntactic and as much business level validation as practical is performed against the request prior to the method returning such that faults can be raised and reported back via the underlying transport. In this context the ITKMessagingException should not be used to represent business processing failures such as a query returned no results - in general the underlying messaging specifications support "error" business response to support these types of failure.

run

public void run()

Specified by:

run in interface Runnable