Java 微信企業號通訊錄開發實戰：樹狀架構與成員管理

功能架構概覽

企業通訊錄模組包含三大核心視圖：部門樹狀結構展示、部門成員列表、成員詳細信息查看。採用 ZTree 實現交互式部門樹，jQuery Mobile 適配移動端列表展示。

後端核心實現

Controller 層：三大接口

// 獲取部門樹數據（返回 JSON 格式供 ZTree 渲染）
@RequestMapping("/addressListDepartmentjsp.do")
public void addressListDepartment(HttpServletRequest request, HttpServletResponse response)

// 獲取部門成員列表
@RequestMapping("/addressListUserList.do")
public String addressListUserList(HttpServletRequest request, HttpServletResponse response)

// 查看成員詳細信息
@RequestMapping("/addressListUserInfo.do")
public String addressListUserInfo(HttpServletRequest request, HttpServletResponse response)

Service 層：微信 API 串接與數據轉換

核心邏輯：獲取 access_token → 調用微信部門/用戶 API → 轉換為前端所需格式。關鍵轉換邏輯在 convertList() 中：遍歷部門列表，判斷父子關係構建 ZTree 節點，父節點無 URL（點擊展開），葉子節點帶跳轉鏈接攜帶部門 ID 與名稱。

// 部門列表轉 ZTree 節點
public List<JsonTree> convertList(List<Department> departmentList) {
    // 雙重循環判斷父子關係，構建 id、pId、name、open、url 等屬性
    // 父節點 url 為空，葉子節點 url 指向成員列表頁
}

工具類：微信 API 封裝

AdvancedUtil.getDepartment() 與 getUserDetail() 封裝 HTTPS GET 請求，解析 JSON 回應映射為 Department、UserDetail 實體。access_token 由 CommonUtil.getAccessToken() 統一獲取並緩存。

前端交互實現

ZTree 配置與初始化

• 簡單數據模式（simpleData.enable: true）自動識別 id/pId 構建樹
• 自定義 DOM 渲染（addDiyDom）實現層級縮進與圖標控制
• beforeClick 回調攔截父節點點擊：有子節點則展開而不跳轉，葉子節點正常跳轉
• getAllChildrenNodes 遞歸收集所有子節點 ID，判斷是否為葉子節點

樣式定制

CSS 覆蓋 ZTree 默認樣式：字體微軟雅黑、行高 30px、懸停背景色、選中態樣式、自定義展開/折疊圖標，完美適配企業級 UI 風格。

關鍵技術點總結

1. 微信企業號 API 調用鏈：token 管理 → 部門列表 → 成員詳情
2. 樹形數據構建：扁平列表轉巢狀結構，O(n²) 算法適用於中小規模部門
3. 前後端協議：Controller 返回 JSON/視圖，Service 隔離第三方 API 細節
4. 移動端適配：jQuery Mobile 提供原生體驗的列表與詳情頁

擴展建議

• 部門數據量大時優化 convertList 為 O(n) 映射算法
• 引入 Redis 緩存 access_token 及部門/用戶數據，減少微信 API 調用頻率
• 增加搜索、標籤篩選、批量操作等企業級功能