Java FTP 客戶端開發：連接管理模塊核心代碼深度解析

本文為 FTP 客戶端系列第八篇，詳細剖析 FTP 連接建立與斷開的核心邏輯、異常處理及 UI 狀態同步機制。

連接建立流程

用戶輸入服務器 IP、端口（默認 21）、用戶名、密碼後點擊「連接」，觸發 linkButtonActionPerformed 方法，核心步驟：

1. 參數校驗與默認值處理
2. 調用 FtpClient.openServer() 建立 TCP 連接
3. 發送 USER/PASS 指令完成認證
4. 設置二進制傳輸模式（TYPE I）
5. 連接成功後：啟用斷開按鈕、綁定雙側面板 FTP 客戶端實例、刷新遠程文件列表、啟動任務隊列線程

private void linkButtonActionPerformed(ActionEvent evt) {
    try {
        String server = serverTextField.getText();
        int port = Integer.parseInt(portTextField.getText().trim() == "" ? "21" : portTextField.getText().trim());
        String user = userTextField.getText().trim();
        String pass = new String(PassField.getPassword()).trim();

        cutLinkButton.doClick(); // 先斷開舊連接
        ftpClient = new FtpClient();
        ftpClient.openServer(server, port);
        ftpClient.login(user, pass);
        ftpClient.binary();

        if (ftpClient.serverIsOpen()) {
            CUT_LINK_ACTION.setEnabled(true);
            localPanel.setFtpClient(server, port, user, pass);
            ftpPanel.setFtpClient(ftpClient);
            localPanel.getActionMap().get("uploadAction").setEnabled(true);
            ftpPanel.getActionMap().get("downAction").setEnabled(true);
            ftpPanel.refreshCurrentFolder();
            queuePanel.startQueue();
        }
    } catch (Exception ex) {
        ex.printStackTrace();
    }
}

斷開連接邏輯

點擊「斷開」觸發 CutLinkAction.actionPerformed，執行清理操作：

• 停止上傳/下載線程
• 清空本地與遠程任務隊列
• 清除文件表格數據
• 發送 QUIT 指令並讀取響應
• 置空 ftpClient 引用，禁用相關操作按鈕

public void actionPerformed(ActionEvent e) {
    try {
        frame.ftpPanel.stopDownThread();
        frame.localPanel.stopUploadThread();
        frame.getFtpPanel().getQueue().clear();
        frame.getFtpPanel().clearTable();
        frame.getLocalPanel().getQueue().clear();

        if (frame.ftpClient != null && frame.ftpClient.serverIsOpen()) {
            frame.ftpClient.sendServer("QUIT\r\n");
            frame.ftpClient.readServerResponse();
            frame.ftpClient = null;
        }
        // 禁用按鈕...
    } catch (IOException e1) {
        e1.printStackTrace();
    }
}

流程圖解

關鍵設計點

• 資源安全釋放：確保 Socket、流、線程全部正確關閉
• 狀態一致性：UI 組件啟用狀態與連接狀態強綁定
• 異常隔離：單個操作失敗不影響整體框架運行