核心定義
| 術語 | 定義 | 範例 | 備註 |
|---|
| NAME |
目錄或檔案的純名稱，不含路徑與 URL 結構 |
images/（目錄必須以斜線結尾）
data.txt（有副檔名）
readme（無副檔名） |
目錄名強制要求結尾 / |
| PATH |
相對根目錄的完整路徑 |
/root/images/ |
以 / 開頭，目錄亦以 / 結尾 |
| URL |
完整的檔案/目錄定位字串 |
file://host/root/images/photo.jpg
file://host/root/images/（目錄） |
協議固定為 file:// |
關鍵規則提醒
- 目錄的 NAME、PATH、URL 必須以斜線
/ 結尾，否則 API 會視為檔案導致操作失敗。
- 建立目錄時使用
fileConnector.mkdir()，傳入的 NAME 需含結尾斜線。
- 路徑分隔符統一使用正斜線
/，跨平台相容性最佳。
常見操作片段
// 取得檔案名稱
String name = fc.getName(); // 回傳 "photo.jpg"
// 取得路徑
String path = fc.getPath(); // 回傳 "/root/images/"
// 取得完整 URL
String url = fc.getURL(); // 回傳 "file://host/root/images/photo.jpg"
