JSR 339 - Java API for RESTful Web Services

JSR 339 Java API for RESTful Web Services

GujavaSC / Adopt a JSR

Membros do GujavaSC

Participação Adopt a JSR

Grupo de estudos

Artigos

Palestras

O que é REST?

É um estilo arquitetural…

Estilo arquitetural???

É um estilo arquitetural…

Enxaimel

Telhado

Madeiras

Tijolos

Estilo

Arquitetural

REST

HTTP

Características

Recursos são identificados por um ID;

Sem estado;

Vincule as coisas;

Múltiplas representações;

Interface uniforme.

Características

Recursos são identificados por um ID;

Sem estado;

Vincule as coisas;

Múltiplas representações;

Interface uniforme.

Interface Uniforme

Verbos HTTP Ação

POST Cria um novo recurso

PUT Atualiza um recurso

DELETE Remove um recurso

GET Retorna um recurso

JAX-RS 1.x

Final Release em 2008

Objetivos

Baseado em POJO

Centralizado em HTTP

Independência de formato

Independência de container

Inclusão no Java EE 6

Exemplo JAX-RS 1.0

@Path("books")

public class BookResource {

@GET

@Path("/year/{year}")

@Produces(MediaType.APPLICATION_JSON)

public Response listByYearAndName(@PathParam("year") Integer year,

@QueryParam("name") String name) {

List<Book> books = getListByYearAndName(year, name);

ResponseBuilder rb = Response.ok(books);

return rb.build();

}

}

http://localhost:8080/rest-example/resources/books/year/2011?name=Book1

Exemplo JAX-RS 1.0


@Path("books")


@GET







return rb.build();

}

}

Exemplo JAX-RS 1.0


@Path("books")


@GET







return rb.build();

}

}

@Path("books")


@GET







return rb.build();

}

}

Exemplo JAX-RS 1.0


Exemplo JAX-RS 1.0

@Path("books")


@GET







return rb.build();

}

}


Exemplo JAX-RS 1.0

@Path("books")


@GET







return rb.build();

}

}


Exemplo JAX-RS 1.0

@Path("books")


@GET







return rb.build();

}

}


Exemplo JAX-RS 1.0

@Path("books")


@GET







return rb.build();

}

}


Exemplo JAX-RS 1.0

@Path("books")


@GET







return rb.build();

}

}


Exemplo JAX-RS 1.0

@Path("books")


@GET



public List<Book> listByYearAndName(@PathParam("year") Integer year,



// ResponseBuilder rb = Response.ok(books);

// return rb.build();

return books;

}

}


JAX-RS 2.0

Final Release em Maio de 2013

Solicitações (JSR 339)

Client API

Asynchronous processing

Filters / Interceptors

Bean Validation

Hypermedia

MVC

Client API

Client API

Baseada na API do Jersey (versão 1.x);

Consumir serviços criados em qualquer linguagem.

Qual é o recurso?

Book!

Como foi exposto?

@Path("books")


@GET

@Path("{id}")


public Response read(@PathParam("id") Integer id) {

return Response.ok(readObject(id)).build();

}

}

http://localhost:8080/rest-example/resources/books/10

Como consultávamos?

@Test

public void deveConterOLivro_javaee6() throws Exception {

URL url = new URL("http://localhost:8080/rest-example/resources/books/10");

HttpURLConnection con = (HttpURLConnection) url.openConnection();

String result = IOUtils.toString(con.getInputStream(), "UTF-8");

con.disconnect();

Book book = new Gson().fromJson(result, Book.class);

assertThat(book, notNullValue());

}

@Test





con.disconnect();



}

@Test





con.disconnect();



}

@Test





con.disconnect();



}

@Test





con.disconnect();



}

@Test





con.disconnect();



}

@Test





con.disconnect();



}

GSON,

Jackson,

Jettison,

XStream

@Test





con.disconnect();



}

E agora com a Client API?

@Test

public void deveConterOLivro_javaee7() {

Client client = ClientBuilder.newClient();

WebTarget target = client.target("http://localhost:8080/rest-example/resources");

WebTarget path = target.path("books/{id}");

WebTarget bookId = path.resolveTemplate("id", "10");

Builder invocation = bookId.request();

Book book = invocation.get(Book.class);

client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

@Test








client.close();


}

...“um pouco” mais fluente...

@Test



Book book = client.target("http://localhost:8080/rest-example/resources")

.path("books/{id}")

.resolveTemplate("id", "10")

.request()

.get(Book.class);

client.close();


}

...@Delete...

@Test

public void deletarOLivro_javaee7() {


Response res = client.target("http://localhost:8080/rest-example/resources")

.path("books/{id}")


.request()

.delete();

response.close(); client.close();

assertEquals(Status.OK.getStatusCode(), res.getStatus());

}

@Test




.path("books/{id}")


.request()

.delete();



}

@Test




.path("books/{id}")


.request()

.delete();



}

@Test




.path("books/{id}")


.request()

.delete();



}

...@Post...

@Test

public void inserirOLivro_javaee7() {


Book book = new Book(1, "Android", "Direto das trincheiras");

Response response = client.target("http://localhost:8080/rest-example/resources")

.path("books")

.request(MediaType.APPLICATION_JSON)

.post(Entity.entity(book, MediaType.APPLICATION_JSON));


assertEquals(Status.OK.getStatusCode(), response.getStatus());

}

@Test





.path("books")





}

@Test





.path("books")





}

@Test





.path("books")





}

Como configurar Filters e Interceptors?

@Test

public void inserirOLivroComFiltroDeLog() {


client.register(MyLoggingFilter.class);



.path("books")

.register(MyEntityInterceptor.class)





}

@Test






.path("books")






}

@Test






.path("books")






}

@Test






.path("books")






}

AsynchronousProcessing

Que tal uma chamada assíncrona?

@Path("books")


@GET

@Path("{id}")


public Response read(@PathParam("id") Integer id) throws InterruptedException {

Thread.sleep(5000L);


}

}

@Path("books")


@GET

@Path("{id}")


public Response read(@PathParam("id") Integer id) throws InterruptedException {



}

}

Simulando um

processamento pesado.

@Test

public void buscaOLivroDeFormaAssincrona() {

WebTarget target = ClientBuilder.newClient()

.target("http://localhost:8080/rest-example/resources")

.path("books/10");

Future<Book> asyncResponse = target.request().async().get(Book.class);

System.out.println("Cancelado: " + asyncResponse.isCancelled());


System.out.println("Finalizado: " + asyncResponse.isDone());



assertThat(asyncResponse.get(), notNullValue());

}

@Test




.path("books/10");








}

@Test




.path("books/10");








}

@Test




.path("books/10");








}

@Test




.path("books/10");


System.out.println("Cancelado: " + asyncResponse.isCancelled()); // false






}

@Test




.path("books/10");








}

@Test




.path("books/10");








}

@Test




.path("books/10");




System.out.println("Finalizado: " + asyncResponse.isDone()); // false




}

@Test




.path("books/10");








}

@Test




.path("books/10");








}

@Test




.path("books/10");






System.out.println("Finalizado: " + asyncResponse.isDone()); // true


}

@Test




.path("books/10");






System.out.println("Finalizado: " + asyncResponse.isDone()); // true


}

Timeout no método get()JSR 236 - Concurrency Utilities for JavaTM EE

@Testpublic void buscaOLivroDeFormaAssincrona() {

WebTarget target = ClientBuilder.newClient().target("http://localhost:8080/rest-example/resources").path("books/10");


assertThat(asyncResponse.get(20L, TimeUnit.SECONDS), notNullValue());}













Posso enviar um InvocationCallback?



target.request().async().get(new InvocationCallback<Book>() {

public void completed(Book book) {assertThat(book, notNullValue());

}

public void failed(Throwable throwable) {fail();

}

});

}





}


}

});

}





}


}

});

}





}


}

});

}

Assíncrono no servidor......se você quiser!

Primeiro, sem EJB...

@Path("async/books")

public class AsyncBookResource {

@GET

@Path("/")


public void longRunningOperation(@Suspended final AsyncResponse asyncResponse) {

Runnable command = new Runnable() {

public void run() {


asyncResponse.resume(new Book());

}

};

Executors.newSingleThreadExecutor().execute(command);

}

}



@GET

@Path("/")




public void run() {



}

};


}

}



@GET

@Path("/")




public void run() {



}

};


}

}



@GET

@Path("/")




public void run() {



}

};

Executors.newSingleThreadExecutor().execute(command); // JSR 236

}

}



@GET

@Path("/")




public void run() {



}

};


}

}



@GET

@Path("/")




public void run() {



}

};


}

}

E se for com EJB?

@Stateless



@GET

@Path("/")

@Asynchronous





}

}

EJB 3.1 (Java EE 6)

@Stateless



@GET

@Path("/")

@Asynchronous





}

}

@Stateless



@GET

@Path("/")

@Asynchronous





}

}

@Stateless



@GET

@Path("/")

@Asynchronous





}

}

Filters and Interceptors

O que são os filters?

ClientRequestFilter

ClientResponseFilter

@Provider

public class LoggingFilter implements ClientRequestFilter, ClientResponseFilter {

public void filter(ClientRequestContext requestContext) throws IOException {

log(requestContext);

}

public void filter(ClientRequestContext requestContext, ClientResponseContext

responseContext) throws IOException {

log(responseContext);

}

}

@Provider




}




}

}

@Provider




}




}

}

@Provider




}




}

}

@Provider




}




}

}

ContainerRequestFilter

ContainerResponserFilter

@Provider

class LoggingFilter implements ContainerRequestFilter, ContainerResponseFilter {

public void filter(ContainerRequestContext requestContext) throws IOException {


}

public void filter(ContainerRequestContext requestContext,

ContainerResponseContext responseContext) throws IOException {


}

}

@Provider




}




}

}

@Provider




}




}

}

@Provider




}




}

}

@Provider




}




}

}

O que são os interceptors?

ReaderInterceptor

WriterInterceptor

Descompactando a requisição

@Provider

public class GzipReaderInterceptor implements ReaderInterceptor {

Object aroundReadFrom(ReaderInterceptorContext ctx) ... {

if (isGzipped(ctx)) {

InputStream old = ctx.getInputStream();

ctx.setInputStream(new GZIPInputStream(old));

try {

return ctx.proceed();

} finally {

ctx.setInputStream(old);

}

} else {


}

}

}

@Provider






try {


} finally {


}

} else {


}

}

}

@Provider






try {


} finally {


}

} else {


}

}

}

@Provider






try {


} finally {


}

} else {


}

}

}

Compactando a resposta

@Provider

public class GzipWriteInterceptor implements WriteInterceptor {

void aroundWriteTo(WriterInterceptorContext ctx) ... {

OutputStream old = ctx.getOutputStream();

GZIPOutputStream gzipOutputStream = new GZIPOutputStream(old);

ctx.setOutputStream(gzipOutputStream);

updateHeaders(ctx);

try {

ctx.proceed();

} finally {

gzipOutputStream.finish();

ctx.setOutputStream(old);

}

}

}

@Provider






updateHeaders(ctx);

try {

ctx.proceed();

} finally {



}

}

}

@Provider






updateHeaders(ctx);

try {

ctx.proceed();

} finally {



}

}

}

@Provider






updateHeaders(ctx);

try {

ctx.proceed();

} finally {



}

}

}

Mas, qual é a diferençamesmo?

Filters: Acesso ao contexto do request/response.

Exemplo de Filters

Logar origem do request.

Verificar qual o método http utilizado.

Qual a URI.

Interceptors: Acesso ao contexto damensagem.

Exemplo de Interceptors

Compactar o conteúdo da mensagem a ser enviada.

Descompactar o conteúdo da mensagem a ser lida.

Posso logar minhas requisiçõesantes de chegar ao método?

@PreMatching

@Provider@PreMatchingpublic class HttpPreMatchingFilter implements ContainerRequestFilter {

public void filter(ContainerRequestContext requestContext) throws IOException {...

}

}



}

}



}

}

Mas se eu quiser logar um método específico, é possível?

@NameBinding

@NameBinding@Target({ ElementType.TYPE, ElementType.METHOD })@Retention(value = RetentionPolicy.RUNTIME)public @interface Logged {}

Similar aos qualificadores do

CDI

@Provider @Loggedpublic class LoggingFilter implements ContainerRequestFilter, ContainerResponseFilter {

...}

@Path("/")public class MyResourceClass {

@GET@Logged@Path("{name}")@Produces("text/plain")public String hello(@PathParam("name") String name) {

return "Hello " + name;}

}

E a ordem? Posso definir?

@Priority

@Provider@Authenticated@Priority(Priorities.AUTHENTICATION)public class AuthenticationFilter implements ContainerRequestFilter{

...}

Modifier and Type Constant Field Value

public static final int AUTHENTICATION 1000

public static final int AUTHORIZATION 2000

public static final int ENTITY_CODER 3000

public static final int HEADER_DECORATOR 4000

public static final int USER 5000

javax.ws.rs.Priorities

Bean ValidationJSR-349

Como eu aplico?

public class Book {

private Integer id;

@NotNullprivate String name;

private String description;private Integer year;private String genero;

}

@POST@Consumes(MediaType.APPLICATION_JSON)public Response create(@Valid Book book) {

ResponseBuilder rb = Response.ok(createObject(book));return rb.build();

}

@GET@Path("/year/{year}")@Produces(MediaType.APPLICATION_JSON)public Response listByYearAndName(@Max(2015) @PathParam("year") Integer year, @QueryParam("name") String name) {

List<Book> books = getListByYearAndName(year, name);ResponseBuilder rb = Response.ok(books);return rb.build();

}

HATEOAS

Hipermídia como motor do estado do aplicativo

“If the engine of application is not being driven by hypertext, then it cannot be RESTful and

cannot be a REST API” (Roy T. Fielding)

Book Purchase

Related Books

Author

Receipt

/books/1/author

/books/genre/programming

/books/1/purchase

/books/1/purchase/12/receipt

/books/1

Exemplo

Link: <http://gujavasc.org/resources/books/1/purchase>; rel=purchase, …

<book>

<id>1</id>

<year>2013</year>

<name>REST in practice</name>

<genre>programming</genre>

<author>http://gujavasc.org/resources/books/1/author</author>

<related>http://gujavasc.org/resources/books/genre/programming</related>

</book>

Links

Transicionais

Links

Estruturais

Links Transicionais

@GET

@Path("{id}")


public Response read(@PathParam("id") Integer id, @Context UriInfo uriInfo){

Link purchaseLink = Link.fromPath(uriInfo.getRequestUri().toString() + "/purchase")

.rel("purchase")

.build();

return Response.ok(readObject(id))

.links(purchaseLink)

.link(uriInfo.getRequestUri().toString() + "/genre/programming", "genre")

.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Links Transicionais

@GET

@Path("{id}")




.rel("purchase")

.build();




.build();

}

Integração com Java EE

Managed Beans

CDI

EJB

Bean Validation

JSON API

OBRIGADO!

Daniel Cunha (Soro) - @dvlc_

Ivan Junckes Filho - @ivanjunckes

Ricardo Longa - @ricardolonga

https://github.com/gujavasc/jaxrs2

JSR 339 - Java API for RESTful Web Services

Text of JSR 339 - Java API for RESTful Web Services

JCP State of the Nation FOSDEM 2013 · 2014-01-02 · •JSR 339, Java API for RESTful Web Services 2.0 & JSR 353, Java API for JSON Processing, are the most popular JSRs, being adopted

Java Community Process (JCP) Program€¦ · 12/03/2013 · 3 Updated JSRs JSR 338: Proposed Final Draft – Java Persistence 2.1; Oracle JSR 339: Proposed Final Draft – JAX-RS

RESTful Server Configuration with iDRAC RESTful API€¦ · RESTful Server Configuration with iDRAC RESTful API Dell EMC Customer Solutions Center October 2018 Authors ... RESTful

The First IoT JSR: Units of Measurement JSR-363 [BOF5981]

Web Services - Clarivate Analytics · • JSR 311: Java API for RESTful Web Services (JAX-RS) • WADL 1.1 standard • XML Version 1.0 • Formats: XML. JSON • Protocol: HTTPS

Java User Group Ostfalen 8. September 2011 · 2018-09-06 · • JSR 340: Java Servlet 3.1 Specification • JSR 339: JAX-RS 2.0: The Java API for RESTful Web Services • JSR 338:

Joko Java kiehuu kännykässä? - TUNI · – JSR 120/205: Wireless Messaging API – JSR 135: J2ME Mobile Media API – JSR 172: J2ME Web Services – JSR 179: Location API for J2ME

RESTful Web Services [email protected]. What is RESTful?

Tuesday, 24 January 12 - JBoss · • JAX-RS – RESTful Web Services (JSR 311) • Create web services without WSDL • CDI – Context & Dependency Injection (JSR 299) • Reference

JSR 359 SIP Servlet 2 - Java Community Process · •List the significant dates in the history of the JSR. – 2nd July 2012 : JSR submitted – 30th July 2012: JSR Approved – 15th

java-ee · Java Message Service API 2.0 JSR 343 API (JTA) 1.2 JSR 907 JavaMail 1.5 JSR 919 RESTful (JAX-RS) 2.0 Java API JSR 339 1.3 JSR 109 XML JAX API (JAX-WS) 2.2 JSR 224 Java

JAX-RS: Java API for RESTful Web Servicesdownload.oracle.com/otn-pub/jcp/jaxrs-2_0-pr-spec/339...JAX-RS: Java API for RESTful Web Services Version 2.0 Public Review September 26, 2012

Java Enterprise Editie 7betavzw.org/sites/default/files/bestanden/JavaEE7.pdf · 2016-06-20 · ... (JSR 339): Java API for RESTful Web Services JSON-P(JSR(353): Java API for JSON

Magento jsr

RESTFul Web Services for Java - JBoss.org Documentationdocs.jboss.org/resteasy/.../userguide/pdf/RESTEasy_Reference_Guide.pdf · Chapter 1. 1 Overview JAX-RS, JSR-311, is a new JCP

JAX-RS 2.0: RESTful Java on Steroids - Coding the Webmarek.potociar.net/wp-content/uploads/Devoxx-2011-JAXRS... · 2011-11-17 · ... RESTful Java on Steroids What’s in JSR-339?

Java EE 7: the New Cloud Platform - Java User Group … · 2013-10-17 · Web Container Extensions JMS 2.0 Jcache 1.0 ... – Java API for RESTful Services 2.0 (JSR 339) ... Java

Adopt-a-JSR for JSON Processing 1.1, JSR 374

RESTful Server Configuration with iDRAC RESTful API

RESTdonatas/PSKurimas... · 2017-04-13 · Unlike SOAP-based web services, ... Java API for XML –Restful Services JSR 339: ... Standardizes RESTful Service API for Java EE

Java EE 7とJava SE 8による並行プログラミン · 2.0（JSR 339、 Java API for RESTful Web Services）での非同期HTTP処理の直接サポートや、WebSocket のサポートが行わ

Place in Time: Contextualizing Criseskena/classes/7818/f08/lectures/place_in_time.pdfJAX-RS: Java API for RESTful Web Services (JSR 311) Jersey Reference Implementation GlassFish Application

RESTEasy JAX-RS...JAX-RS 2.0 (JSR-339) and JAX-RS 2.1 (JSR-370), are JCP specifications that provide a Java API for RESTful Web Services over the HTTP protocol. RESTEasy is a portable

Specialty Elastomer Dept. JSR NBR JSR (Shanghai) Co., Ltd. 카다로그(JSR).pdf · Mold Fouling Resistance JSR NBR is based on a polymer design that adjusts non-rubber content and

RESTEasy JAX-RS - JBoss...JAX-RS 2.0 (JSR-339) and JAX-RS 2.1 (JSR-370), are JCP specifications that provide a Java API for RESTful Web Services over the HTTP protocol. RESTEasy is

JAX-RS 2.0: What’s New in JSR 339 ?

1 Copyright © 2012, Oracle and/or its affiliates. All rights reserved. · 2012-11-12 · JAX-RS 2.0 (JSR-339) is the next version of a successful Java API for building RESTful web

5. RESTful Web Services - home.edvsz.hs-osnabrueck.dehome.edvsz.fh-osnabrueck.de/skleuker/WS14_KbSE/WS1415... · 2014-12-07 · •JSR 339: JAX-RS 2.0: The Java API for RESTful Web

Security Testing For RESTful Applications - WordPress.com · 2013-04-06 · About RESTful Web Services • RESTful WS in the Wild • Security of RESTful WS • Pen-testing RESTful

5. (RESTful) Web Serviceshome.edvsz.hs-osnabrueck.de/skleuker/WS17_KbSE/WS17KbSE... · 2017-11-27 · •JSR 353: JavaTM API for JSON Processing (23.5.2013) ... •JSR 339: JAX-RS

Software

JSR 339 - Java API for RESTful Web Services

Text of JSR 339 - Java API for RESTful Web Services