1. 框架内置绑定

在ActFramework中有大量的服务和组件都可以直接使用依赖注入，其中包括

• ActionContext - Encapsulate all data/info relevant to an HTTP request context
• H.Session - HTTP request session. Also available via actionContext.session()
• H.Flash - HTTP request flash. Also available via actionContext.flash()
• H.Request - HTTP request. Also available via actionContext.req()
• H.Response - HTTP response. Also available via actionContext.resp()
• CliContext - Encapsulate all data/facilities relevant to a CLI session
• CliSession (Since act-0.6.0) - CLI session
• MailerContext - Mailer method context
• ActContext - A generic ActContext depends on the current computation environment,could be either ActionContext,CliContext or MailerContext or null
• Logger - The Act.LOGGER instance
• UserAgent - The user agent if in a request handling context
• AppConfig - The application configuration object
• AppCrypto - The application crypto object
• CacheService - The App.cache() cache service
• EventBus - The application's event bus
• Locale - Could be ActContext.locale() or AppConfig.locale() if there is no context

1.1 应用服务组件

• DbServiceManager
• MailerService
• Router
• CliDispatcher
• AppJobManager

2. Dao

目前支持EbeanDao和MorphiaDao两种分别用于访问sql和MongoDB数据库

// Demonstrate inject to field
@Controller("user")
public class UserService {

    @javax.inject.Inject
    private MorphiaDao<User> userDao;

    @PostAction
    public void create(User user) {
        userDao.save(user);
    }

}

// Demonstrate inject to parameter
@Controller("user")
public class UserService {

    @PostAction
    public void create(User user,MorphiaDao<User> userDao) {
        userDao.save(user);
    }

}

如果应用有自定义的Dao,可以直接注入:

// The Model
@Entity("user")
public class User extends MorphiaModel<User> {
    
    public String email;
    ...

    public static class Dao extends MorphiaDao<User> {
        public User findByEmail(String email) {
            return findOneBy("email",email);
        }
    }
}

// The controller
@Controller("user")
public class UserService {

    @javax.inject.Inject
    private User.Dao userDao;

    @GetAction("{email}")
    public User findByEmail(String email) {
        return userDao.findByEmail(email);
    }

}

3. 可构造对象

任何拥有public缺省构造函数或者带有@Inject构造函数的类均可被注入,例如:

// A class with public default constructor
public class Foo {
    public Foo() {...}
}

// A class with Inject constructor
public class Bar {
    @javax.inject.Inject
    public Bar(Foo foo) {...}
}

上面的Foo和Bar都可以用于依赖注入:

public class XxxController {
    @Inject Foo foo;
    @Inject Bar bar;

    ...
}

注意 可构造对象不能直接用于参数注入

public class XxxController {

    // foo and bar won't be able to injected throght DI
    // instead they will be deserialized from form parameters
    @PostAction("/xxx")
    public void xxxAction(Foo foo,Bar bar) {
    }
}

但是可以通过@Provided注解来指定使用依赖注入

public class YyyController {

    // this time foo and bar will be injected through DI
    @PostAction("/yyy")
    public void xxxAction(@Provided Foo foo,@Provided Bar bar) {
    }
}

4. 应用自定义的绑定

假设应用自己定义了接口或抽象类,并且定义了绑定,可以直接使用依赖注入

// The interface
public interface MyService {
    void service();
}

// The implemention one
public class OneService implements MyService {
    public void service() {Act.LOGGER.info("ONE is servicing");}
}

// The implemention two
public class TwoService implements MyService {
    public void service() {Act.LOGGER.info("TWO is servicing");}
}

// Define bindings
public class MyModule extends org.osgl.inject.Module {
    protected void configure() {
        bind(MyService.class).to(OneService.class);
        bind(MyService.class).named("two").to(TwoService.class);
    }
}

// Inject the service
public class Serviced {
    @Inject
    private MyService one;

    @Inject
    @Named("two")
    private MyService two;
}

链接

• ActFramework依赖注入 I - 简介
• ActFramework依赖注入 III - 定义绑定
• ActFramework官网
• [ActFramework@开源中国](https://www.oschina.net/p/actframework)
• [ActFramework@码云](https://git.oschina.net/actframework/actframework)