ca.uhn.fhir.rest.method

Class BaseMethodBinding<T>

java.lang.Object

ca.uhn.fhir.rest.method.BaseMethodBinding<T>

All Implemented Interfaces:

IClientResponseHandler<T>

Direct Known Subclasses:

BaseResourceReturningMethodBinding, CreateMethodBinding, DeleteMethodBinding, DeleteTagsMethodBinding, GetTagsMethodBinding, UpdateMethodBinding, ValidateMethodBindingDstu1

public abstract class BaseMethodBinding<T>
extends Object
implements IClientResponseHandler<T>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BaseMethodBinding.ActiveRequestReader
static class	BaseMethodBinding.InactiveRequestReader
static interface	BaseMethodBinding.IRequestReader

Constructor Summary

Constructors

Constructor and Description
BaseMethodBinding(Method theMethod, FhirContext theContext, Object theProvider)

Method Summary

Modifier and Type	Method and Description
static BaseMethodBinding<?>	bindMethod(Method theMethod, FhirContext theContext, Object theProvider)
protected IParser	createAppropriateParserForParsingResponse(String theResponseMimeType, Reader theResponseReader, int theResponseStatusCode)
protected IParser	createAppropriateParserForParsingServerRequest(RequestDetails theRequest)
protected Object[]	createParametersForServerRequest(RequestDetails theRequest)
List<Class<?>>	getAllowableParamAnnotations()
FhirContext	getContext()
Set<String>	getIncludes()
Method	getMethod()
List<IParameter>	getParameters()
Object	getProvider()
Set<Include>	getRequestIncludesFromParams(Object[] params)
abstract String	getResourceName() Returns the name of the resource this method handles, or null if this method is not resource specific
abstract RestOperationTypeEnum	getRestOperationType()
RestOperationTypeEnum	getRestOperationType(RequestDetails theRequestDetails) Determine which operation is being fired for a specific request
abstract boolean	incomingServerRequestMatchesMethod(RequestDetails theRequest)
abstract BaseHttpClientInvocation	invokeClient(Object[] theArgs)
abstract Object	invokeServer(IRestfulServer<?> theServer, RequestDetails theRequest)
protected Object	invokeServerMethod(IRestfulServer<?> theServer, RequestDetails theRequest, Object[] theMethodParams)
boolean	isSupportsConditional() Does this method have a parameter annotated with ConditionalParamBinder.
boolean	isSupportsConditionalMultiple() Does this method support conditional operations over multiple objects (basically for conditional delete)
protected void	populateActionRequestDetailsForInterceptor(RequestDetails theRequestDetails, IServerInterceptor.ActionRequestDetails theDetails, Object[] theMethodParams) Subclasses may override this method (but should also call super.#populateActionRequestDetailsForInterceptor(RequestDetails, ActionRequestDetails, Object[]) to provide method specifics to the interceptors.
protected BaseServerResponseException	processNon2xxResponseAndReturnExceptionToThrow(int theStatusCode, String theResponseMimeType, Reader theResponseReader)
void	setParameters(List<IParameter> theParameters) For unit tests only
protected IBundleProvider	toResourceList(Object response)
static boolean	verifyMethodHasZeroOrOneOperationAnnotation(Method theNextMethod, Object... theAnnotations)

Methods inherited from class java.lang.Object

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

Methods inherited from interface ca.uhn.fhir.rest.method.IClientResponseHandler

invokeClient

Constructor Detail

BaseMethodBinding

public BaseMethodBinding(Method theMethod,
                         FhirContext theContext,
                         Object theProvider)

Method Detail

createAppropriateParserForParsingResponse

protected IParser createAppropriateParserForParsingResponse(String theResponseMimeType,
                                                            Reader theResponseReader,
                                                            int theResponseStatusCode)

createAppropriateParserForParsingServerRequest

protected IParser createAppropriateParserForParsingServerRequest(RequestDetails theRequest)

createParametersForServerRequest

protected Object[] createParametersForServerRequest(RequestDetails theRequest)

getAllowableParamAnnotations

public List<Class<?>> getAllowableParamAnnotations()

getContext

public FhirContext getContext()

getIncludes

public Set<String> getIncludes()

getMethod

public Method getMethod()

getParameters

public List<IParameter> getParameters()

getProvider

public Object getProvider()

getRequestIncludesFromParams

public Set<Include> getRequestIncludesFromParams(Object[] params)

getResourceName

public abstract String getResourceName()

Returns the name of the resource this method handles, or null if this method is not resource specific

getRestOperationType

public abstract RestOperationTypeEnum getRestOperationType()

getRestOperationType

public RestOperationTypeEnum getRestOperationType(RequestDetails theRequestDetails)

Determine which operation is being fired for a specific request

Parameters:

theRequestDetails - The request

incomingServerRequestMatchesMethod

public abstract boolean incomingServerRequestMatchesMethod(RequestDetails theRequest)

invokeClient

public abstract BaseHttpClientInvocation invokeClient(Object[] theArgs)
                                               throws InternalErrorException

Throws:

InternalErrorException

invokeServer

public abstract Object invokeServer(IRestfulServer<?> theServer,
                                    RequestDetails theRequest)
                             throws BaseServerResponseException,
                                    IOException

Throws:

BaseServerResponseException

IOException

invokeServerMethod

protected final Object invokeServerMethod(IRestfulServer<?> theServer,
                                          RequestDetails theRequest,
                                          Object[] theMethodParams)

isSupportsConditional

public boolean isSupportsConditional()

Does this method have a parameter annotated with ConditionalParamBinder. Note that many operations don't actually support this paramter, so this will only return true occasionally.

isSupportsConditionalMultiple

public boolean isSupportsConditionalMultiple()

Does this method support conditional operations over multiple objects (basically for conditional delete)

populateActionRequestDetailsForInterceptor

protected void populateActionRequestDetailsForInterceptor(RequestDetails theRequestDetails,
                                                          IServerInterceptor.ActionRequestDetails theDetails,
                                                          Object[] theMethodParams)

Subclasses may override this method (but should also call super.#populateActionRequestDetailsForInterceptor(RequestDetails, ActionRequestDetails, Object[]) to provide method specifics to the interceptors.

Parameters:

theRequestDetails - The server request details

theDetails - The details object to populate

theMethodParams - The method params as generated by the specific method binding

processNon2xxResponseAndReturnExceptionToThrow

protected BaseServerResponseException processNon2xxResponseAndReturnExceptionToThrow(int theStatusCode,
                                                                                     String theResponseMimeType,
                                                                                     Reader theResponseReader)

setParameters

public void setParameters(List<IParameter> theParameters)

For unit tests only

toResourceList

protected IBundleProvider toResourceList(Object response)
                                  throws InternalErrorException

Throws:

InternalErrorException

bindMethod

public static BaseMethodBinding<?> bindMethod(Method theMethod,
                                              FhirContext theContext,
                                              Object theProvider)

verifyMethodHasZeroOrOneOperationAnnotation

public static boolean verifyMethodHasZeroOrOneOperationAnnotation(Method theNextMethod,
                                                                  Object... theAnnotations)