在Nutz中使用Ioc-Annotation的入门教程

接触Nutz已经有很久了，从1.a.15就开始关注，至今也用Nutz做了几个项目，由于工作较忙，因此都没空写学习心得。惭愧的是一直没空去研究源码！！

 

今天心血来潮，测试了Ioc-Annotation，觉得挺方便的，由于Nutz提供了几种注入的配置方式（JS、XML、Annotation），因Nutz最开始是只支持JS配置，所以之前做的项目都是使用JS配置。但经常会忘了在JS配置文件加入注入的对象，经常获取到NULL值。

 

因在Spring-MVC中经常用注解，所以今天就抽空试了下Nutz的注解方式。还挺给力的！！！哈哈~~

 

好了，正奔主题！！

 

 

Nutz版本：1.b.38

数据库：MySQL

 

 

一、创建数据库

 CREATE TABLE `articleinfo` (
  `id` int(4) NOT NULL AUTO_INCREMENT,
  `title` varchar(50) DEFAULT NULL,
  `content` text,
  `addDate` datetime DEFAULT NULL,
  `addIp` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;

 

-- ----------------------------
-- Records of articleinfo
-- ----------------------------
INSERT INTO `articleinfo` VALUES ('1', '关于Nutz的Ioc-Annotation测试', '关于Nutz的Ioc-Annotation测试\r\n', '2011-07-23 21:42:43', '127.0.0.1');
INSERT INTO `articleinfo` VALUES ('2', 'Ioc-Annotation测试例子', 'Ioc-Annotation测试例子', '2011-07-23 21:44:16', '127.0.0.1');
INSERT INTO `articleinfo` VALUES ('3', '哈哈，成功了吧！', '哈哈，成功了吧！', '2011-07-23 21:44:40', '127.0.0.1');

 

 

二、例子使用的Jar包

 

三、结构图

 

 

 四、代码

1、首先配置Web.xml，配置Nutz的主模块。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	id="WebApp_ID" version="2.5">
	<display-name>TestIocAnnotation</display-name>

	<filter>
		<filter-name>nutz</filter-name>
		<filter-class>org.nutz.mvc.NutFilter</filter-class>
		<init-param>
			<param-name>modules</param-name>
			<param-value>demo.nutz.setup.MainModule</param-value>
		</init-param>
	</filter>

	<filter-mapping>
		<filter-name>nutz</filter-name>
		<url-pattern>*.shtml</url-pattern>
	</filter-mapping>
	
	<welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>

</web-app>

 

 

2、创建主模块类MainModule.java

package demo.nutz.setup;

import org.nutz.mvc.annotation.IocBy;
import org.nutz.mvc.annotation.Modules;
import org.nutz.mvc.annotation.SetupBy;
import org.nutz.mvc.ioc.provider.ComboIocProvider;

import demo.nutz.action.ArticleInfoAction;

/**
 * 主模块
 *
 * @author gevin([email protected])
 *
 */
@Modules(value = ArticleInfoAction.class, scanPackage = true)
@IocBy(type = ComboIocProvider.class, args = {
	"*org.nutz.ioc.loader.json.JsonLoader", "ioc/dao.js", 
	"*org.nutz.ioc.loader.annotation.AnnotationIocLoader", "demo.nutz"})
@SetupBy(NutzSetup.class)
public class MainModule {

}

 由于使用了两种注入的配置方式，因此此处使用了Ioc复合加载器ComboIocProvider。

1）使用"*org.nutz.ioc.loader.json.JsonLoader", "ioc/dao.js"加载JS文件，dao.js中配置了数据源对象和dao对象的注入，貌似听“Wendal-兽”说无法用注解来配置，只能用配置文件。

2）使用"*org.nutz.ioc.loader.annotation.AnnotationIocLoader", "demo.nutz"来自动加载包demo.nutz或其子包中被@IocBean注解过的类。

3）@Modules(value = ArticleInfoAction.class, scanPackage = true) 用来告诉Nutz自动去扫描ArticleInfoAction.class所在包的所有类，如果有类包括了一个以上的入口函数将被认为是模块类。

 

 

3、“ioc/dao.js”文件

/*
 * 本配置文件声明了整个应用的数据库连接部分。
 */
var ioc = {
	/*
	 * 数据库连接池
	 */
	dataSource : {
		type : "com.mchange.v2.c3p0.ComboPooledDataSource",
		fields : {
			driverClass : "com.mysql.jdbc.Driver",
			jdbcUrl : "jdbc:mysql://127.0.0.1/nutzdemo",
			user : "root",
			password : "123456"
		} 
	},
	/*
	 * 这个配置很好理解， args 表示这个对象构造函数的参数。显然，下面的注入方式将调用 new NutDao(dataSource)
	 */
	dao : {
		type : "org.nutz.dao.impl.NutDao",
		args : [ {
			refer : "dataSource"
		} ]
	}
};

 

 

4、建立一个与上面数据库表ArticleInfo对应的Model类ArticleInfo.java

package demo.nutz.model;

import java.util.Date;

import org.nutz.dao.entity.annotation.Id;
import org.nutz.dao.entity.annotation.Table;

/**
 * 文章类
 * 
 * @author gevin([email protected])
 * 
 */
@Table("ArticleInfo")
public class ArticleInfo {

	@Id
	private int id;
	private String title;
	private String content;
	private Date addDate;
	private String addIp;

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getTitle() {
		return title;
	}

	public void setTitle(String title) {
		this.title = title;
	}

	public String getContent() {
		return content;
	}

	public void setContent(String content) {
		this.content = content;
	}

	public Date getAddDate() {
		return addDate;
	}

	public void setAddDate(Date addDate) {
		this.addDate = addDate;
	}

	public String getAddIp() {
		return addIp;
	}

	public void setAddIp(String addIp) {
		this.addIp = addIp;
	}

}

  其中@Table注解指定对应的数据库表名称，@Id注解指定主键为字段id，整型，并且默认是自增1

 

 

5、业务处理类ArticleInfoService.java

package demo.nutz.service;

import org.nutz.dao.Dao;
import org.nutz.ioc.loader.annotation.IocBean;
import org.nutz.service.IdEntityService;

import demo.nutz.model.ArticleInfo;

/**
 * 业务层
 *
 * @author gevin([email protected])
 *
 */
@IocBean(args = { "refer:dao" })
public class ArticleInfoService extends IdEntityService<ArticleInfo> {

	public ArticleInfoService() {
		super();
	}

	public ArticleInfoService(Dao dao, Class<ArticleInfo> entityType) {
		super(dao, entityType);
	}

	public ArticleInfoService(Dao dao) {
		super(dao);
	}

}

 1）由于主键是整型，因此此处是继承IdEntityService

2）此处最重要的是@IocBean(args = { "refer:dao" })这句话，等同于

@IocBean( name = "articleInfoService", args = { "refer:dao" })

使用@IocBean，若没有指定属性name的值，则默认为类名首字母小写。

 3）args = { "refer:dao" })指定构造函数所要注入的对象，由于ArticleInfoService要使用到dao对象，因此此处不要忘了带参数。

 

 

 

6、子模块 ArticleInfoAction.java

（哈哈，可能有些人看完Nutz手册，也没有看到以Action结尾的类名，个人习惯吧，因为之前用惯了SSH，觉得那样命名也挺好的，所以就搬过来了。按Nutz的推荐命名应该是ArticleInfoModule.java吧！你懂的啦！）

package demo.nutz.action;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.nutz.dao.Cnd;
import org.nutz.ioc.loader.annotation.Inject;
import org.nutz.ioc.loader.annotation.IocBean;
import org.nutz.mvc.annotation.At;
import org.nutz.mvc.annotation.Ok;

import demo.nutz.model.ArticleInfo;
import demo.nutz.service.ArticleInfoService;

/**
 * 文章模块
 *
 * @author gevin([email protected])
 *
 */
@IocBean
@At("/articleinfo")
public class ArticleInfoAction {

	@Inject
	private ArticleInfoService articleInfoService;
	
	/**
	 * 获取文章列表
	 * 
	 * @return
	 */
	@At("/showArticleInfoList")
	@Ok("jsp:/articleinfo/showArticleInfoList")
	public Map<String, Object> showArticleInfoList() {
		Map<String, Object> map = new HashMap<String, Object>();
		try {
			// 获取文章列表
			List<ArticleInfo> aiList = this.articleInfoService.query(Cnd.orderBy().desc("addDate"), null);
			map.put("articleInfoList", aiList);
			
			return map;
		} catch (Exception e) {
			e.printStackTrace();
			map.put("msg", "getFailure");
			return map;
		}
	}
}

  首先用@IocBean声明该类可被注入，然后用@Inject标明需要注入的属性。 

 

 

7、JSP文件articleinfo/showArticleInfoList.shtml，使用了JSTL，所以大家在加包时记得加。

<%@ page contentType="text/html; charset=utf-8" language="java" import="java.sql.*" errorPage="" %>
<%@ taglib uri="/WEB-INF/tld/c-1_0-rt.tld" prefix="c" %>
<%@ taglib uri="/WEB-INF/tld/fmt-1_0-rt.tld" prefix="fmt" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>显示文章列表</title>
</head>

<body>
<div>
    <ul>
        <c:forEach var="ai" items="${obj.articleInfoList}">
        	<li><c:out value="${ai.title}" />(<fmt:formatDate pattern="yyyy-MM-dd HH:mm:ss" value="${ai.addDate}" />)</li>
        </c:forEach>
    </ul>
</div>
</body>
</html>

 

 

8、OK了，所有文件都配置好了，我们重启Tomcat，访问以下测试地址。

http://localhost:204/TestIocAnnotation/articleinfo/showArticleInfoList.shtml

 

效果图：

 

---------------------------------------------------------------------------------------------------------------------------

第一次在Javaeye上写学习心得，还蛮花时间的。以后有空再继续写了！！

不过，Nutz挺给力的！！！！！最后附上整个例子的源代码，希望对大家有帮助了！