Jersey 2.0 w/ Guice

This library adds support for Jersey 2.0 w/ Guice

License

License

Categories

Categories

GUI User Interface Guice Application Layer Libs Dependency Injection Square Business Logic Libraries Financial Jersey Program Interface REST Frameworks
GroupId

GroupId

com.squarespace.jersey2-guice
ArtifactId

ArtifactId

jersey2-guice
Last Version

Last Version

0.10
Release Date

Release Date

Type

Type

jar
Description

Description

Jersey 2.0 w/ Guice
This library adds support for Jersey 2.0 w/ Guice
Project URL

Project URL

https://github.com/Squarespace/jersey2-guice
Source Code Management

Source Code Management

https://github.com/Squarespace/jersey2-guice

Download jersey2-guice

How to add to project

<!-- https://jarcasting.com/artifacts/com.squarespace.jersey2-guice/jersey2-guice/ -->
<dependency>
    <groupId>com.squarespace.jersey2-guice</groupId>
    <artifactId>jersey2-guice</artifactId>
    <version>0.10</version>
</dependency>
// https://jarcasting.com/artifacts/com.squarespace.jersey2-guice/jersey2-guice/
implementation 'com.squarespace.jersey2-guice:jersey2-guice:0.10'
// https://jarcasting.com/artifacts/com.squarespace.jersey2-guice/jersey2-guice/
implementation ("com.squarespace.jersey2-guice:jersey2-guice:0.10")
'com.squarespace.jersey2-guice:jersey2-guice:jar:0.10'
<dependency org="com.squarespace.jersey2-guice" name="jersey2-guice" rev="0.10">
  <artifact name="jersey2-guice" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.squarespace.jersey2-guice', module='jersey2-guice', version='0.10')
)
libraryDependencies += "com.squarespace.jersey2-guice" % "jersey2-guice" % "0.10"
[com.squarespace.jersey2-guice/jersey2-guice "0.10"]

Dependencies

compile (5)

Group / Artifact Type Version
org.glassfish.jersey.containers : jersey-container-servlet-core jar 2.17
org.slf4j : slf4j-api jar 1.7.12
com.google.inject.extensions : guice-multibindings jar 4.0
com.google.inject.extensions : guice-servlet jar 4.0
com.google.code.findbugs : jsr305 jar 3.0.0

test (3)

Group / Artifact Type Version
org.testng : testng jar 6.8.21
org.glassfish.jersey.containers : jersey-container-servlet jar 2.17
org.eclipse.jetty : jetty-servlet jar 9.2.9.v20150224

Project Modules

There are no modules declared in this project.

Jersey 2.0 w/ Guice

Continuous Integration

Introduction

This library provides support for Jersey 2.0 w/ Guice similar to the way it used to work in Jersey 1.x with the jersey-guice library. It uses Guice's own GuiceFilter (like jersey-guice) and it's somewhat different from the Guice/HK2 Bridge.

Installation

Go to search.maven.org and search for g:"com.squarespace.jersey2-guice" AND a:"jersey2-guice-impl" to find the current release version.

Gradle

compile "com.squarespace.jersey2-guice:jersey2-guice-impl:${current.version}"

Maven

<dependency>
  <groupId>com.squarespace.jersey2-guice</groupId>
  <artifactId>jersey2-guice-impl</artifactId>
  <version>${current.version}</version>
</dependency>

Usage

Getting Started

Jersey/HK2 uses unfortunately SPIs and the Singleton pattern internally. Your code is effectively racing against the Servlet container's code and the first one to initialize HK2's ServiceLocatorGenerator inside its ServiceLocatorFactory wins.

This library uses two approaches to override HK2's own ServiceLocatorGenerator. It first tries to use a SPI and if it can't it'll fall back to reflection to replace a private static field. Regardless of the approach it's still a race against the Servlet container.

public static void main(String[] args) {

  List<Module> modules = new ArrayList<>();
  
  modules.add(new JerseyGuiceModule("__HK2_Generated_0"));
  modules.add(new ServletModule());
  modules.add(new AbstractModule() {
    @Override
    protected void configure() {
      // ...
    }
  });
  
  Injector injector = Guice.createInjector(modules);
  JerseyGuiceUtils.install(injector);
  
  // ... continue ...
}

Documentation

The User's Guide can be found in the Wiki.

Apache 2.0 License

Copyright 2014-2016 Squarespace, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
com.squarespace.jersey2-guice

Squarespace

Versions

Version
0.10
0.9
0.8
0.5
0.4
0.3
0.2
0.1