配置与启动guzz
guzz程序的核心为GuzzContext对象,完成GuzzContext的初始化并获取其引用,即可使用guzz的全部功能。
Standalone程序:
创建guzz的核心配置文件guzz.xml,并存在classpath目录下。
1 import org.guzz.Configuration; 2 import org.guzz.GuzzContext; 3 4 GuzzContext gc = new Configuration("classpath:guzz.xml").newGuzzContext() ; 5 //perform you actions...... 6 //..... 7 //shutting it down when you application exit. 8 gc.shutdown() ;
普通的Web应用:
创建guzz的核心配置文件guzz.xml,并存在在/WEB-INF/目录下。
修改web.xml文件,增加如下项:
1 <context-param> 2 <param-name>guzzConfigLocation</param-name> 3 <param-value>/WEB-INF/guzz.xml</param-value> 4 </context-param> 5 6 <listener> 7 <listener-class> 8 org.guzz.web.context.ContextLoaderListener 9 </listener-class> 10 </listener>
此时在jsp页面中就可以使用guzz的taglib进行数据库操作。
GuzzContext 将会在web app退出时,由容器通知关闭。
使用Spring IOC的web应用程序:
- 1. 创建guzz的核心配置文件guzz.xml,并存在在/WEB-INF/目录下。
- 2. 修改web.xml的配置项,将spring的ContextLoader的Loader定义删掉,如:
1 <listener> 2 <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> 3 </listener>
换成Guzz针对spring的Listener:
1 <listener> 2 <listener-class>org.guzz.web.context.spring.GuzzWithSpringContextLoaderListener</listener-class> 3 </listener>
- 3. 修改spring的applicationContext.xml,增加GuzzContext的配置:
1 <bean id="guzzContext" class="org.guzz.web.context.spring.GuzzContextBeanFactory" factory-method="createGuzzContext"> 2 <constructor-arg><value>/WEB-INF/guzz.xml</value></constructor-arg> 3 </bean>
一般情况下,我们还需要增加一个BaseDao的bean,类似hibernate中的sessionFactory.getHibernateTemplate(),基于此创建应用自己的Dao或Manager。
1 <bean id="abstractGuzzDao" class="org.guzz.dao.GuzzBaseDao" abstract="true"> 2 <property name="guzzContext" ref="guzzContext" /> 3 </bean>
- 4. 支持spring声明式事务(需要guzz 1.3.0+):
修改guzz.xml,在tran定义上增加一个属性:locator="spring" 类似这样:
1 <tran locator="spring">
如果您在spring中配置过Hibernate的声明式事务,把配置copy过来,然后(一般在applicationContext.xml文件中)修改transactionManager如下即可:
1 <bean id="transactionManager" class="org.guzz.web.context.spring.GuzzTransactionManager"> 2 <property name="guzzContext" ref="guzzContext" /> 3 </bean>
如果你忘了怎么配置,这是一篇很好的文章:Spring事务配置的五种方式
补丁: 如果是基于annotation @Transactiona的事务声明,请下载 http://guzz.googlecode.com/svn/wiki/no-wikis/GuzzBaseDao.javaencoding:UTF-8 这个类,在自己的工程中建个org.guzz.dao然后放进去,覆盖jar包中的类。
- 5. 至此,就完成了guzz和spring IOC的集成。guzzContext可以通过spring bean获取的,也可以通过GuzzWebApplicationContextUtil获取到。
在web应用中获取GuzzContext:
按照普通web或者spring web方式配置的guzz,可以在servlet和JSP中,通过如下方式获取到GuzzContext:
1 import org.guzz.GuzzContext; 2 3 //session is HttpSession 4 //or pass ServletContext 5 GuzzContext gc = org.guzz.web.context.GuzzWebApplicationContextUtil.getGuzzContext(session.getServletContext()) ;