public class Finder extends Restlet
ServerResource
(or the
now deprecated Handler
) subclass available via the
getTargetClass()
method, it automatically instantiates for each
incoming call the target resource class using its default constructor and
invoking the UniformResource.init(Context, Request, Response)
method.ServerResource.handle()
method (or for Handler
subclasses to
the handle*() method (where the '*' character corresponds to the method name)
if the corresponding allow*() method returns true).UniformResource.release()
method is
invoked to permit clean-up actions.Constructor and Description |
---|
Finder()
Constructor.
|
Finder(Context context)
Constructor.
|
Finder(Context context,
java.lang.Class<?> targetClass)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
ServerResource |
create(java.lang.Class<? extends ServerResource> targetClass,
Request request,
Response response)
Creates a new instance of a given
ServerResource subclass. |
ServerResource |
create(Request request,
Response response)
Creates a new instance of the
ServerResource subclass designated
by the "targetClass" property. |
static Finder |
createFinder(java.lang.Class<?> targetClass,
java.lang.Class<? extends Finder> finderClass,
Context context,
java.util.logging.Logger logger)
Creates a new finder instance based on the "targetClass" property.
|
protected Handler |
createTarget(java.lang.Class<? extends Handler> targetClass,
Request request,
Response response)
Deprecated.
Use
create(Request, Response) instead. |
protected Handler |
createTarget(Request request,
Response response)
Deprecated.
Use
create(Request, Response) instead. |
ServerResource |
find(Request request,
Response response)
Finds the target
ServerResource if available. |
Handler |
findTarget(Request request,
Response response)
Deprecated.
Use
find(Request, Response) instead. |
java.lang.Class<?> |
getTargetClass()
Returns the target handler class which must be either a subclass of
Handler or of ServerResource . |
void |
handle(Request request,
Response response)
Handles a call.
|
void |
setTargetClass(java.lang.Class<?> targetClass)
Sets the target handler class which must be either a subclass of
Handler or of ServerResource . |
finalize, getApplication, getAuthor, getContext, getDescription, getLogger, getName, getOwner, isStarted, isStopped, setAuthor, setContext, setDescription, setName, setOwner, start, stop
public Finder()
public Finder(Context context)
context
- The context.public Finder(Context context, java.lang.Class<?> targetClass)
context
- The context.targetClass
- The target handler class. It must be either a subclass of
Handler
or of ServerResource
.public static Finder createFinder(java.lang.Class<?> targetClass, java.lang.Class<? extends Finder> finderClass, Context context, java.util.logging.Logger logger)
targetClass
- The target Resource class to attach.finderClass
- The optional finder class to instantiate.logger
- The logger.public ServerResource create(java.lang.Class<? extends ServerResource> targetClass, Request request, Response response)
ServerResource
subclass. Note
that Error and RuntimeException thrown by ServerResource
constructors are re-thrown by this method. Other exception are caught and
logged.request
- The request to handle.response
- The response to update.public ServerResource create(Request request, Response response)
ServerResource
subclass designated
by the "targetClass" property. The default behavior is to invoke the
create(Class, Request, Response)
with the "targetClass" property
as a parameter.request
- The request to handle.response
- The response to update.@Deprecated protected Handler createTarget(java.lang.Class<? extends Handler> targetClass, Request request, Response response)
create(Request, Response)
instead.request
- The request to handle.response
- The response to update.@Deprecated protected Handler createTarget(Request request, Response response)
create(Request, Response)
instead.createTarget(Class, Request, Response)
with the "targetClass"
property as a parameter.request
- The request to handle.response
- The response to update.public ServerResource find(Request request, Response response)
ServerResource
if available. The default
behavior is to invoke the create(Request, Response)
method.request
- The request to handle.response
- The response to update.@Deprecated public Handler findTarget(Request request, Response response)
find(Request, Response)
instead.Handler
if available. The default behavior is to
invoke the createTarget(Request, Response)
method.request
- The request to handle.response
- The response to update.public java.lang.Class<?> getTargetClass()
Handler
or of ServerResource
.public void setTargetClass(java.lang.Class<?> targetClass)
Handler
or of ServerResource
.targetClass
- The target handler class. It must be either a subclass of
Handler
or of ServerResource
.Copyright © 2005-2012. All Rights Reserved.