org.restlet.client.resource

Annotation Type Post

@Documented
 @Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface Post

Annotation for methods that accept submitted representations. Its semantics is equivalent to an HTTP POST method. Note that your method must have one input parameter if you want it to be selected for requests containing an entity.

Example:

 @Post
 public MyOutputBean accept(MyInputBean input);
 
 @Post("json")
 public String acceptJson(String value);
 
 @Post("xml|json:xml|json")
 public Representation accept(Representation xmlValue);
 
 @Post("json?param=val")
 public Representation acceptWithParam(String value);
 
 @Post("json?param")
 public Representation acceptWithParam(String value);
 
 @Post("?param")
 public Representation acceptWithParam(String value);
 

Author:

Jerome Louvel

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.String	value Specifies the media type of the request and response entities as extensions.

Element Detail

value

public abstract java.lang.String value

Specifies the media type of the request and response entities as extensions. If only one extension is provided, the extension applies to both request and response entities. If two extensions are provided, separated by a colon, then the first one is for the request entity and the second one for the response entity.

If several media types are supported, their extension can be specified separated by "|" characters. Note that this isn't the full MIME type value, just the extension name declared in MetadataService. For a list of all predefined extensions, please check MetadataService.addCommonExtensions(). New extension can be registered using MetadataService.addExtension(String, org.restlet.client.data.Metadata) method.

Returns:

The media types of request and/or response entities.

Default:

""