SAP的’cl_http_utility=>escape_url’對URL進行安全編碼方法詳解

核心作用：對 URL 進行安全編碼，將特殊字符轉換為 %XX 格式，確保符合 HTTP 傳輸規范。

---

1. 功能與作用

? URL 安全編碼
將非安全字符轉換為十六進制 ASCII 碼（%XX）：

空格   → %20    中文 → %E4%B8%AD（UTF-8）
&     → %26    ?   → %3F

🚀 典型場景

• 構造 GET 請求參數（?key=value）
• 傳遞含特殊字符的路徑（如 file name.docx）
• 防御 URL 注入攻擊

---

2. 語法與參數

CALL METHOD cl_http_utility=>escape_urlEXPORTING unescaped = lv_original_string  " 輸入：原始字符串RECEIVING escaped   = lv_encoded_string.  " 輸出：編碼后字符串

---

3. 編碼規則

字符類型	處理方式	示例
安全字符	保留原樣	a-z/0-9/-/_
必須編碼的符號	轉義為 %XX	空格→%20, &→%26
非 ASCII 字符	UTF-8 編碼后逐字節轉義	“中文” → %E4%B8%AD%E6%96%87

📌 關鍵細節：

• 路徑分隔符 / 會被編碼為 %2F
• 不兼容 HTML 表單的空格轉 + 規則（需手動處理）

---

4. 實際示例

場景：構造含中文和符號的 URL 參數

DATA: lv_name    TYPE string VALUE '張三 & 李四',lv_encoded TYPE string." 編碼特殊字符
CALL METHOD cl_http_utility=>escape_urlEXPORTING unescaped = lv_name RECEIVING escaped   = lv_encoded. " 結果：%E5%BC%A0%E4%B8%89%20%26%20%E6%9D%8E%E5%9B%9B" 拼接完整 URL
DATA(lv_url) = |https://example.com/api?name={ lv_encoded }|.

解碼操作：

CALL METHOD cl_http_utility=>unescape_urlEXPORTING escaped   = lv_encoded RECEIVING unescaped = lv_name.  " 還原為'張三 & 李四'

---

5. 關鍵注意事項

?? 字符集要求
源字符串 必須是 UTF-8 編碼，否則中文字符會亂碼！

🔄 編碼方案對比

方法	適用場景	輸出示例
escape_url	URL 參數	%E4%B8%AD
encode_base64	二進制數據（如圖片）	5Lit

? 常見陷阱

• 雙重編碼：重復調用會生成 %25XX（如 %20 → %2520）
• 未編碼導致截斷：param=value 1&name=a/b 中的空格和 & 會破壞 URL 結構

---

6. 最佳實踐總結

1. 強制編碼：所有動態生成的 URL 參數必須調用此方法
2. 字符集驗證：確保系統環境支持 UTF-8
3. 避免過度編碼：僅需調用一次，不可嵌套使用
4. 兼容性處理：若目標系統要求 + 代替空格，需額外轉換：

   REPLACE ALL OCCURRENCES OF '%20' IN lv_encoded WITH '+'.
   

💡 應用場景：
在 cl_http_client 請求、ICF 服務開發、RESTful API 調用中，此方法是保障 URL 傳輸安全的基石。