102 lines
3.9 KiB
C#
102 lines
3.9 KiB
C#
|
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-_.~";
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 针对 URL 中 path 编码，则需要先将其按照 '/'分割，然后进行逐个块进行 value 编码
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="path"></param>
|
|||
|
|
/// <returns></returns>
|
|||
|
|
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);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 针对单个value，则只需满足 URLAllowChars 不需要编码即可.
|
|||
|
|
/// urlEncode: 转为一个byte -> 转为两个16进制 -> 前面加上 %
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="value"></param>
|
|||
|
|
/// <param name="encoding"></param>
|
|||
|
|
/// <returns></returns>
|
|||
|
|
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();
|
|||
|
|
}
|
|||
|
|
/// <summary>
|
|||
|
|
/// 解码比较统一，此处借用 Uri 来实现
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="valueEncode"></param>
|
|||
|
|
/// <returns></returns>
|
|||
|
|
public static string Decode(string valueEncode)
|
|||
|
|
{
|
|||
|
|
if (String.IsNullOrEmpty(valueEncode)) return String.Empty;
|
|||
|
|
valueEncode.Replace('+', ' ');
|
|||
|
|
return Uri.UnescapeDataString(valueEncode);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|