Gridsphere持久层操作规范.doc

持久层编码规范此文档是在“用GridSphere写自己的Portlet续”的基础上补充的文档，由于上一个文档只是简单介绍了如何使用Gridsphere开发、部署、编译、且开发的程序没有涉及到数据库的操作，本文档主要是从操作持久层（即数据库）的角度来进行规范说明。由于gridsphere有一套完整的持久层操作机制，所以我们再写程序的时候就不用再为Session，Transation的管理费神。主要调用gridsphere的几个类，这些类要在程序开始的时候导入（感兴趣的可以看一下源码）org.gridlab.gridsphere.portlet.PortletLog;org.gridlab.gridsphere.portlet.impl.SportletLog; org.gridlab.gridsphere.core.persistence.PersistenceManagerException; org.gridlab.gridsphere.core.persistence.QueryFilter;org.gridlab.gridsphere.core.persistence.PersistenceManagerFactory;org.gridlab.gridsphere.core.persistence.PersistenceManagerRdbms;、PersistenceManagerFactory类通过这个类可以生成PersistenceManagerRdbms（PersistenceManagerRdbms是个接口，实现类是PersistenceManagerRdbmsImpl），而传递的参数为一个String类型该工程的名字，可以从WEB-INF下的web.xml中查到（下面的EllePortlet就是webappname）。 PortletServlet /jsr/EllePortlet private static PersistenceManagerRdbms pmrdb=PersistenceManagerFactory.createPersistenceManagerRdbms(EllePortlet)；Pmrdb其实是gridsphere自己写好的一个类似于HibernateUtil的工具类，其中提供的方法类似于hibernate的Query类，里面的方法包含下面简单介绍一下常用到的几个方法：public void create(Object object) throws PersistenceManagerException; 这个方法是将一个脱管状态的object变为持久状态，类似于session中的save方法，如果保存失败会抛PersistenceManagerException异常（类似于HibernateException），所以再编写代码的时候要捕获异常。public void update(Object object) throws PersistenceManagerException;这个方法是更新一个持久状态的object，如果更新失败，同样会抛PersistenceManagerException异常 public void saveOrUpdate(Object object) throws PersistenceManagerException;保存或者更新一个已经存在的object，通常如果参数是一个对象的话，往往采用此方法，而不是采用update如果更新失败，同样会抛PersistenceManagerException异常public Object restore(String query) throws PersistenceManagerException;根据查询语句返回一个object，如果有多个object匹配，则返回第一个 public List restoreList(String query) throws PersistenceManagerException;根据查询语句返回一个object数组。 public List restoreList(String query, QueryFilter queryFilter) throws PersistenceManagerException; 根据查询语句返回一个object数组，QueryFilter是gridsphere自定义的一个类，包含from，和sum两个属性，返回特定的几条数据。 public int count(String query) throws PersistenceManagerException;该方法返回的满足查询条件的查询结果的个数， public void delete(Object object) throws PersistenceManagerException;删除一个持久态的object，用法同session.delete() public void deleteList(String query) throws PersistenceManagerException;删除一个满足查询语句的所有的object例子：由于shoppingmallportlet这个portlet用到的函数不是很多，所以下面用新版的帐户管理Portlet中的AccountServiceImpl来说明AccountServiceImpl是操纵Account的一个方法类，上述方法也主要是在操作实体类的方法类中调用到。 下面是类的头部分：注意：1.serviceImpl含有两个必须的方法destroy和init是继承Portletserviceprovider类2. PersistenceManagerRdbms类在init方法中初始化，以后函数中再用到直接调用即可/下面这个函数是查询所有的Account，ejdo是取得该类的完整类名，如果该类放在org.sdu.elle.services 包下，则ejdo=org.sdu.elle.services. Account/下面是带有查询条件的，注意参数带有单引号(当然两个函数也可以和一块写，这样写增加复用性)/下面的这个函数restoreList是返回一个List数组，并且用到了QueryFilter，即从哪一条开始取，一共取几条数据，类似于 Query.setMaxResults(),Query.setFirstResult(); / saveOrUpdate保存一个对象，如果对象是作为参数直接保存，由于不知道该对象是什么状态，所以用saveOrUpdate方法 / 下面delete方法是删除一个对象/下面是用到restore（）方法，返回一个objectPortlet