Jersey (framework)

Jersey (framework)
Name	Jersey
Developer	Eclipse Foundation
Programming language	Java
Platform	Java SE
License	Eclipse Public License

Jersey (framework) is an open-source framework for building RESTful web services in the Java platform. It implements the JAX-RS specification and is maintained through community collaboration involving foundations and corporations. Jersey integrates with application servers, build tools, and cloud platforms to support development, testing, and deployment workflows.

Overview

Jersey implements the JAX-RS specification and interacts with the Java Platform, Standard Edition and Jakarta EE implementations such as GlassFish, WildFly, Payara, Apache TomEE to expose RESTful APIs. Contributors include communities around the Eclipse Foundation, corporations like Oracle Corporation, and projects associated with Apache Software Foundation and Red Hat. Jersey supports annotations specified by JAX-RS and aligns with related specifications such as Java API for RESTful Web Services and Servlet API to enable resource-oriented architectures for services consumed by clients like Android (operating system), iOS, and web applications built with Angular (application platform) or React (JavaScript library).

Features

Jersey provides support for JAX-RS annotations and features such as resource classes, entity providers, and filters compatible with Java Persistence API patterns and JSON binding tools. It integrates with data formats and libraries including Jackson (software), JSON-B, JAXB, and HK2 for dependency injection and lifecycle management. Additional capabilities include support for asynchronous processing influenced by CompletableFuture (Java), server-sent events reminiscent of HTTP/1.1 streaming models, and metrics integration with systems like Prometheus and Micrometer for observability in microservice architectures involving Kubernetes and Docker.

Architecture and Components

Jersey’s architecture centres on a runtime that implements the JAX-RS contract, using modules for runtime configuration, dependency injection, and media type handling. Core components include the ResourceConfig class, provider interfaces, and the integration layer with dependency injection frameworks such as HK2 and Spring Framework. Jersey’s media type handlers connect to libraries such as Jackson (software), MOXy, and Gson (software) while its client API parallels patterns found in Apache HttpClient and OkHttp. Integration with servlet containers leverages the Servlet API and can be deployed on servers like Jetty and Tomcat.

Usage and Examples

Typical usage involves annotating resource classes with JAX-RS annotations, configuring application bootstrap via ResourceConfig, and deploying to containers such as GlassFish or embedding in lightweight runtimes like Jetty. Examples often demonstrate CRUD endpoints interacting with Java Persistence API entities and serializing with Jackson (software) for clients implemented in Angular (application platform), React (JavaScript library), or mobile SDKs such as Android (operating system) and iOS. Build and CI workflows reference tools like Maven, Gradle, and integration testing frameworks such as JUnit and TestNG alongside container orchestration in Kubernetes for end-to-end verification.

Performance and Scalability

Performance characteristics depend on the underlying JVM implementation (for example OpenJDK or Oracle JDK), servlet container (for example Tomcat or Jetty), and JSON serializers like Jackson (software). Benchmarks often compare throughput and latency against frameworks such as Spring Framework's Spring MVC and Spring WebFlux or alternatives like Micronaut and Quarkus. For scalability, Jersey supports asynchronous I/O patterns and integrates with application servers and orchestration platforms like Kubernetes and Docker to enable horizontal scaling, observability with Prometheus, and resilience patterns promoted by Hystrix-style architectures.

Compatibility and Integration

Jersey is compatible with the JAX-RS specification and interoperates with Jakarta EE stacks and libraries such as Hibernate for persistence, EclipseLink for object-relational mapping, and Spring Framework for dependency injection. It can be integrated into CI/CD pipelines using Jenkins (software), GitLab CI/CD, or GitHub Actions and cloud providers including Amazon Web Services, Microsoft Azure, and Google Cloud Platform for deployment. Security integrations leverage standards and libraries such as OAuth 2.0, OpenID Connect, and JSON Web Token implementations to secure APIs in enterprise contexts like SAP SE or financial institutions.

History and Development

Jersey originated as the reference implementation for JAX-RS under stewardship tied to Oracle Corporation and evolved through community contribution, migrating stewardship to organizations such as the Eclipse Foundation and aligning with the transition from Java EE to Jakarta EE. Development milestones track releases that added support for newer JAX-RS versions, integration with dependency injection frameworks, and enhancements for reactive programming influenced by trends in MicroProfile, Cloud Native Computing Foundation, and broader shifts in enterprise Java ecosystems including projects like GlassFish and WildFly.

Category:Java libraries