DWR 3.0 純註解配置實戰（一）：零 XML、全 Java 代碼配置 Servlet

核心思路：Servlet 3.0+ 動態註冊 + 註解掃描替代 dwr.xml

DWR 3.0 支持純註解配置，結合 Servlet 3.0 ServletContainerInitializer 或 ServletContextListener 實現零 XML 部署。

完整配置代碼

public class DwrConfig implements ServletContextListener {
    
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        ServletContext ctx = sce.getServletContext();
        
        // 1. 動態註冊 DwrServlet
        DwrServlet dwrServlet = new DwrServlet();
        ServletRegistration.Dynamic reg = ctx.addServlet("dwr-invoker", dwrServlet);
        reg.setLoadOnStartup(2);
        reg.addMapping("/dwr/*");
        
        // 2. 核心初始化參數（必須設置）
        reg.setInitParameter("debug", "true");
        reg.setInitParameter("pollAndCometEnabled", "true");      // 支持長輪詢/Comet
        reg.setInitParameter("activeReverseAjaxEnabled", "true"); // 啟用反向 AJAX
        reg.setInitParameter("maxWaitAfterWrite", "1800000");     // 寫入後最大等待(ms)
        reg.setInitParameter("disconnectedTime", "60000");        // 斷開連接判定時間(ms)
        
        // 3. 關鍵：classes 參數指定註解類全限定名（多個用逗號分隔）
        // 注意：DWR 3.0 不支持包掃描，必須顯式列出
        reg.setInitParameter("classes", getAnnotatedClasses());
    }
    
    private String getAnnotatedClasses() {
        return String.join(",",
            "com.g360.bean.reconsole.opcost.AnnualOpCostRequestController",
            "com.g360.bean.security.SessionExpiredParam"
        );
    }
    
    @Override
    public void contextDestroyed(ServletContextEvent sce) {}
}

業務類註解示例

@Component("sessionExpiredParam") // Spring 管理
@RemoteProxy(
    creator = SpringCreator.class,      // 使用 Spring 創建器
    scope = ScriptScope.APPLICATION,    // 應用級單例
    name = "remote",                    // JS 端變量名
    creatorParams = @Param(name = "beanName", value = "sessionExpiredParam")
)
public class SessionExpiredParam {
    
    private static final Logger LOG = LoggerFactory.getLogger(SessionExpiredParam.class);
    
    public boolean isSessionExpire(String sessionId) {
        return ConstantCacheService.getCacheConstant(sessionId) == null;
    }
    
    @RemoteMethod // 必須標註才暴露給前端
    public void setEnableDwrUpdate(String sessionId) {
        ScriptSession scriptSession = WebContextFactory.get().getScriptSession();
        String jsessionId = scriptSession.getHttpSessionId();
        String dwrSessionId = scriptSession.getId();
        
        LOG.info("綁定推送: jsessionId=[{}], dwrSessionId=[{}]", jsessionId, dwrSessionId);
        // 將 DWR Session ID 存入緩存，供後端反向推送使用
        ConstantCacheService.putCacheConstant(Constants.PUSH_ID + jsessionId, dwrSessionId);
    }
}

等效傳統 dwr.xml 配置對照

<!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 3.0//EN" 
    "https://getahead.org/dwr/dwr30.dtd">
<dwr>
    <allow>
        <create creator="spring" javascript="remote" scope="application">
            <param name="beanName" value="sessionExpiredParam"/>
        </create>
    </allow>
</dwr>

關鍵注意事項

• classes 參數不可省略：DWR 3.0 無包掃描機制，必須顯式列出所有 @RemoteProxy 類全名。
• SpringCreator 需 Spring 上下文就緒：確保 ContextLoaderListener 在 DwrConfig 之前初始化（load-on-startup 順序）。
• ScriptScope 選擇：APPLICATION（全局單例）、SESSION（用戶會話）、PAGE（請求級）、SCRIPT_SESSION（DWR 會話）。
• 方法級控制：只有標註 @RemoteMethod 的公共方法會被暴露，其他方法保持私有。

常見啟動錯誤排查

下一步

下篇將詳細講解 前端調用後端方法 的完整流程、JS 代理生成機制、參數序列化細節與錯誤處理最佳實踐。