一个Java的Restful服务框架，支持JPA、JAAS、分布式资源对象

资讯频道 → 编程语言

18顶
1踩

2008-06-15 10:38 by 见习记者 cnoss 评论(12) 有11293人浏览

JPA Java 框架 velocity

声明：ITeye资讯文章的版权属于ITeye网站所有，严禁任何网站转载本文，否则必将追究法律责任！

项目地址: http://code.google.com/p/jrest4guice/
Demo演示: http://cnoss.vicp.net/

当前版本：0.9.0 preview

特点:

基于Google guice
零配置，服务的自动扫描注册
非侵入式，用户不需要实现特定的接口来实现Restful服务
支持Post. Get. Put. Delete操作
灵活的注入(支持上下文环境request/response/session以及参数的自动注入)
根据客户端要求返回不同类型的数据（xml/json/html）
支持Velocity、Freemarker和Spry模板引擎（当返回类型是text/html时才有效,参见@ViewTemplate）
支持JPA，通过增强的BaseEntityManager实现实体的CRUD
支持事务，通过@Transactional注解声明事务的类型
支持JAAS，通过@RolesAllowed注解声明操作所需要的角色
支持分布式资源对象，实现业务逻辑的分布式部署

下一步计划：

OSGI的支持
分布式事务的支持

代码示例：

/**
 * 
 * @author <a href="mailto:zhangyouqun@gmail.com">cnoss (QQ：86895156)</a>
 * 联系人的资源对象，并声明为Remote（可以通过@RemoteService的注入到任一资源对象,通常用在跨应用的资源调用上）
 */
@Path( { "/contact", "/contacts/{contactId}" })
@Remote
public class ContactResource {
	@Inject
	private ContactService service;

	/**
	 * 创建新的联系人
	 * contact 联系人实体
	 */
	@Post
	public String createContact(@ModelBean Contact contact) {
		return this.service.createContact(contact);
	}

	/**
	 * 修改联系人信息
	 * contact 联系人实体
	 */
	@Put
	public void putContact(@ModelBean Contact contact) {
		this.service.updateContact(contact);
	}

	/**
	 * 显示联系人列表，并限定服务所支持的返回数据类型只能为application/json和application/javabean
	 * pageIndex 页码
	 * pageSize 每页记录数
	 */
	@Get
	@ProduceMime( {MimeType.MIME_OF_JSON,MimeType.MIME_OF_JAVABEAN})
	@Path("/contacts")
	public Page<Contact> listContacts(int pageIndex, int pageSize) {
		return this.service.listContacts(pageIndex, pageSize);
	}

	/**
	 * 显示单个联系人的信息
	 * 并指定了当客户端请求类型为text/html时的视图显示模板（现在系统内置对Velocity、Freemarker与Spry的支持）
	 * contactId 联系对象ID
	 */
	@Get
	@ViewTemplate(url="/template/contactDetail.vm",render=ViewRenderType.VELOCITY)
//	@ViewTemplate(url="/template/contactDetail.ftl",render=ViewRenderType.FREEMARKER)
//	@ViewTemplate(url="/template/contactDetail.html",render=ViewRenderType.SPRY)
	public Contact getContact(@Parameter("contactId") String contactId) {
		return this.service.findContactById(contactId);
	}

	/**
	 * 删除指定ID的联系人
	 * contactId 联系对象ID
	 */
	@Delete
	public void deleteContact(@Parameter("contactId") String contactId) {
		this.service.deleteContact(contactId);
	}
}

/**
 * 业务对象
 * @author <a href="mailto:zhangyouqun@gmail.com">cnoss (QQ：86895156)</a>
 *
 */
@SuppressWarnings({"unchecked", "unused"})
public class ContactServiceBean implements ContactService {

	private BaseEntityManager<String, Contact> entityManager;

	@Inject
	private void init(EntityManager em) {
		this.entityManager = new BaseEntityManager<String, Contact>(
				Contact.class, em);
	}

	@Transactional
	@RolesAllowed({"user"})//权限声明
	public String createContact(Contact contact) {
		if (contact == null)
			throw new RuntimeException("联系人对象不能为空");

		if (this.entityManager.loadByNamedQuery("byName", contact.getName()) != null) {
			throw new RuntimeException("联系人的姓名相同，请重新输入");
		}

		this.entityManager.create(contact);
		return contact.getId();
	}

	@Transactional
	@RolesAllowed({"admin","audit"})//权限声明
	public void deleteContact(String contactId) {
		String[] ids = contactId.split(",");
		Contact contact;
		for (String id : ids) {
			contact = this.findContactById(id);
			if (contact == null)
				throw new RuntimeException("联系人不存在");
			this.entityManager.delete(contact);
		}
	}

	@Transactional(type=TransactionalType.READOLNY)//只读性的事务
	public Contact findContactById(String contactId) {
		return this.entityManager.load(contactId);
	}

	@Transactional(type=TransactionalType.READOLNY)
	public Page<Contact> listContacts(int pageIndex, int pageSize)
			throws RuntimeException {
		return this.entityManager.pageByNamedQuery("list",
				new Pagination(pageIndex, pageSize));
	}

	@Transactional
	@RolesAllowed({"admin","user"})//权限声明
	public void updateContact(Contact contact) {
		if (contact == null)
			throw new RuntimeException("联系人对象不能为空");

		this.entityManager.update(contact);
	}
}


/**
 * 远程资源引用的示例
 * @author <a href="mailto:zhangyouqun@gmail.com">cnoss (QQ：86895156)</a>
 * 
 */
@Path({"/testCallRemote"})
public class TestRemoteResource {
	@Inject
	@RemoteService //注入远程资源对象的引用
	private ContactResource service;

	@Get
	@ProduceMime( {MimeType.MIME_OF_JSON,MimeType.MIME_OF_JAVABEAN})
	public Page<Contact> listContacts(int pageIndex, int pageSize) {
		return this.service.listContacts(pageIndex, pageSize);
	}
}

请大家直接从SVN中获取JRest4Guice、JRest4Guice-sample、libraries三个工程即可

真诚希望大家提出宝贵意见，联系方式：

Email：zhangyouqun@gmail.com
QQ: 86895156
MSN: zhangyouqun@hotmail.com

分享到：

18
顶

1
踩

评论共 12 条请登录后发表评论

12 楼 rox 2010-01-07 21:39

恩，不错，和Restlet相似，有兴趣。

11 楼 cnoss 2008-06-18 17:31

针对JRest4Guice的代码生成工具JRest4Guice-tools 已经发布0.0.1版，功能包括：

创建helloworld的Web样板工程
创建带JPA实现的Web样板工程
创建Restful资源(会自动产生resource/service/entity/junit)

原代码地址： http://jrest4guice.googlecode.com/svn/trunk/Incubator/JRest4Guice-tools

可执行文件在dist目录下,具体使用请大家按照程序的向导进行，谢谢大家的关注。

10 楼 helyho 2008-06-16 15:46

我觉没有什么特别的优势.
使用接口是为了,servlet的或者是服务的同一性,这样带来的是人员变更后维护的易入手
而使用注解每个人的方式不同,业务逻辑和请求处理类分的不清晰,还有就是注解让人看的比较容易晕,他的结构性太差.
我的个人观点
对模板的支持挺不错.

9 楼 lisanping 2008-06-16 14:34

8 楼 zhyhongyuan 2008-06-16 12:56

我用jrest4guice做了一个小项目，感觉不错，开发速度快，继续支持！

7 楼 cnoss 2008-06-16 12:12

有什么问题可以通过QQ、MSN和我联系

6 楼 Frederick 2008-06-16 11:24

不好意思，对maven不熟悉，所以先前没看项目里面的pom.xml文件。现在知道需要那些版本的jar包了

5 楼 Frederick 2008-06-16 10:56

想问一下，你的项目用的asm.jar是那个版本的？似乎3.0和3.1都不对，无法编译通过。

主要出错代码在于ParameterNameDiscoverer.java的76行和83行。

3.0/3.1的classReader.accept()是这样的：public void accept(final ClassVisitor classVisitor, final int flags)，你的调用通不过啊：
classReader.accept(classVisitor, false)

4 楼 jacky_yin 2008-06-16 09:15

有很多新的特性，非常吸引人，希望楼主继续努力，赞一个！

3 楼 sinoyster 2008-06-16 08:52

非常不错

2 楼 minidarkey 2008-06-15 23:17

,确实不错，我也一直都在跟进

1 楼 zjumty 2008-06-15 22:10

不错不错, 赞!

发表评论

您还没有登录,请您登录后再发表评论

18顶1踩