vaysman / tiny-ioc

A lightweight IOC container inspired by google-guice and tapestry-ioc

tiny-ioc

A lightweight IOC container with minimal dependencies inspired by google-guice and tapestry-ioc

Building and Registering Services with the IOC Container

import com.lazan.tinyioc.annotations.*;
public class MyModule {
    @Bind
    public void bind(ServiceBinder binder) {
           binder.bind(Service1.class, Service1Impl.class);
    }
    
    @Service
    public Service2 service2() {
        return new Service2Impl("xxx");
    }
}

import com.lazan.tinyioc.*;
public class MyMain {
    public static void main(String[] args) {
        ServiceRegistry registry = new ServiceRegistryBuilder()
            .withModuleType(MyModule.class)
            .build();
        
        Service1 s1 = registry.getService(Service1.class);
        Service2 s2 = registry.getService(Service2.class);
    }
}

Dependency Injection

import javax.inject.Inject;
public class Service1Impl implements Service1 {
    @Inject private Dependency1;
    @Inject private Dependency2;

    public Dependency1 getDependency1() { return dependency1; }
    public Dependency2 getDependency2() { return dependency2; }
}

public class Service2Impl implements Service2 {
    private final Dependency1 dependency1;
    private final Dependency2 dependency2;
    
    public Service2Impl(Dependency1 dependency1, Dependency2 dependency2) {
        this.dependency1 = dependency1;
        this.dependency2 = dependency2;
    }
    
    public Dependency1 getDependency1() { return dependency1; }
    public Dependency2 getDependency2() { return dependency2; }
}

import com.lazan.tinyioc.annotations.*;
public class MyModule {
    @Bind
    public void bind(ServiceBinder binder) {
        binder.bind(Dependency1.class, Dependency1Impl.class);
        binder.bind(Dependency2.class, Dependency2Impl.class);
        binder.bind(Service1.class, Service1Impl.class);
        binder.bind(Service2.class, Service2Impl.class).withServiceId("service2A");
    }
    
    @Service(serviceId="service2B")
    public Service2 service2B(Dependency1 dependency1, Dependency2 dependency2) {
        return new Service2Impl(dependency1, dependency2);
    }
}

import com.lazan.tinyioc.*;
public class MyMain {
    public static void main(String[] args) {
        ServiceRegistry registry = new ServiceRegistryBuilder()
            .withModuleType(MyModule.class)
            .build();
            
        Dependency1 d1 = registry.getService(Dependency1.class);
        Dependency2 d2 = registry.getService(Dependency2.class);
        
        Service1 s1 = registry.getService(Service1.class);
        assert d1 == s1.getDependency1();
        assert d2 == s1.getDependency2();

        Service2 s2A = registry.getService(Service2.class, "service2A");        
        assert d1 == s2A.getDependency1();
        assert d2 == s2A.getDependency2();
        
        Service2 s2B = registry.getService(Service2.class, "service2B");        
        assert d1 == s2B.getDependency1();
        assert d2 == s2B.getDependency2();
    }
}

Overriding Services

import com.lazan.tinyioc.annotations.*;
public class MyModule1 {
    @Bind
    public void bind(ServiceBinder binder) {
        binder.bind(String.class, "s1").withServiceId("string1");
        binder.bind(String.class, "s2").withServiceId("string2");
        binder.bind(Integer.class, 1);
        binder.bind(Long.class, 2L);
    }
}

import com.lazan.tinyioc.annotations.*;
public class MyModule2 {
    @Bind
    public void bind(ServiceBinder binder) {
        binder.override(Integer.class, 100);
    }
    
    @Override(serviceId="string1")
    public void string1Override() {
        return "s1-override";
    }
}

import com.lazan.tinyioc.*;
public class MyMain {
    public static void main(String[] args) {
        ServiceRegistry registry = new ServiceRegistryBuilder()
            .withModuleTypes(MyModule1.class, MyModule2.class)
            .build();
        
        String s1 = registry.getService("string1", String.class);
        String s2 = registry.getService("string2", String.class);
        Integer i = registry.getService(Integer.class);
        Long l = registry.getService(Long.class);
        
        assert s1.equals("s1-override");
        assert s2.equals("s2");
        assert i == 100;
        assert l == 2L;
    }
}

Decorating Services

import com.lazan.tinyioc.annotations.*;
public class MyModule {
    @Bind
    public void bind(ServiceBinder binder) {
        ServiceDecorator<String> decorator =  new ServiceDecorator<String>() {
            public String decorate(ServiceBuilderContext context, String delegate) {
                return String.format("d1|%s|d1", delegate);
            }
        };
        
        binder.bind(String.class, "initial-value").withServiceId("foo");
        binder.decorate(String.class, "decorartor1", decorator).withServiceId("foo").after("decorator2");
    }
    
    @Decorate(decoratorId="decorartor2", serviceId="foo")
    public String decorateString2(String delegate) {
        return String.format("d2|%s|d2", delegate);
    }
    
    @Decorate(decoratorId="decorartor3", serviceId="foo", before={ "decorator2", "decorator1" })
    public String decorateString3(String delegate) {
        return String.format("d3|%s|d3", delegate);
    }
}

import com.lazan.tinyioc.*;
public class MyMain {
    public static void main(String[] args) {
        ServiceRegistry registry = new ServiceRegistryBuilder()
            .withModuleType(MyModule.class)
            .build();
        
        String string = registry.getService("foo", String.class);
        assert string.equals("d1|d2|d3|initial-value|d3|d2|d1");
    }
}

Service Contributions

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."

Autobuild

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Default ServiceId

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Disambiguating Services

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Annotations

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.