Jakarta Commons 組件庫精華指南（上）：Web 組件與小程序工具包

項目簡介

Jakarta Commons（現 Apache Commons Proper）旨在提供獨立、可復用的 Java 組件，多源自 Struts、Tomcat 等項目共性代碼抽取。組件間低耦合，專注小范圍功能，適合服務端開發。本文覆蓋 Web 相關與小程序兩大類。

一、小程序類組件

1. CLI：命令行解析器

用途：統一處理命令行參數，支援選項、參數值、幫助生成。

// 定義選項
Options opts = new Options();
opts.addOption("t", false, "show current time");
opts.addOption("n", true, "your name");

// 解析
CommandLineParser parser = new BasicParser();
CommandLine cmd = parser.parse(opts, args);

if (cmd.hasOption("n")) 
    System.out.println("Hello " + cmd.getOptionValue("n"));

核心類：Options、Option、CommandLineParser、CommandLine。

2. Discovery：服務發現機制

用途：運行時定位介面實現類（SPI 模式），支援 META-INF/services、系統屬性、類加載器多種策略。

// 獲取類加載器
ClassLoaders loaders = ClassLoaders.getAppLoaders(MyInterface.class, getClass(), false);
// 發現並實例化
DiscoverClass discover = new DiscoverClass(loaders);
MyInterface impl = (MyInterface) discover.newInstance(MyInterface.class);
impl.doWork();

遵循 Sun Service Provider 規範，適用於插件架構、驅動加載。

3. Lang：java.lang 增強包

核心亮點：

• StringUtils：capitalize()、isBlank()、join()、split() 等 100+ 靜態方法
• RandomStringUtils：生成隨機字符串/密碼
• NumberUtils：數字解析、比較、範圍
• Builder 系列：ToStringBuilder、EqualsBuilder、HashCodeBuilder、CompareToBuilder —— 一鍵生成高質量標準方法
• Enum：類型安全枚舉基類（Java 5 前的替代方案）

// ToStringBuilder 示例
public String toString() {
    return new ToStringBuilder(this)
        .append("rate", rate)
        .append("years", years)
        .toString();
}

4. Collections：集合框架擴展

關鍵數據結構：

二、Web 相關組件

1. FileUpload：文件上傳標準實現

特性：RFC1867 兼容、流式解析、閾值自動切換內存/臨時文件、大小限制、進度監聽。

// JSP 表單 enctype="multipart/form-data" method="post"
// Servlet 處理
DiskFileUpload upload = new DiskFileUpload();
List items = upload.parseRequest(request);
for (FileItem item : items) {
    if (item.isFormField()) {
        // 普通字段
    } else {
        // 文件字段
        File saved = new File(uploadDir, FilenameUtils.getName(item.getName()));
        item.write(saved);
    }
}

2. HttpClient：功能完備的 HTTP 客戶端

優於 java.net：連接池、認證、重定向、Cookie 管理、HTTPS/SSL、多線程安全、流式上傳下載。

HttpClient client = new HttpClient();
GetMethod method = new GetMethod("https://www.paypal.com/");
client.executeMethod(method);
String body = method.getResponseBodyAsString();
method.releaseConnection(); // 必須釋放連接回池

支援 GET/POST/PUT/DELETE/HEAD/OPTIONS/TRACE，適合爬蟲、API 集成、代理網關。

3. Net：網絡協議底層工具箱

源自商業產品 NetComponents，封裝 FTP、NNTP、POP3、SMTP、Telnet、Finger、Whois、Time 等協議客戶端。

NNTPClient nntp = new NNTPClient();
nntp.connect("news.example.com");
NewsgroupInfo[] groups = nntp.listNewsgroups();
nntp.disconnect();

統一模式：connect() → 協議命令 → disconnect()，屏蔽 Socket 細節。

總結與展望

Commons 組件體現「小而美」的 Unix 哲學：各司其職、組合強大。下篇將介紹 XML 相關（Betwixt、Digester、Jelly、JXPath）、打包類（Codec、Modeler）及工具類（BeanUtils、Logging、DBCP、Pool、Validator）。

1. 上一篇文章： 技術動態：Windows Server Longhorn 預覽版發布與 Java SE 6 夏時制更新
2. 下一篇文章： FCKeditor 線上編輯器整合指南：Java 環境完整部署步驟

Java 程式設計入門

Eclipse 啟動報「Incompatible JVM」完美解決：JDK 路徑優先級與 oracle 衝突排查

安裝 Oracle Client 後 Eclipse 無法啟

N 皇後問題 Java 實現：回溯算法核心邏輯、棋盤狀態管理與解空間可視化完整教程

問題定義 在 N×N 棋盤上放置 N 個皇後，任意兩個皇後不

Java 呼叫 MATLAB 完整實戰：MATLAB Builder JA 部署與跨平台執行指南

將 MATLAB 演算法封裝為 Java 可呼叫的元件，是企

Java 八皇后問題：隨機搜尋與八進制遍歷雙演算法完整實作

問題定義 8×8 棋盤放置 8 個皇后，任兩個不同行、不同列