Dwr3.0纯注解(纯Java Code配置)配置与应用浅析一之零配置文件化

什么是Dwr3.0纯注解配置

Dwr(Direct Web Remoting) 是一种轻量级的远程框架，它可以实现web端的无刷新操作、异步处理，极大地提高了web应用的用户体验。

需要说明的是，这里提到的Dwr3.0纯注解配置，与使用传统的dwr.xml配置文件的方式相对。

Dwr3.0纯注解配置，是指采用纯Java Code配置的方式，完全抛弃传统的dwr.xml配置文件。在这种配置方式下，我们通过在Java代码中使用注解，来配置DWR。

使用Dwr3.0纯注解配置的优缺点

优点

方便管理

纯注解配置，不需要额外的配置文件，很大程度上减轻了项目管理的工作量。

操作简单

采用注解配置的方式，无需修改任何配置文件，后续维护改动也十分方便。

缺点

学习成本

相对于配置文件的方式，采用注解配置需要更多的学习成本。对于不熟悉注解的开发者，可能需要花费一定的时间去学习。

侵入性强

采用注解配置的方式，会直接侵入到业务代码中，如果做法不当，很容易导致代码杂乱，不便于后续维护。

Dwr3.0纯注解配置的应用

1. 基本配置

@Configuration
@EnableDwr
public class DwrConfig {

    // 注册dwr servlet
    @Bean
    public ServletRegistrationBean dwrServlet() {
        DwrServlet servlet = new DwrServlet();
        ServletRegistrationBean registrationBean = new ServletRegistrationBean(servlet, "/dwr/*");
        return registrationBean;
    }

    // 配置需要暴露给web端调用的java类和方法
    @Bean
    public DwrClassMapper dwrClassMapper() {
        DwrClassMapper dwrClassMapper = new DwrClassMapper();
        dwrClassMapper.addAutoDetectHandlers(true);//开启开关
        return dwrClassMapper;
    }

}

在这个基本配置中，我们主要做了两个事情：

注册DWR的servlet
配置需要暴露给Web端的Java类和方法

2. Java类注解配置

我们除了上面的基本配置，需要在Java类和方法上添加注解以及参数配置，这样才能够将我们的Java代码操作暴露到Web中并且可以通过AJAX进行访问。

下面是示例代码：

@Service("userService")
public class UserServiceImpl implements UserService {

    @Override
    @RemoteMethod
    public User login(@RemoteParam(name = "username") String username, @RemoteParam(name = "password") String password) {
        // 省略实现内容
        return user;
    }

    @Override
    @RemoteMethod
    public boolean update(User user) {
        // 省略实现内容
        return true;
    }
}

在这个示例中，我们通过@Service注解将这个Java类标记为一个Service，并且通过@RemoteMethod和@RemoteParam注解，将login和update方法标记为需要暴露给Web端的方法。

其中，@RemoteParam注解的name属性指定了Web端访问时传递的参数名字。

3. 前端的调用

在前端的AJAX调用也十分简单：

var login = function () {
    var username = $("input[name='username']").val();
    var password = $("input[name='password']").val();
    $.post("dwr/userService/login", {username:username, password:password}, function (data) {
        if(data != null){
            // 登录成功
        }else{
            // 登录失败
        }
    },"json");
}

在这个调用方法中，我们通过$.post方法调用到了被@WebService注解标记为UserService的login方法，在这个方法中，我们将传递的参数名称设置为了username和password。