Interface ModelProcessor
-
- All Known Implementing Classes:
OptionsMethodProcessor
,WadlModelProcessor
@Contract @ConstrainedTo(SERVER) public interface ModelProcessor
Contract for a model processors that processesresource models
during application initialization andresource
returned by sub resource locators. Even thoughmodel processors
can completely change the resource model, the standard use case it to enhance the current resource model by additional methods and resources (like for example adding OPTIONS http methods for every URI endpoint). More model processors can be registered. These providers will be execute in the chain so that each model processor will be executed with resource model processed by the previous model processor. The first model processor in the chain will be invoked with the initial resource model from which the application was initiated. Model processors implementations can definebinding priority
to define the order in which they are executed (processors with a lower priority is invoked before processor with a higher priority). The highest possible priority (Integer.MAX_VALUE) is used for model processor which enhance resource models by the default OPTIONS method defined by JAX-RS specification and therefore this priority should not be used. Note that if model processor adds a resources that are intended to be supportive resources likeOPTIONS
method providing information about the resource, it should properly define theextended
flag of such a new method. SeeExtendedResource
for more information.- Author:
- Miroslav Fuksa
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ResourceModel
processResourceModel(ResourceModel resourceModel, Configuration configuration)
ProcessresourceModel
and return the processed model.ResourceModel
processSubResource(ResourceModel subResourceModel, Configuration configuration)
ProcesssubResourceModel
which was returned a sub resource locator.
-
-
-
Method Detail
-
processResourceModel
ResourceModel processResourceModel(ResourceModel resourceModel, Configuration configuration)
ProcessresourceModel
and return the processed model. Returning inputresourceModel
will cause no effect on the final resource model.- Parameters:
resourceModel
- Input resource model to be processed.configuration
- Runtime configuration.- Returns:
- Processed resource model containing root resources. Non root resources will be ignored.
-
processSubResource
ResourceModel processSubResource(ResourceModel subResourceModel, Configuration configuration)
ProcesssubResourceModel
which was returned a sub resource locator. ThesubResourceModel
contains only oneresource
representing model that should be processed by further matching. The method must return also exactly one resource in the model. Returning inputsubResourceModel
instance will cause no effect on the final sub resource model.- Parameters:
subResourceModel
-Sub resource
which is based on sub resource returned from sub resource locator.configuration
- Runtime configuration.- Returns:
- Processed resource model with one
resource
which should be used for handling sub resource.
-
-