JAX-RS 2.0

JAX-RS 2.0
As novidades do padrão para desenvolvimento REST
Fabio Velloso
Wednesday, September 18, 13

Fabio Velloso
• Bacharel em Ciência da Computação pela Universidade Federal
de São Carlos - UFSCar
• Fundador do SouJava
• Desenvolvendo projetos com tecnologia Java desde 96
• Professor de SOA e Web Services do curso de Pós-Graduação
"Lato-Sensu" em Desenvolvimento de Software para Web da
UFSCar
• Gerente de Arquitetura da Telefonica | VIVO
• Atualmente desenvolve projetos pessoais com Big Data, Cloud,
Design Thinking, Service Design e Economia Criativa

Agenda
• REST
• Conceitos
• JAX-RS
• Conceitos e principais anotações
• JAX-RS 2.0
• Novidades

REST
• Estilo de arquitetura e suas restrições
• Recursos identiﬁcados unicamente por uma URI
• Interface uniforme (GET, POST, PUT, DELETE)
• Componentes REST manipulam recursos alterando sua
representação
• Mensagens auto-descritivas e sem estado ou “stateless”
• Informações podem estar em cache
• Multiplas representações
• Hypermedia

Aplicação CRUD com REST
• Consultar o livro por seu ID
GET http://www.soujava.org.br/books/123
• Adicionar um livro
POST http://www.soujava.org.br/books
• Alterar um livro
PUT http://www.soujava.org.br/books
• Remover o livro pelo ID
DELETE http://www.soujava.org.br/books/123

<book>
<id>123</id>
<name>Java: The Good Parts </name>
<author>Jim Waldo</author>
<isbn>0596803737</isbn>
<isbn13>978-0596803735</isbn13>
</book>

Java API for RESTful Web Services - JSR 331
• Suporte a RESTful em Java
• API padronizada
• Programação declarativa
• Anotações
• POJO
• Integrado ao JEE6 (JSR 313)

Recurso
Recurso

Recurso
Recurso
Método HTTP

Recurso
Recurso
Método HTTP
Serialização
Serialização

• @Path, @PathParam, @Produces, @Consumes
@HeaderParam, @QueryParam, @MatrixParam
@NewCookie
Recurso
Recurso
Método HTTP
Serialização
Serialização

JAX-RS 2.0 Java API for RESTful Web Services
• JSR 339
• Client API
• Validação
• Filters e Interceptors
• Processamento assíncrono
• Melhorias
• ResourceTemplate
• Link
JAX-RS 2.0JCP JAVA
EXTRA!!

Client API
• Objetivos:
• Encapsular os conceitos e principais restrições da
arquitetura REST como artefatos Java em clientes
• Facilitar o consumo de RESTfull Web Services
• como JAX-RS facilitou desenvolvimento no servidor
• Compartilhar conceitos comuns entre client e server
JAX-RS

Client API
• Padronização da API client
• Portável entre implementações
• Consumo de Web Services expostos sobre HTTP
• Pode acessar serviços REST construídos em outras
linguagens e frameworks
• ou acessar extensões como Web Dav
• Setar parâmetros e conﬁgurações
• Form, headers, SSL

Client API
• Classes e interfaces mais importantes
• Client
• Usada para criar e acessar “web resources” e
conﬁgurar propriedades de conexões e requisições
• ClientBuilder.newClient();
• WebTarget
• encapsula um Web resource
• podendo criar e envia-lo requests e processar seus
responses
• .get() , .post() , .put() , .delete()

Client API
• Client API com todos objetos
• Fluent API

Client API
• Invocation
• Requisição preparada e pronta a ser executada
• Interface genérica (command) com clara separação de
conceitos:
• Creator - cria a requisição
• Submitter - envia a requisição
• Não precisa conhecer como o “Invocation” é
preparado e sim quando e como ele é executado
• Forma síncrona
• Forma assíncrona

Client API
• Invocation
Invocation inv1 = client.target("http://examples.org/atm/balance")
.queryParam("card", "111122223333")
.queryParam("pin", "9876").request("text/plain").buildGet();
Invocation inv2 = client.target("http://examples.org/atm/withdrawal")
.queryParam("card", "111122223333").queryParam("pin", "9876")
.request().buildPost(text("50.0")));
Collection<Invocation> invs = Arrays.asList(inv1, inv2);
Collection<Response> ress =
Collections.transform(invs,
new F<Invocation, Response>() {
@Override
public Response apply(Invocation inv) {
return inv.invoke(); } });

Client API
• Setar parâmetros do request
• “ﬂuent” api
• Form

Client API
• Setar parâmetros do request
• “ﬂuent” api
• Form
Objeto JAXB

Validation
• Veriﬁca o conteúdo e formação de um ou mais campos
• Utiliza Beans Validation
• Suporte por anotações de validação em:
• Campos e propriedades
• Métodos (response entities)
• Resource classes
• Parâmetros (inclusive request entity)
• lança javax.validation.ValidationException

Validation
• @NotNull
• Variﬁca se o campo é nulo
• se nulo javax.validation.ValidationException

Validation
• Aplicável a campos
@Path("/")
public class UserResource {
@NotNull
@FormParam("userName")
private String userName;
• Aplicável a métodos
@NotNull
@FormParam("userName")
public void setUserName(String userName) {
this.username = userName;
}

Validation
• Aplicável a recursos
@Path("/createUser")
@PhoneRequired
public class CreateUserResource {
@FormParam("homePhone")
private Phone homePhone;
@FormParam("mobilePhone")
private Phone mobilePhone;
}

Validation
• @Pattern com expressões regulares
• javax.validation.constraints.Pattern
• Erro - HTTP Status 400 - Bad Request

Validation
• @Valid
• valida no método classes que tem “constraints”
public class Book {
private int id;
@NotNull
private String name; ...}
@POST
@Consumes(MediaType.APPLICATION_XML)
public void createBook(@Valid BookConstraints book) {
//Executa criacão }
• Erro na validação (ValidationException) retorna
• HTTP 400 ou HTTP 500

Validation
• Custom Validation
• Validação deﬁnida pelo desenvolvedor
• Implementar a interface ConstraintValidator

Filters
• Utilizados para modiﬁcar requests e responses
• Adicionar e/ou alterar headers
• Filtros podem ser server side e/ou client side
• ContainerRequestFilter
• ContainerResponseFilter
• ClientResponseFilter
• ClientRequestFilter

ContainerResponseFilters
• Utilizado para modiﬁcar response
• alterando Headers
• Classe tem de implementar ContainerResponseFilter
• Filtros são aplicados globalmente em todos recursos da
aplicação por padrão

ContainerResponseFilters
• Filtros por padrão são chamados de globais
• e aplicados a todos os recursos da aplicação
• Anotação @NameBinding
• Altera o comportamento padrão
• Especiﬁca a quais recursos o ﬁltro é aplicado
• Filtros com essa característica são chamados name-bound

@NameBinding - passos
• Deﬁnir a Interface e anotação
• Deﬁnir e anotar a classe com @Provider e @<nome>

@NameBinding - passos
• Anotar os recursos para o ﬁltro
• Todos os ﬂitros são executados como pos matching
• Executados após selecionar qual método deve ser acessado
para cada request
• Pode ser alterado usando a anotação @PreMatching
• são executados antes do iniciar o “matching”

ContainerRequestFilters
• Similares aos ResponseFilters
• Possibilitam alteram os parâmetros do request
• Não possuem parâmetro ContainerResponseContext
• RequestFilters são executados como post-matching
• executados após o recurso a ser executado ser
“encontrado”
• GET, POST, PUT ou DELETE
• Pode-se alterar utilizando a anotação @PreMatching
• executa o ﬁltro antes do “matching” do método

ContainerRequestFilters
• @PreMatching
• Altera todos os métodos PUT para POST
• Assume que o código a ser executado é o mesmo

Interceptors
• Manipular input/output streams
• Podem ser utilizados no cliente ou server
• Dois tipos de Interceptors
• ReaderInterceptors (manipulam stream de entrada)
• WriterInterceptors (manipulam streams de saída)
• Interceptors são globais (aplicados a todos os recursos)
• Anotação @NameBinding (name-bound)
• Especiﬁca a quais recursos o ﬁltro é aplicado

Interceptors

Asynchronous Processing
• Possibilita o processamento multithread no servidor,
aumentando o seu throughput
• Libera a thread do servidor para executar outras tarefas
• Processamento executa em outra thread ou espera em
uma ﬁla até execução
• Quando recebe a resposta envia para o client
• @Suspended indica que o método será executado de
maneira assíncrona
• Possível setar timeout, portanto faça!

@Suspended
método assíncrono

@Suspended
método assíncrono
Nova thread

@Suspended
método assíncrono
Nova thread
retorna void

@Suspended
método assíncrono
Nova thread
Executa na
nova thread
retorna void

@Suspended
método assíncrono
Nova thread
Executa na
nova thread
retorna void
retorna o
resultado

Asynchronous Processing - timeout

Cria
TimeoutHandler

Deﬁne
mensagem de
erro
Cria
TimeoutHandler

Deﬁne
mensagem de
erro
Cria
TimeoutHandler
Lança uma
ServiceUnavailable
Exception
Mapeada em 503,
"Service
Unavailable" HTTP
error response

Deﬁne timeout e
unidade
Deﬁne
mensagem de
erro
Cria
TimeoutHandler
Lança uma
ServiceUnavailable
Exception
Mapeada em 503,
"Service
Unavailable" HTTP
error response

• Cliente assíncrono
• Arquiteturas fracamente acopladas

Deﬁne a
execução
assíncrona

Deﬁne a
execução
assíncrona
Representa o
resultado de
processamento
assíncrono

JAX-RS 2.0
• Novas funcionalidades para “build” de URIs
• Possibilida de uso de “templates” na classe UriBuilder
• método resolveTemplate()
• Resultado:
• http://www.thedevelopersconference.com.br/2013?
trilha=JavaEE

JAX-RS 2.0
• Classe Link
• Implementa RFC 5988 (Web Link)
• Inserir metadados em mensagens HTTP
• Link é serializado em um HTTP Response como um header
HTTP
• Representa um link hypermedia

Richardson Maturity Model
• Nível 0
• POX
• URI única
• Nível 1
• URIs, verbo único
• Nível 2
• CRUD
• URIs, verbos
• Nível 3
• Hypermedia
• RESTful Service POX
Recursos
Verbos HTTP
Controles
Hypermedia

Hypermedia
• Links para declarar próximos passos
• Links para descrever transições de estado
• Navegação altera estado do recurso
• Máquina de estados e workﬂow
• XHTML, ATOM , JSON

JAX-RS 2.0
• Link
• adicionando links a um objeto Response
• Consumindo em um cliente

Link: <http://.../orders/1/review>;rel=review;op=POST
Link: <http://.../orders/1/cancel>;rel=cancel;op=POST
<order>
<id>1</id>
<customer>http://.../customers/21</customer>
<shippingAddress>http://.../customers/21/address/1<shippingAddress>
<orderItems>
<product>http://.../products/3345</product>
<quantity>1</quantity>
</orderItems>
<status>RECEIVED</status>
</order>
Hypermerdia
Reviewed
Canceled
Payed
Refunded
Received Shipped

OBRIGADO !!!!!

OBRIGADO !!!!!
fabio@soujava.org.br
@fabiovelloso

OBRIGADO !!!!!
fabio@soujava.org.br
@fabiovelloso
facebook.com/soujava
@soujava
soujava.org.br

JAX-RS 2.0

Mais conteúdo relacionado

Semelhante a JAX-RS 2.0

JAX-RS 2.0