Главная / Enterprise / Servlet против JAX-RS
Enterprise Средний

Servlet против JAX-RS

Замените многословный шаблонный код HttpServlet декларативными классами ресурсов JAX-RS.

Сравнение кода
✕ 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();
    }
}
Заметили проблему в этом коде? Сообщите нам.
Почему современный подход лучше
📐

Декларативная маршрутизация

Аннотации определяют HTTP-метод, путь и Content-Type вместо императивного if/else-диспатчинга.

🔄

Автоматическая маршализация

Возвращайте POJO напрямую; среда выполнения сериализует их в JSON или XML на основе @Produces.

🧪

Упрощённое тестирование

Классы ресурсов — это простые Java-объекты, тестируемые без Servlet-контейнера.

Старый подход
HttpServlet
Современный подход
JAX-RS-ресурс
Начиная с JDK
11
Сложность
Средний
Поддержка JDK
Servlet против JAX-RS
Доступно

Широко доступно начиная с Jakarta EE 8 / Java 11

Как это работает

JAX-RS (Jakarta RESTful Web Services) позволяет предоставлять REST-эндпоинты с помощью простых аннотаций, таких как @GET, @Path и @Produces. Никакого ручного разбора параметров запроса или установки Content-Type в ответе — среда выполнения берёт на себя маршализацию и маршрутизацию автоматически.

Связанная документация
Jakarta RESTful Web Services Specification ↗ Jakarta REST 3.1 API ↗
Доказательство
Посмотреть исходник доказательства ↗
Похожие шаблоны
Enterprise Средний

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());
    }
}
Наведите, чтобы увидеть современный ➜
JDK 11+ →
Enterprise Средний

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();
}
Наведите, чтобы увидеть современный ➜
JDK 11+ →
I/O Начинающий

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();
Наведите, чтобы увидеть современный ➜
JDK 11+ →