Início / Enterprise / Servlet versus JAX-RS
Enterprise Intermediário

Servlet versus JAX-RS

Substitua o boilerplate verboso de HttpServlet por classes de recurso JAX-RS declarativas.

Comparação de Código
✕ Java EE 
@WebServlet("/users")
public class UserServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req,
                         HttpServletResponse res)
            throws ServletException, IOException {
        String id = req.getParameter("id");
        res.setContentType("application/json");
        res.getWriter().write("{\"id\":\"" + id + "\"}");
    }
}
✓ Jakarta EE 8+ 
@Path("/users")
public class UserResource {
    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Response getUser(
            @QueryParam("id") String id) {
        return Response.ok(new User(id)).build();
    }
}
Viu um problema com este código? Nos avise.
Por que a forma moderna ganha
📐

Roteamento declarativo

Anotações definem método HTTP, caminho e content type em vez de dispatch imperativo com if/else.

🔄

Marshalling automático

Retorne POJOs diretamente; o runtime os serializa para JSON ou XML com base em @Produces.

🧪

Testes mais fáceis

Classes de recurso são objetos Java simples, testáveis sem um container de servlets.

Abordagem Antiga
HttpServlet
Abordagem Moderna
JAX-RS Resource
Desde o JDK
11
Dificuldade
Intermediário
Suporte JDK
Servlet versus JAX-RS
Disponível

Amplamente disponível desde o Jakarta EE 8 / Java 11

Como funciona

JAX-RS (Jakarta RESTful Web Services) permite expor endpoints REST usando anotações simples como @GET, @Path e @Produces. Sem mais parsing manual de parâmetros de requisição ou definição de content types na resposta — o runtime cuida do marshalling e do roteamento automaticamente.

Documentação Relacionada
Jakarta RESTful Web Services Specification ↗ Jakarta REST 3.1 API ↗
Padrões relacionados
Enterprise Intermediário

EJB versus CDI

Java EE
@Stateless
public class OrderEJB {
    @EJB
    private InventoryEJB inventory;

    public void placeOrder(Order order) {
        // container-managed transaction
        inventory.reserve(order.getItem());
    }
}
Jakarta EE 8+
@ApplicationScoped
public class OrderService {
    @Inject
    private InventoryService inventory;

    @Transactional
    public void placeOrder(Order order) {
        inventory.reserve(order.getItem());
    }
}
Passe o mouse para ver o moderno ➜
JDK 11+ →
Enterprise Intermediário

JDBC versus JPA

Java EE
String sql = "SELECT * FROM users WHERE id = ?";
try (Connection con = dataSource.getConnection();
     PreparedStatement ps =
             con.prepareStatement(sql)) {
    ps.setLong(1, id);
    ResultSet rs = ps.executeQuery();
    if (rs.next()) {
        User u = new User();
        u.setId(rs.getLong("id"));
        u.setName(rs.getString("name"));
    }
}
Jakarta EE 8+
@PersistenceContext
EntityManager em;

public User findUser(Long id) {
    return em.find(User.class, id);
}

public List<User> findByName(String name) {
    return em.createQuery(
        "SELECT u FROM User u WHERE u.name = :name",
        User.class)
        .setParameter("name", name)
        .getResultList();
}
Passe o mouse para ver o moderno ➜
JDK 11+ →
I/O Iniciante

Modern HTTP client

Java 8
URL url = new URL("https://api.com/data");
HttpURLConnection con =
    (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
// read lines, close streams...
Java 11+
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.com/data"))
    .build();
var response = client.send(
    request, BodyHandlers.ofString());
String body = response.body();
Passe o mouse para ver o moderno ➜
JDK 11+ →
Compartilhar 𝕏 🦋 in ⬡