J2EE Web 服務客戶端質量報告實戰（一）：架構設計與服務端原型構建

本系列開幕篇，確立基於真實客戶端視角的事務響應時間測量架構，構建服務端 EJB 原型，為後續客戶端報告收集、SOAP 附件傳輸、異步持久化奠定基礎。

一、問題背景與核心思想

1. 傳統監控盲區

• HTTP 日志僅記錄請求級別，無法關聯多請求組成的業務事務
2. 網絡傳輸延遲、客戶端本地處理耗時不可見 3. 自定義日志分析成本高、模型脆弱、難以標準化

2. 核心解法：客戶端主動測量 + 業務請求攜帶上報

• 測量點：客戶端進程內部，涵蓋網絡+服務端+客戶端處理全鏈路
• 上報機制：報告作為 SOAP 附件，隨下一個業務請求攜帶發送
• 零額外通信：無專用監控連接，無額外網絡開銷
• 異步持久化：服務端剝離報告 → JMS 隊列 → MDB 入庫，不阻塞業務
• 容錯優先：監控鏈路任意環節失敗，決不影響業務事務完成

二、系統架構全景

核心組件

三、業務事務模型

• 典型模式：提交工作 → 輪詢狀態 → 獲取結果 (3+ 次 Web 服務調用)
• 句柄機制：首次調用返回 transactionID，後續調用攜帶該 ID
• 客戶端事務邊界：從首次調用發起到最終結果返回

四、服務端原型：XactBean EJB

1. 設計意圖

• 單一 Session Bean 模擬核心業務流程
• 三業務方法對應提交/檢查/獲取結果
• 內部狀態極簡，聚焦監控架構驗證

2. 完整實現代碼

package TransactionProcessor;
import javax.ejb.*;
import java.rmi.server.*;
import java.util.*;

public class XactBean implements javax.ejb.SessionBean {
    private javax.ejb.SessionContext context;
    private int mRandom; // 模擬事務 ID

    public void setSessionContext(SessionContext aContext) { context = aContext; }
    public void ejbActivate() {}
    public void ejbPassivate() {}
    public void ejbRemove() {}

    public void ejbCreate() {
        Random r = new Random();
        mRandom = r.nextInt(10000); // 生成唯一事務標識
    }

    // 業務方法 1：提交工作，返回事務句柄
    public java.lang.String SubmitWork(java.lang.String Work) {
        return new Integer(mRandom).toString();
    }

    // 業務方法 2：檢查工作狀態 (總是返回 true 模擬即時完成)
    public boolean CheckWork(java.lang.String Xact) {
        return true;
    }

    // 業務方法 3：獲取結果 (返回同一事務標識)
    public java.lang.String GetResult(java.lang.String Xact) {
        return new Integer(mRandom).toString();
    }
}

3. 方法語義映射

五、架構優勢總結

1. 真實用戶視角：測量包含網絡、服務端、客戶端處理的端到端延遲
2. 零業務侵入：EJB 業務代碼無任何監控相關邏輯
3. 輕量級傳輸：報告攜帶於現有 SOAP 消息，無額外連接
4. 異步解耦：JMS 隊列緩衝，MDB 獨立資源池，不搶佔業務線程
5. 標準化技術棧：JAX-RPC、SOAP、JMS、EJB — 可移植至任意 J2EE 容器
6. 容錯彈性：監控鏈路全鏈路 try-catch，業務 SLA 不受監控可用性影響

六、系列規劃

1. 架構設計與服務端原型 (本文)
2. 服務端 Tie 類改造：報告剝離與入隊 3. Payload 核心包：報告模型、事務管理、序列化傳輸引擎 4. 客戶端 Stub 改造、MDB 實現、應用組裝部署 5. 樣品客戶端構建、JMS 配置、端到端驗證與改進

完整源碼可從 Resources 下載，基於 Sun ONE Studio Enterprise Edition Update 1 + Sun ONE Application Server 構建，原理通用於所有 J2EE 實現。