Learn Java Jakarta RESTful Web Services / JAX-RS

Evolusi JAX-RS menuju Jakarta RESTful Web Services, perubahan namespace javax ke jakarta, versi, kompatibilitas, dependency, dan strategi migrasi.

REST Runtime Mental Model

15 min

Mental model runtime Jakarta REST dari HTTP request masuk sampai response keluar, termasuk resource matching, method selection, provider pipeline, filter/interceptor, exception mapping, dan failure diagnosis.

Application Configuration

11 min

Konfigurasi aplikasi Jakarta REST dengan Application, ApplicationPath, component discovery, explicit registration, servlet mapping, deployment boundary, dan convention production untuk API base path.

Resource Class Design

Desain resource class Jakarta REST sebagai boundary HTTP yang stabil, eksplisit, testable, dan tidak bocor domain/persistence concern.

HTTP Method Semantics in Jakarta REST

19 min

Semantik HTTP method dalam Jakarta REST, termasuk safety, idempotency, retry, status code, resource mutation, dan desain endpoint yang benar untuk production API.

URI Design and Resource Modeling

Desain URI dan resource model untuk Jakarta REST yang stabil, evolvable, mudah dioperasikan, dan tidak berubah menjadi RPC berbasis path.

Parameter Injection

Parameter injection Jakarta REST secara mendalam, termasuk path, query, header, cookie, matrix, bean param, default value, conversion, encoding, dan validation boundary.

Content Negotiation

Content negotiation in Jakarta REST: media types, @Consumes, @Produces, Accept, Content-Type, q/qs, 406/415, variants, and production API contract discipline.

MessageBodyReader and MessageBodyWriter

12 min

MessageBodyReader and MessageBodyWriter internals in Jakarta REST: provider selection, media type capabilities, custom providers, streaming, generic types, priority, and failure modeling.

JSON Binding and JSON Processing

16 min

JSON in Jakarta REST: JSON-B, JSON-P, Jackson, DTO contract discipline, Java records, enum/date handling, null semantics, and backward-compatible API evolution.

Multipart Form and Binary Payloads

15 min

Multipart, form requests, file upload, download responses, binary streaming, memory safety, security scanning, and production upload/download architecture in Jakarta REST.

Response API, Status, and Headers

14 min

Response API, status code discipline, headers, links, caching, validators, conditional requests, and production response contracts in Jakarta REST.

Exception Mapping and Error Contracts

15 min

ExceptionMapper, WebApplicationException, error taxonomy, problem details, mapper resolution, security-safe failures, and production error contracts in Jakarta REST.

Validation Boundary

17 min

Validation boundary untuk Jakarta REST: Bean Validation, request DTO, method validation, groups, cross-field validation, partial update, error contract, dan defensive API input modeling.

API Contract Design

API contract design untuk Jakarta REST: DTO evolution, compatibility, pagination, filtering, sorting, sparse fieldsets, versioning, deprecation, OpenAPI, consumer contracts, dan governance.

Provider Model

14 min

Provider model Jakarta REST sebagai extension architecture: @Provider, discovery, registration, priority, Feature, DynamicFeature, portability, dan governance provider di production REST systems.

Filters and Interceptors

Filter dan interceptor pipeline Jakarta REST: ContainerRequestFilter, ContainerResponseFilter, ReaderInterceptor, WriterInterceptor, priority, name binding, audit, auth, logging, CORS, security headers, dan failure modeling.

Context Injection

11 min

Context injection Jakarta REST: @Context, UriInfo, HttpHeaders, Request, SecurityContext, ResourceInfo, ResourceContext, Providers, Configuration, thread-safety, proxy semantics, dan runtime state boundary.

Security in Jakarta REST

Security in Jakarta REST: authentication boundary, authorization, SecurityContext, roles, CORS, CSRF, trust boundaries, sensitive data, rate limiting, audit, and secure failure modeling.

Jakarta REST Client API Mental Model

19 min

Master the Jakarta REST Client API as an outbound HTTP integration boundary: Client, WebTarget, Invocation, Response, providers, filters, DTO mapping, and resource ownership.

Client Resilience

Design resilience for Jakarta REST clients: timeout budgets, retries, circuit breakers, bulkheads, idempotency keys, failure classification, observability, and fallback boundaries.

MicroProfile REST Client

MicroProfile REST Client sebagai typed outbound API client di ekosistem Jakarta REST, termasuk CDI integration, config, provider, exception mapping, resilience, observability, testing, dan production design.

Async Resources

14 min

Asynchronous resources di Jakarta REST, termasuk AsyncResponse, suspended request, CompletionStage, timeout, cancellation, executor ownership, backpressure boundary, virtual threads, failure cleanup, dan desain production-grade async APIs.

Server-Sent Events

17 min

Server-Sent Events in Jakarta REST: event streams, SseEventSink, SseBroadcaster, reconnect behavior, heartbeats, operational constraints, and production design patterns.

Performance and Resource Efficiency

Performance engineering for Jakarta REST services: request cost model, serialization, allocation, threading, async, virtual threads, connection pools, benchmarking, and tail latency.

Implementation Landscape

Implementation landscape for Jakarta RESTful Web Services: specification versus runtime, Jersey, RESTEasy, Apache CXF, Open Liberty, Payara, WildFly, Quarkus, portability discipline, and implementation-selection heuristics.

Quarkus REST and RESTEasy Classic

Deep dive into Quarkus REST versus RESTEasy Classic: RESTEasy Reactive history, build-time processing, Vert.x/event-loop runtime model, blocking versus non-blocking execution, migration traps, extension compatibility, and production design heuristics.

Packaging, Deployment, and Cloud Runtime

24 min

Packaging and deployment strategy for production Jakarta REST services across WAR, server runtime, executable JAR, native image, containers, probes, config, graceful shutdown, and cloud runtime contracts.

Observability

Observability for production Jakarta REST services: structured logging, access logs, metrics, distributed tracing, correlation IDs, audit events, OpenTelemetry, MicroProfile Telemetry, RED/USE signals, and operational debugging.

Testing Strategy

21 min

Layered testing strategy for production Jakarta REST services: resource tests, provider tests, filter tests, in-container tests, HTTP black-box tests, contract tests, resilience tests, security tests, and release confidence gates.

API Review Checklists

24 min

Production API review checklists for Jakarta REST services: resource design, HTTP semantics, validation, error contracts, security, compatibility, observability, performance, testing, deployment, migration, and regulated workflow readiness.

Production Patterns and Anti-Patterns

22 min

Production patterns and anti-patterns for Jakarta REST services: resource boundary discipline, DTO contracts, provider hygiene, exception mapping, idempotency, portability, testing, and operational failure modes.

Regulated Case Management API Design

19 min

Designing regulated case-management APIs with Jakarta REST: case resources, evidence, state transitions, decisions, escalation, auditability, idempotency, authorization, error taxonomy, and legal defensibility.

Capstone Production REST Service