ratpack.guice

Class BindingsImposition

java.lang.Object

ratpack.guice.BindingsImposition

All Implemented Interfaces:

ratpack.impose.Imposition

public final class BindingsImposition
extends java.lang.Object
implements ratpack.impose.Imposition

An imposition of additional and overridden Guice bindings, used by Guice.registry(Action) and similar methods.

This is typically used to override bindings at test time.

import ratpack.server.RatpackServer;
 import ratpack.guice.BindingsImposition;
 import ratpack.guice.Guice;
 import ratpack.impose.ImpositionsSpec;
 import ratpack.test.MainClassApplicationUnderTest;

 import static org.junit.Assert.assertEquals;

 public class Example {

   public static class App {
     public static void main(String[] args) throws Exception {
       RatpackServer.start(s -> s
         .registry(Guice.registry(r ->
           r.bindInstance(String.class, "foo")
         ))
         .handlers(c -> c
           .get(ctx -> ctx.render(ctx.get(String.class)))
         )
       );
     }
   }

   public static void main(String[] args) throws Exception {
     new MainClassApplicationUnderTest(App.class) {
       {@literal @}Override
       protected void addImpositions(ImpositionsSpec impositions) {
         impositions.add(BindingsImposition.of(r ->
           r.bindInstance(String.class, "bar")
         ));
       }
     }.test(testHttpClient ->
       assertEquals("bar", testHttpClient.getText())
     );
   }
 }
 

Since:

1.2

See Also:

Impositions

Method Summary

Modifier and Type	Method and Description
ratpack.func.Action<? super BindingsSpec>	getBindings() The bindings to add/override.
static BindingsImposition	of(ratpack.func.Action<? super BindingsSpec> bindings) Creates a new bindings imposition of the given bindings.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getBindings

public ratpack.func.Action<? super BindingsSpec> getBindings()

The bindings to add/override.

Returns:

the bindings to add/override

of

public static BindingsImposition of(ratpack.func.Action<? super BindingsSpec> bindings)

Creates a new bindings imposition of the given bindings.

Parameters:

bindings - the bindings to impose

Returns:

a new bindings imposition