试用EF开发WEB应用程序(5): URL编码和URL解码

题记：用“易语言.飞扬”（EF）开发WEB应用程序，此前还没有先例。但因为EF本地开发包（EFNDK）已经发布，用C/C++开发一个EF类库，使其支持EF开发WEB应用程序，应该并非难事。当然也可想而知，其中必有诸多难点有待解决。此系列文章，为本人探索过程之记录，对外人未必有多大价值。如有网友乐观其事，还请理性待之。作者：liigo。转载请务必注明出处：http://blog.csdn.net/liigo/。在线留言。

---

试用EF开发WEB应用程序(5): URL编码和URL解码 

 

之前的文章提到，Query String是URL的一部分，那么其内容应当遵守URL的语法规则，例如不能出现 ; / ? = & 等特定字符，也不应该包含汉字字符。通常，在需要组合生成一个URL时，需要对Query String中的内容（尤其是value部分）进行“URL编码”，以确保得到一个合法的URL；在处理一个URL请求时，需要对Query String进行“URL解码”，以便还原到“URL编码”之前的Query String。CGI / FastCGI 程序在处理HTTP请求时，其从环境变量 QUERY_STRING 中获取的内容，即为已经过“URL编码”的Query String。

以之前文章中出现的URL “http://localhost:8080/querystring.efcgi?x=abc&y=ef&z=%E4%B8%AD%E5%9B%BD” 为例，其中“%E4%B8%AD%E5%9B%BD” 部分就是“URL编码”后的结果，经过“URL解码”之后，是汉字“中国”二字。

考虑到“URL编码”和“URL解码”是常见操作，EF类库 fastcgi.efn 中提供了这两项功能，同时对环境变量 QUERY_STRING 中的内容自动进行“URL解码”。

 

在EF类库 fastcgi.efn 中，实现“URL编码”的C++代码如下：

EFChar* URLEncode(EFChar* url, EF_MiniMem& buffer)
{
    EFChar c;
    EFChar hexOutputBuffer[2];
    EF_MiniMem mem;

    int n = EF_strlen(url);
    buffer.Alloc(n << 1);
    buffer.Empty();

    for(int i = 0; i < n; i++)
    {
        c = url[i];
        if( (c>='a' && c<='z') || (c>='0' && c<='9') || (c>='A' && c<='Z') 
            || (strchr("-_.", c) != NULL) )
        {
            buffer.AddChar(c);
        }
        else if(c == ' ')
        {
            buffer.AddChar(myC('+'));
        }
        else
        {
            if(c <= 255)
            {
                _URLEncode_addEncodeChar((unsigned char)c, buffer, hexOutputBuffer);
            }
            else
            {
                const char* utf8 = (const char*) EF_UCS_to_UTF8(&c, 1, mem);
                int len = strlen(utf8);
                for(int j = 0; j < len; j++)
                {
                    _URLEncode_addEncodeChar(utf8[j], buffer, hexOutputBuffer);
                }
            }
        }
    }
    buffer.AddChar(myC('

 在EF中，调用 FCGI.URLEncode() 即可进行“URL编码”工作。

 

在EF类库 fastcgi.efn 中，实现“URL解码”的C++代码如下：

EFChar* URLDecode(EFChar* url, EF_MiniMem& buffer)
{
    EFChar c, *pc;
    unsigned char utf8[3];
    EF_MiniMem mem;

    int n = EF_strlen(url);
    buffer.Alloc(n);
    buffer.Empty();

    for(int i = 0; i < n; i++)
    {
        c = url[i];
        if(c != myC('%'))
        {
            buffer.AddChar((c == myC('+') ? myC(' ') : c)); 
            continue;
        }
        utf8[0] = fromhex(&url[i+1]);
        if((utf8[0] & 0x80) == 0) //0xxxxxxx
        {
            buffer.AddChar((EFChar)utf8[0]);
            i += 2;
        }
        else if((utf8[0] >> 5) == 6) //110xxxxx
        {
            if(n - i >= 6 && url[i+3] == myC('%'))
            {
                utf8[1] = fromhex(&url[i+4]); ASSERT(utf8[1] >> 6 == 2); //10xxxxxx
                pc = EF_UTF8_to_UCS((char*)utf8, 2, mem);
                ASSERT(pc && EF_strlen(pc) == 1);
                if(pc == NULL) return NULL;
                buffer.AddChar(*pc);
                i += 5;
            }
            else return NULL;
        }
        else if((utf8[0] >> 4) == 0x0E) //1110xxxx
        {
            if(n - i >= 9 && url[i+3] == myC('%') && url[i+6] == myC('%'))
            {
                utf8[1] = fromhex(&url[i+4]); ASSERT(utf8[1] >> 6 == 2); //10xxxxxx
                utf8[2] = fromhex(&url[i+7]); ASSERT(utf8[2] >> 6 == 2); //10xxxxxx
                pc = EF_UTF8_to_UCS((char*)utf8, 3, mem);
                ASSERT(pc && EF_strlen(pc) == 1);
                if(pc == NULL) return NULL;
                buffer.AddChar(*pc);
                i += 8;
            }
            else return NULL;
        }
        else
            return NULL;
    }

    buffer.AddChar(myC('

 在EF中，调用 FCGI.URLDecode() 即可进行“URL解码”工作。

 

网络浏览器在处理用户提交的FORM数据时，也会自动将FORM中的数据生成经过“URL编码”的Query String。在实践中发现，如果FORM所属HTML文件的编码为UTF-8，则汉字是按其UTF-8编码数据进行“URL编码”；如果FORM所属HTML文件的编码未指定或为非UTF-8编码，则汉字可能不是按其UTF-8编码数据进行“URL编码”。本文上面所列代码，只能按UTF-8编码进行“URL编码”和“URL解码”，使用时需要注意。

如果代码有错误或疏忽、遗漏之处，请各位批评指正。 

 

下文预告：解析Query String中的各参数值