Hello world

Jul 10, 2017 10:38:44 AM

作者:zozoh

Ioc 的概念

Nutz.Ioc 从概念上是很简单:将一部分关于对象的依赖关系单独存储在某种介质里,并且提供一个接口帮助使用者获得这些对象。

但是将依赖关系存储在什么地方呢? Spring 选的是 XML, Guice 选的 Java (硬编码)

Nutz.Ioc 核心逻辑并没有限定配置信息的存储方式,但它还是提供了一个默认的配置文件编写方式 — JSON。因为

  • 省却了 XML 书写的烦恼
  • 避免了硬编码 — 修改配置,不需要重新编译工程
    当然,你可以扩展它,提供自己的配置文件加载方式, Nutz.Ioc 不反对你这样,它甚至有点鼓励你这样,虽然 JSON 方式的配置文件书写方式已经工作的很好了。

下面,我先以 JSON 文件为例,给大家一个 Hello World

一个简单的例子

在这个例子中,你需要一 POJO,以及一个 JSON 配置文件。例子的源代码,你可以访问 Nutzbook 获取

POJO 源代码

  1. package nutz.demo.ioc.book;
  2. import java.util.Calendar;
  3. public class Pet {
  4. private String name;
  5. private Calendar birthday;
  6. private Pet friend;
  7. public Pet() {}
  8. public Pet(String name) {
  9. this.name = name;
  10. }
  11. public String getName() {
  12. return name;
  13. }
  14. public void setName(String name) {
  15. this.name = name;
  16. }
  17. public Calendar getBirthday() {
  18. return birthday;
  19. }
  20. public void setBirthday(Calendar birthday) {
  21. this.birthday = birthday;
  22. }
  23. public Pet getFriend() {
  24. return friend;
  25. }
  26. public void setFriend(Pet friend) {
  27. this.friend = friend;
  28. }
  29. }

这个对象有两个构造函数

Json 配置文件

与 POJO 在同一包路径下

  1. /*
  2. * 开始写上 var ioc = { , 是为了利用 eclipse 的 javascript 编辑器的自动格式化功能
  3. */
  4. var ioc = {
  5. /*
  6. * 默认的,你仅仅需要直接声明每个字段的值即可,Nutz.Ioc 会为你转型
  7. */
  8. xiaobai : {
  9. name : 'XiaoBai',
  10. birthday : '2009-10-25 15:23:40'
  11. },
  12. /*
  13. * 你当然也可以做更细致的设置
  14. */
  15. xiaohei : {
  16. type : 'nutz.demo.ioc.book.Pet', // 类型
  17. singleton : false, // 是否为单件
  18. args : [ 'XiaoHei' ], // 构造函数参数
  19. fields : {
  20. birthday : '2009-11-3 08:02:14',
  21. friend : {refer : 'xiaobai'} // 指向容器里另外一个对象
  22. }
  23. }
  24. }

调用代码

  1. package nutz.demo.ioc.book;
  2. import org.nutz.ioc.Ioc;
  3. import org.nutz.ioc.impl.NutIoc;
  4. import org.nutz.ioc.loader.json.JsonLoader;
  5. public class HelloPet {
  6. public static void main(String[] args) {
  7. Ioc ioc = new NutIoc(new JsonLoader("nutz/demo/ioc/pet/pets.js"));
  8. Pet pet = ioc.get(Pet.class, "xiaobai");
  9. System.out.printf("%s - [%s]\n", pet.getName(), pet.getBirthday().getTimeZone().getID());
  10. ioc.depose(); // 关闭ioc容器.
  11. }
  12. }

控制台输出

  1. XiaoBai - [Asia/Shanghai]

如果配置文件中声明了类型,则可不传入类型

  1. Pet xh = ioc.get(null, "xiaohei");
  2. System.out.printf("%s's friend is %s\n", xh.getName(), xh.getFriend().getName());

控制台输出:

  1. XiaoHei's friend is XiaoBai

声明了 singleton: false,那么它每次获取,都会生成一个新的实例

  1. Pet p1 = ioc.get(null, "xiaohei");
  2. Pet p2 = ioc.get(null, "xiaohei");
  3. System.out.println(p1==p2);

控制台输出:

  1. false

关于进阶

我可以负责任的告诉你:你已经掌握了 Nutz.Ioc 在你开发的时候 80% 情况下所需要的知识。当然,它还提供了更多的功能,有些功能是其他 Ioc 容器所不具备的,你可以根据自己需要来阅读,他们包括:

关于工厂方法

从1.b.51开始, nutz内置的json/xml/annotation加载器支持工厂方法了

Json写法是

  1. {
  2. // 根据静态方法构建对象
  3. ssdb : {
  4. type : "org.nutz.ssdbj4.spi.SSDB", // 接口或抽象类
  5. args : ["127.0.0.1", 8888, 5000, null],
  6. factory : "org.nutz.ssdbj4.SSDBs#pool" // 类名#方法名
  7. },
  8. // 用另外一个bean的实例方法构建对象
  9. yyy : {
  10. args : "abc",
  11. factory : "$ssdb#batch" // $对象名称#方法名
  12. }
  13. }

XML写法是

  1. <ioc>
  2. <obj name="ssdb" type="org.nutz.ssdbj4.spi.SSDB" factory="org.nutz.ssdbj4.SSDBs#pool">
  3. <args>
  4. <str>127.0.0.1</refer>
  5. <int>8888</int>
  6. <int>5000</int>
  7. </args>
  8. </obj>
  9. </ioc>

可选属性

从1.b.51开始, nutz内置的json/xml/annotation加载器支持可选属性了

有时候,某些服务即使不存在也不会影响系统的运行,但这些属性又是ioc配置好的,这时就需要可选属性了

注解的写法是

  1. @IocBean
  2. public class MqttService {
  3. @Inject(optional=true)
  4. protect Dao dao;
  5. @Inject
  6. protect MqttClient client;
  7. public void publish(String topic, Object data) {
  8. if (dao != null) { // 有就记录,没有就算了呗
  9. dao.insert(new MqttHistory(topic, String.value(data));
  10. }
  11. client.publish(topic, data);
  12. }
  13. }

本页面的文字允许在知识共享 署名-相同方式共享 3.0协议GNU自由文档许可证下修改和再使用。

原文: http://nutzam.com/core/ioc/hello.html