Java Reference
In-Depth Information
Here, we've used @DefaultValue to specify a default start index of 0 and a default dataset
size of 10 . JAX-RS will use the string conversion rules to convert the string value of the
@DefaultValue annotation into the desired Java type.
URI template, matrix, query, and form parameters must all be encoded by the HTTP specific-
ation. By default, JAX-RS decodes these values before converting them into the desired Java
types. Sometimes, though, you may want to work with the raw encoded values. Using the annotation gives you the desired effect:
@Produces ( "application/xml" )
public String get ( @Encoded @QueryParam ( "something" ) String str ) {...}
Here, we've used the @Encoded annotation to specify that we want the encoded value of the
something query parameter to be injected into the str Java parameter. If you want to work
solely with encoded values within your Java method or even your entire class, you can an-
notate the method or class with @Encoded and only encoded values will be used.
Wrapping Up
In this chapter, we examined how to use JAX-RS injection annotations to insert bits and
pieces of an HTTP request à la carte into your JAX-RS resource method parameters. While
data is represented as strings within an HTTP request, JAX-RS can automatically convert
this data into the Java type you desire, provided that the type follows certain constraints.
These features allow you to write compact, easily understandable code and avoid a lot of the
boilerplate code you might need if you were using other frameworks like the servlet specific-
ation. You can test-drive the code in this chapter by flipping to Chapter 20 .
[ 4 ] For more information, see .
Search WWH ::

Custom Search