JAX-RS

JAX-RS: Java API for RESTful Web Services ( JAX-RS ) je specifikace API programovacího jazyka Java , která poskytuje podporu pro vytváření webových služeb podle architektonického vzoru Representation State Transfer ( REST ) . JAX-RS používá anotace zavedené v Java SE 5 ke zjednodušení vývoje a nasazení klientů a koncových bodů webových služeb.

Od verze 1.1 je JAX-RS oficiální součástí Java EE 6. Pozoruhodnou vlastností je skutečnost, že pro zahájení používání JAX-RS není potřeba žádná konfigurace. Pokud se nepoužívá Java EE 6, bude vyžadována malá položka v deskriptoru nasazení web.xml.

Specifikace

JAX-RS poskytuje některé anotace, které pomáhají mapovat třídu prostředků POJO (Plastý starý Java objekt ) jako webový prostředek . Anotace jsou v balíčku Java . Tyto zahrnují: javax.ws.rs

@Pathurčuje relativní cestu pro třídu prostředků nebo metodu.
@GET, @PUT, @POSTa zadejte metodu požadavku HTTP @DELETE.@HEAD
@Producesdefinuje typy MIME odpovědí (používané pro vyjednávání obsahu).
@Consumesurčuje typy MIME akceptované v požadavku.

Kromě toho JAX-RS poskytuje další anotace parametrů metod pro extrakci informací z požadavku. Všechny @*Paramanotace přijímají klíč nějaké formy, který se používá k vyhledání požadované hodnoty.

@PathParamváže parametr metody na segment cesty.
@QueryParamváže parametr metody na hodnotu parametru požadavku HTTP.
@MatrixParamváže parametr metody na hodnotu parametru matice HTTP.
@HeaderParamváže parametr metody na hodnotu hlavičky HTTP.
@CookieParamváže parametr metody na hodnotu cookie .
@FormParamváže parametr metody na hodnotu formuláře.
@DefaultValueurčuje výchozí hodnotu pro výše uvedené vazby, když klíč není nalezen.
@Contextvrátí celý kontext objektu (například @Context HttpServletRequest request).