|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.restlet.service.Service
org.restlet.service.ConverterService
public class ConverterService
Application service converting between representation and regular Java
objects. The conversion can work in both directions. Actual converters can be
plugged into the engine to support this service.
Root object classes used for conversion shouldn't be generic classes
otherwise important contextual type information will be missing at runtime
due to Java type erasure mechanism. If needed, create a fully resolved
subclasses and/or a container classes.
Constructor Summary | |
---|---|
ConverterService()
Constructor. |
|
ConverterService(boolean enabled)
Constructor. |
Method Summary | ||
---|---|---|
List<Class<?>> |
getObjectClasses(Variant source)
Returns the list of object classes that can be converted from a given variant. |
|
List<? extends Variant> |
getVariants(Class<?> source,
Variant target)
Returns the list of variants that can be converted from a given object class. |
|
Object |
toObject(Representation source)
Converts a Representation into a regular Java object. |
|
|
toObject(Representation source,
Class<T> target,
Resource resource)
Converts a Representation into a regular Java object. |
|
Representation |
toRepresentation(Object source)
Converts a regular Java object into a Representation. |
|
Representation |
toRepresentation(Object source,
Variant target,
Resource resource)
Converts a regular Java object into a Representation. |
|
void |
updatePreferences(List<Preference<MediaType>> preferences,
Class<?> entity)
Updates the media type preferences with available conversion capabilities for the given entity class. |
Methods inherited from class org.restlet.service.Service |
---|
createInboundFilter, createOutboundFilter, getContext, isEnabled, isStarted, isStopped, setContext, setEnabled, start, stop |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ConverterService()
public ConverterService(boolean enabled)
enabled
- True if the service has been enabled.Method Detail |
---|
public List<Class<?>> getObjectClasses(Variant source)
source
- The source variant.
public List<? extends Variant> getVariants(Class<?> source, Variant target)
source
- The source class.target
- The expected representation metadata.
public Object toObject(Representation source) throws IOException
source
- The source representation to convert.
IOException
public <T> T toObject(Representation source, Class<T> target, Resource resource) throws IOException
T
- The expected class of the Java object.source
- The source representation to convert.target
- The target class of the Java object.resource
- The parent resource.
IOException
public Representation toRepresentation(Object source)
source
- The source object to convert.
public Representation toRepresentation(Object source, Variant target, Resource resource)
source
- The source object to convert.target
- The target representation variant.resource
- The parent resource.
public void updatePreferences(List<Preference<MediaType>> preferences, Class<?> entity)
preferences
- The media type preferences.entity
- The entity class to convert.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |