试用EF开发WEB应用程序(3): Query String （附图）

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

---

试用EF开发WEB应用程序(3): Query String

今天说一下如何在“易语言.飞扬”中使用FastCGI类库（fastcgi.efn）读取URL地址中的Query String。

什么是Query String？URL地址中问号（?）之后的文本即为Query String。以下面这个URL为例：

　　http://localhost:8080/querystring.efcgi?x=abc&y=ef&z=%E4%B8%AD%E5%9B%BD

以粗体显示并黄色背景加亮的部分（x=abc&y=ef&z=%E4%B8%AD%E5%9B%BD）即为Query String。如果把一个FastCGI程序比作一个函数调用的话，那么Query String 就相当于函数的参数。在这个例子中，FastCGI程序 querystring.efcgi 接收了三个参数，参数 x 的值为 abc，参数 y 的值为 ef，参数 z 的值为 %E4%B8%AD%E5%9B%BD （解码后是“中国”二字）。

为增加印象，再看几个 Query String 实例，GOOGLE（谷歌）、百度（BAIDU）和YAHOO（中国雅虎）搜索时产生的URL：

　　http://www.google.cn/search?hl=zh-CN&q=liigo&meta=&aq=f

　　http://www.baidu.com/s?ie=gb2312&bs=fastcgi.efn&sr=&z=&cl=3&f=8&wd=fastcgi.efn&ct=0

　　http://www.yahoo.cn/s?p=%E6%98%93%E8%AF%AD%E8%A8%80.%E9%A3%9E%E6%89%AC+ef+&v=web&pid=hp

Query String 在当今网络中的使用非常非常普遍，几乎随处可见。

在EF类库 fastcgi.efn 中，读取 Query String 主要涉及以下方法：

属性文本FCGI.QUERY_STRING(); // 获取URL解码之后的QUERY_STRING

文本FCGI.QUERY_STRING(文本name); // 取QUERY_STRING中指定名称的参数值，已经URL解码

文本[]FCGI.QUERY_STRING_NAMES(); // 取QUERY_STRING中的参数名称数组

属性文本FCGI.QUERY_STRING_UNDECODED(); // 返回原始的未经URL解码的QUERY_STRING

　　其中属性方法 QUERY_STRING()，其名称等同于同名的CGI环境变量，其返回值也是该环境变量的内容（但已经过URL解码）。（至于其它CGI环境变量，将在以后的文章中给予介绍。）

　　仍以前面的（第一个）URL为例，调用无参数的方法 fcgi.QUERY_STRING() 将返回“x=abc&y=ef&z=中国”，注意其中的“中国”二字已被解码出来。与此方法相对照的是 fcgi.QUERY_STRING_UNDECODED()，它将返回未经URL解码之前的Query String，即“x=abc&y=ef&z=%E4%B8%AD%E5%9B%BD”。调用带文本参数的方法 fcgi.QUERY_STRING(文本 name) 将返回指定参数的值，如 fcgi.QUERY_STRING("x") 将返回“abc”，fcgi.QUERY_STRING("y") 将返回“ef”，fcgi.QUERY_STRING("z") 将返回“中国”（经URL解码）。调用方法 fcgi.QUERY_STRING_NAMES() 将得到一个参数名称数组，{"x", "y", "z"}，数组各成员顺序与其在Query String出现的顺序一致。

　　注意，根据CGI规范，环境变量 QUERY_STRING 中存储的是“原始的、未经URL解码的”Query String，需要程序员读取后自行解码。而在我的EF类库中，QUERY_STRING () 方法直接返回了“URL解码后的”Query String。这也是充分考虑到了程序员的实际需求而进行的比较人性化的处理。如果确实需要“未经URL解码的”Query String，可调用 QUERY_STRING_UNDECODED() 方法获取，并未丢失功能性和灵活性。在这一点上，与普通的 CGI / FastCGI 程序有所不同，特此指出。

　　另外值得指出的是，读取、解码、解析Query String 的动作已专门经过优化并缓存结果，尽最大可能保证执行效率，这将在下一篇文章中详述。关于URL解码和URL编码，也将在今后的文章中介绍。

下面请看实际运行效果图（在线演示）：

以上动态网页的“易语言.飞扬”（EF）源代码如下：

引入fastcgi;

公开类启动类
{
公开静态启动()
{
int count = 0 ;
FCGIfcgi = new FCGI;
while (fcgi.Accept() >= 0 )
{
文本t = s.替换全部( " $(title) " , " QueryString " );
t = t.替换( " $(params) " ,get_params(fcgi));
t = t.替换( " $(index) " ,count.到文本());
fcgi.Output(t.到UTF8());
count ++ ;
}
}

static stringget_params(FCGIfcgi)
{
strings;

s += " <p>QUERY_STRING: " + fcgi.QUERY_STRING + " </p> " ;
s += " <p>QUERY_STRING_UNDECODED: " + fcgi.QUERY_STRING_UNDECODED + " </p> " ;
s += " <p>QUERY_STRING_NAMES: " + fcgi.QUERY_STRING_NAMES().到文本() + " </p> " ;

s += " <h3>PARAMES:</h3> " ;

遍历循环(fcgi.QUERY_STRING_NAMES(),文本name)
{
s += " <p> " + name + " : " + fcgi.QUERY_STRING(name) + " </p> " ;
}

return s;
}

常量文本s = [ " Content-type:text/html

< html >< head >
< metahttp - equiv = " content-type " content = " text/html;charset=utf-8 " >
< title > $(title) </ title >
</ head >
< body >
< h1 > $(title) </ h1 >
< hr ></ hr >
< p > $(params) </ p >
< hr ></ hr >
< p > byliigo,index:$(index) </ p >
</ body >
</ html >
" ];
}

下一篇文章内容预告：缓存Query String。