using System; using System.Collections.Generic; using System.Text; using System.Globalization; /** * Copyright (c) 2018 Tencent Cloud. All rights reserved. * 11/5/2018 5:40:47 PM * bradyxiao */ namespace COSXML.Utils { /** * URL Encode: * 可分为绝对不需要编码的字符:[a~z][A~A][0~9][._-~] * 特殊字符需要视情况而言:!*'();:@&=+$,/?#[] * 空字符用+或者%20代替 * 汉字绝地需要编码 * 因此,针对完整URL则要分块进行编码:path块,query块,fragment块,host块 * path块,需要以'/'进行分割,即 '/' 不需要编码,其它均需要编码 * query块,需要以'&'分割一对对key=value;key 和 value 需要编码, "="不编码 * fragment,全部进行编码 * URL Decode: * 不需要判断是否是特殊字符,因为其解码规则很简单,直接根据内容中是否出现%来判断是否需要解码, * 还是直接输出:若出现了%,则连续读出其后两位进行解码;反之,直接输出 */ public sealed class URLEncodeUtils { //只有字母和数字[0-9a-zA-Z]、一些特殊符号"-_.!*~',以及某些保留字,才可以不经过编码直接用于URL。" public const string URLAllowChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_.~"; /// /// 针对 URL 中 path 编码,则需要先将其按照 '/'分割,然后进行逐个块进行 value 编码 /// /// /// public static string EncodePathOfURL(string path) { if (String.IsNullOrEmpty(path)) return String.Empty; char separator = '/'; int start = 0, length = path.Length; int index = path.IndexOf(separator, start); StringBuilder result = new StringBuilder(); while (index != -1 && start < length) { if (start != index) { result.Append(Encode(path.Substring(start, index - start))); } result.Append(separator); start = index + 1; index = path.IndexOf(separator, start); } if(start < length) result.Append(Encode(path.Substring(start))); return result.ToString(); } public static string Encode(string value) { return Encode(value, Encoding.UTF8); } /// /// 针对单个value,则只需满足 URLAllowChars 不需要编码即可. /// urlEncode: 转为一个byte -> 转为两个16进制 -> 前面加上 % /// /// /// /// public static string Encode(string value, Encoding encoding) { if (String.IsNullOrEmpty(value)) return String.Empty; StringBuilder result = new StringBuilder(value.Length * 2); // %xy%xy byte[] strToBytes = encoding.GetBytes(value); foreach(byte b in strToBytes) { char ch = (char)b; if(URLAllowChars.IndexOf(ch) != -1) { result.Append(ch); } else { result.Append('%').Append(String.Format(CultureInfo.InvariantCulture, "{0:X2}", (int)b)); } } return result.ToString(); } /// /// 解码比较统一,此处借用 Uri 来实现 /// /// /// public static string Decode(string valueEncode) { if (String.IsNullOrEmpty(valueEncode)) return String.Empty; valueEncode.Replace('+', ' '); return Uri.UnescapeDataString(valueEncode); } } }