DWR2.0新增加了JDK5的注解(Annotation)功能,使用注解功能之后可以从很大程度上简化了原来的dwr.xml的配置,使用起来非常的方便。
一、配置DWR使用注解功能
如果让dwr使用注解功能需要在web.xml进行如下配置:
- <servlet>
- <servlet-name>dwr-invoker</servlet-name>
- <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class>
- <init-param>
- <param-name>debug</param-name>
- <param-value>true</param-value>
- </init-param>
- <!-- 将设定注解的域对象和业务实现类放在下面列表中,中间使用逗号间隔 -->
- <init-param>
- <param-name>classes</param-name>
- <param-value>
- com.javatang.domain.Book,
- com.javatang.bank.Bank,
- com.javatang.dao.BookDao
- </param-value>
- </init-param>
- </servlet>
- <servlet-mapping>
- <servlet-name>dwr-invoker</servlet-name>
- <url-pattern>/scripts/ajax/*</url-pattern>
- </servlet-mapping>
这样设置之后就可以在dwr中使用注解了,非常的方便。
二、DWR提供的注解类型
经常用到的注解主要有:@RemoteProxy、@RemoteMethod、@DataTransferObject和@RemoteProperty。
1. @RemoteProxy和@RemoteMethod
@RemoteMethod对应于原来dwr.xml文件中的create标签,用于创建DWR所提供的远程方法;而@RemoteMethod对应于create标签中的 <include method=”"/>,用来指定所要暴露的方法名称。我们举例来说明:
- @RemoteProxy(name="bankFunctions")
- publicclass Bank {
- @RemoteMethod
- publicvoid buy() {
- // ...
- }
- }
从上面可以看出,@RemoteProxy表示这个类将用于远程方法,而使用@RemoteMethod指定所要暴露的方法,没有使用@RemoteMethod的方法将不会显示在客户端。
上面的注释使用dwr.xml表示如下:
- <!DOCTYPE dwr PUBLIC
- "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN"
- "http://getahead.ltd.uk/dwr/dwr20.dtd">
- <dwr>
- <allow>
- <createcreator="new" javascript="bankFunctions">
- <includemethod="buy" />
- </create>
- </allow>
- </dwr>
如果使用Spring中的DAO活逻辑层则需要进行如下的设置:
- // BookDao
- @RemoteProxy(creator = SpringCreator.class,
- creatorParams = @Param(name = "beanName",value = "bookDao"),
- name="bookFunctions")
- publicclass BookDao {
- @RemoteMethod
- publicvoid addBook(Book book) {
- // ...
- }
- }
通过指定@RemoteProxy中的creator类型为SpringCreator,然后在creatorParams指定对应的beanName名称。对应的dwr.xml文件如下:
- <!DOCTYPE dwr PUBLIC
- "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN"
- "http://getahead.ltd.uk/dwr/dwr20.dtd">
- <dwr>
- <allow>
- <createcreator="spring" javascript="bookFunctions">
- <paramname="beanName" value="bookDao" />
- <includemethod="addBook" />
- </create>
- </allow>
- </dwr>
2. @DataTransferObject和@RemoteProperty
@DataTransferObject对应于原来dwr.xml文件中的convert标签,用于转换Java对象;@RemoteProperty则对应于convert标签中的 <param name=”include” value=”" />。
举例说明一下:
- @DataTransferObject
- publicclass Book {
- @RemoteProperty
- privateint id;
- @RemoteProperty
- privateString name;
- publicBook() {
- }
- publicint getId() {
- returnid;
- }
- publicvoid setId(int id) {
- this.id = id;
- }
- publicString getName() {
- returnname;
- }
- publicvoid setName(String name) {
- this.name = name;
- }
- }
@RemoteProperty可以放在JavaBean中的私有变量上面,也可以放在getXXX方法上面。另外如果想将JavaBean中所有的属性都暴露出来的话,不需要在任何属性上面添加@RemoteProperty注释就可以了。
上面的注释对应的dwr.xml文件如下:
- <!DOCTYPE dwr PUBLIC
- "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN"
- "http://getahead.ltd.uk/dwr/dwr20.dtd">
- <dwr>
- <allow>
- <convertconverter="bean"
- match="com.javatang.domain.Book">
- <paramname="include" value="id,name" />
- </convert>
- <!-- 或者用下面的方式也可以
- <convert converter="bean" match="com.javatang.domain.Book" />
- -->
- </allow>
- </dwr>
关于具体每个注释使用的方法已经所包含的参数可以参考Java Doc。使用DWR2.0的注解极大的简化了原来dwr.xml的配置,非常的方便。