ホーム / 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メソッド・パス・コンテンツタイプをアノテーションで定義し、命令型のif/elseディスパッチは不要です。

🔄

自動マーシャリング

POJOを直接返すだけで、@Producesに基づいてJSONやXMLにシリアライズされます。

🧪

テスト容易

リソースクラスはプレーンなJavaオブジェクトで、サーブレットコンテナなしでテストできます。

旧来のアプローチ
HttpServlet
モダンなアプローチ
JAX-RSリソース
JDKバージョン
11
難易度
中級
JDKサポート
ServletとJAX-RSの比較
利用可能

Jakarta EE 8 / Java 11以降、広く利用可能

仕組み

JAX-RS（Jakarta RESTful Web Services）では@GET・@Path・@Producesなどのシンプルなアノテーションを使ってRESTエンドポイントを公開できます。リクエストパラメーターの手動解析やレスポンスのコンテンツタイプ設定は不要で、ランタイムがマーシャリングとルーティングを自動的に処理します。

関連ドキュメント
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+ →
共有 𝕏 🦋 in ⬡