ca.uhn.fhir.rest.server.method

Class BaseQueryParameter

java.lang.Object

ca.uhn.fhir.rest.server.method.BaseQueryParameter

All Implemented Interfaces:

IParameter

Direct Known Subclasses:

SearchParameter

public abstract class BaseQueryParameter
extends Object
implements IParameter

Constructor Summary

Constructors

Constructor and Description
BaseQueryParameter()

Method Summary

Modifier and Type	Method and Description
abstract List<ca.uhn.fhir.rest.api.QualifiedParamList>	encode(ca.uhn.fhir.context.FhirContext theContext, Object theObject)
abstract String	getName()
abstract ca.uhn.fhir.rest.api.RestSearchParameterTypeEnum	getParamType()
Set<String>	getQualifierBlacklist() Returns null if blacklist is "none"
Set<String>	getQualifierWhitelist() Returns null if whitelist is "all"
abstract boolean	handlesMissing() Parameter should return true if parse(FhirContext, List) should be called even if the query string contained no values for the given parameter
void	initializeTypes(Method theMethod, Class<? extends Collection<?>> theOuterCollectionType, Class<? extends Collection<?>> theInnerCollectionType, Class<?> theParameterType)
abstract boolean	isRequired()
abstract Object	parse(ca.uhn.fhir.context.FhirContext theContext, List<ca.uhn.fhir.rest.api.QualifiedParamList> theString)
Object	translateQueryParametersIntoServerArgument(RequestDetails theRequest, BaseMethodBinding<?> theMethodBinding) This server method method takes the data received by the server in an incoming request, and translates that data into a single argument for a server method invocation.

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseQueryParameter

public BaseQueryParameter()

Method Detail

encode

public abstract List<ca.uhn.fhir.rest.api.QualifiedParamList> encode(ca.uhn.fhir.context.FhirContext theContext,
                                                                     Object theObject)
                                                              throws ca.uhn.fhir.rest.server.exceptions.InternalErrorException

Throws:

ca.uhn.fhir.rest.server.exceptions.InternalErrorException

getName

public abstract String getName()

getParamType

public abstract ca.uhn.fhir.rest.api.RestSearchParameterTypeEnum getParamType()

getQualifierBlacklist

public Set<String> getQualifierBlacklist()

Returns null if blacklist is "none"

getQualifierWhitelist

public Set<String> getQualifierWhitelist()

Returns null if whitelist is "all"

handlesMissing

public abstract boolean handlesMissing()

Parameter should return true if parse(FhirContext, List) should be called even if the query string contained no values for the given parameter

initializeTypes

public void initializeTypes(Method theMethod,
                            Class<? extends Collection<?>> theOuterCollectionType,
                            Class<? extends Collection<?>> theInnerCollectionType,
                            Class<?> theParameterType)

Specified by:

initializeTypes in interface IParameter

isRequired

public abstract boolean isRequired()

parse

public abstract Object parse(ca.uhn.fhir.context.FhirContext theContext,
                             List<ca.uhn.fhir.rest.api.QualifiedParamList> theString)
                      throws ca.uhn.fhir.rest.server.exceptions.InternalErrorException,
                             ca.uhn.fhir.rest.server.exceptions.InvalidRequestException

Throws:

ca.uhn.fhir.rest.server.exceptions.InternalErrorException

ca.uhn.fhir.rest.server.exceptions.InvalidRequestException

translateQueryParametersIntoServerArgument

public Object translateQueryParametersIntoServerArgument(RequestDetails theRequest,
                                                         BaseMethodBinding<?> theMethodBinding)
                                                  throws ca.uhn.fhir.rest.server.exceptions.InternalErrorException,
                                                         ca.uhn.fhir.rest.server.exceptions.InvalidRequestException

Description copied from interface: IParameter

This server method method takes the data received by the server in an incoming request, and translates that data into a single argument for a server method invocation. Note that all received data is passed to this method, but the expectation is that not necessarily that all data is used by every parameter.

Specified by:

translateQueryParametersIntoServerArgument in interface IParameter

Parameters:

theRequest - The incoming request object

theMethodBinding - TODO

Returns:

Returns the argument object as it will be passed to the IResourceProvider method.

Throws:

ca.uhn.fhir.rest.server.exceptions.InternalErrorException

ca.uhn.fhir.rest.server.exceptions.InvalidRequestException