Package org.actioncontroller.meta

The meta-package contains annotations used on other annotations to attach behavior to the annotations. The package consists of

Annotations

Apply these to specific annotations to specify their effect:

• HttpParameterMapping annotates annotations used on parameters to specify how to populate the arguments in the context onf an ApiHttpExchange (and ApiClientExchange)
• HttpReturnMapping annotates annotations used on methods to specify how to deal with a return value in the context of an ApiHttpExchange (and ApiClientExchange)
• HttpRouterMapping annotates annotations used on methods to specify how to generate ApiControllerActions from the methods

Factories

These are used when a controller is initialized to convert the class structure into a list of actions with mappers of parameters and return value.

• ApiControllerActionFactory creates a ApiControllerAction from a method
• HttpParameterMapperFactory creates mappers from ApiHttpExchange to method invocation arguments
• HttpReturnMapperFactory creates mappers from method invocation return value ApiHttpExchange

Mappers

These are used during a specific method invocation to convert from the HTTP values to the actual method invocation values.

• HttpParameterMapper maps from an ApiHttpExchange to a method invocation argument
• HttpReturnMapper maps from an method invocation return value to ApiHttpExchange
• HttpClientParameterMapper maps from an method invocation arguments to ApiClientExchange
• HttpClientParameterMapper maps from an ApiClientExchange to a method invocation return value

Interface Summary

Interface	Description
AnnotationFactory
ApiControllerActionFactory<ANNOTATION extends Annotation>	Implementations of this interface should be annotated on annotations used to convert methods to HTTP actions, such as GET and POST
HttpClientParameterMapper	Returned by HttpParameterMapperFactory to be used with ApiClientClassProxy to convert method arguments into HTTP request information.
HttpClientReturnMapper	Returned by HttpReturnMapperFactory to be used with ApiClientClassProxy to convert HTTP response information into method return values.
HttpParameterMapper	Returned by HttpParameterMapperFactory to be used with ApiHttpExchange to convert HTTP request information into method invocation arguments.
HttpParameterMapperFactory<ANNOTATION extends Annotation>	Implementations of this interface should be annotated on annotations used to convert HTTP requests into method invocation arguments, such as RequestParam, PathParam and UnencryptedCookie
HttpReturnMapper	Returned by HttpReturnMapperFactory to be used with ApiHttpExchange to method invocation return values to HTTP response information.
HttpReturnMapperFactory<ANNOTATION extends Annotation>	Implementations of this interface should be annotated on annotations used to convert method invocation return values to HTTP response information, such as ContentBody and SendRedirect

Annotation Types Summary

Annotation Type	Description
HttpParameterMapping	Attach parameter mapping behavior to an annotation.
HttpReturnMapping	Attach return value mapping behavior to an annotation.
HttpRouterMapping	Attach action generation behavior to an annotation.