返回介绍

15.6.4 POST 的概念

发布于 2024-10-15 23:56:34 字数 6343 浏览 0 评论 0 收藏 0

在许多应用程序中使用 GET 都没有问题。但是,GET 要求通过一个环境变量将自己的数据传递给 CGI 程序。但假如 GET 字串过长,有些 Web 服务器可能用光自己的环境空间(若字串长度超过 200 字符,就应开始关心这方面的问题)。CGI 为此提供了一个解决方案:POST。通过 POST,数据可以编码,并按与 GET 相同的方法连结起来。但 POST 利用标准输入将编码过后的查询字串传递给 CGI 程序。我们要做的全部事情就是判断查询字串的长度,而这个长度已在环境变量 CONTENT_LENGTH 中保存好了。一旦知道了长度,就可自由分配存储空间,并从标准输入中读入指定数量的字符。

对一个用来控制 POST 的 CGI 程序,由 CGITools.h 提供的 Pair 和 CGI_vector 均可不加丝毫改变地使用。下面这段程序揭示了写这样的一个 CGI 程序有多么简单。这个例子将采用“纯”C++,所以 studio.h 库被 iostream(IO 数据流)代替。对于 iostream,我们可以使用两个预先定义好的对象:cin,用于同标准输入连接;以及 cout,用于同标准输出连接。有几个办法可从 cin 中读入数据以及向 cout 中写入。但下面这个程序准备采用标准方法:用“<<”将信息发给 cout,并用一个成员函数(此时是 read())从 cin 中读入数据:

//: POSTtest.cpp
// CGI_vector works as easily with POST as it
// does with GET. Written in "pure" C++.
#include <iostream.h>
#include "CGITools.h"

void main() {
  cout << "Content-type: text/plain\n" << endl;
  // For a CGI "POST," the server puts the length
  // of the content string in the environment 
  // variable CONTENT_LENGTH:
  char* clen = getenv("CONTENT_LENGTH");
  if(clen == 0) {
    cout << "Zero CONTENT_LENGTH" << endl;
    return;
  }
  int len = atoi(clen);
  char* query_str = new char[len + 1];
  cin.read(query_str, len);
  query_str[len] = '\0';
  CGI_vector query(query_str);
  // Test: dump all names and values
  for(int i = 0; i < query.size(); i++)
    cout << "query[" << i << "].name() = [" <<
      query[i].name() << "], " <<
      "query[" << i << "].value() = [" <<
      query[i].value() << "]" << endl;
  delete query_str; // Release storage
} ///:~

getenv() 函数返回指向一个字串的指针,那个字串指示着内容的长度。若指针为零,表明 CONTENT_LENGTH 环境变量尚未设置,所以肯定某个地方出了问题。否则就必须用 ANSI C 库函数 atoi() 将字串转换成一个整数。这个长度将与 new 一起运用,分配足够的存储空间,以便容纳查询字串(另加它的空中止符)。随后为 cin() 调用 read()。read() 函数需要取得指向目标缓冲区的一个指针以及要读入的字节数。随后用空字符(null)中止 query_str,指出已经抵达字串的末尾,这就叫作“空中止”。

到这个时候,我们得到的查询字串与 GET 查询字串已经没有什么区别,所以把它传递给用于 CGI_vector 的构建器。随后便和前例一样,我们可以自由 vector 内不同的字段。

为测试这个程序,必须把它编译到主机 Web 服务器的 cgi-bin 目录下。然后就可以写一个简单的 HTML 页进行测试,就象下面这样:

<HTML>
<HEAD>
<META CONTENT="text/html">
<TITLE>A test of standard HTML POST</TITLE>
</HEAD>
Test, uses standard html POST
<Form method="POST" ACTION="/cgi-bin/POSTtest">
<P>Field1: <INPUT TYPE = "text" NAME = "Field1" 
VALUE = "" size = "40"></p>
<P>Field2: <INPUT TYPE = "text" NAME = "Field2" 
VALUE = "" size = "40"></p>
<P>Field3: <INPUT TYPE = "text" NAME = "Field3" 
VALUE = "" size = "40"></p>
<P>Field4: <INPUT TYPE = "text" NAME = "Field4" 
VALUE = "" size = "40"></p>
<P>Field5: <INPUT TYPE = "text" NAME = "Field5" 
VALUE = "" size = "40"></p>
<P>Field6: <INPUT TYPE = "text" NAME = "Field6" 
VALUE = "" size = "40"></p>
<p><input type = "submit" name = "submit" > </p>
</Form>
</HTML>

填好这个表单并提交出去以后,会得到一个简单的文本页,其中包含了解析出来的结果。从中可知道 CGI 程序是否在正常工作。

当然,用一个程序片来提交数据显得更有趣一些。然而,POST 数据的提交属于一个不同的过程。在用常规方式调用了 CGI 程序以后,必须另行建立与服务器的一个连接,以便将查询字串反馈给它。服务器随后会进行一番处理,再通过标准输入将查询字串反馈回 CGI 程序。

为建立与服务器的一个直接连接,必须取得自己创建的 URL,然后调用 openConnection() 创建一个 URLConnection。但是,由于 URLConnection 一般不允许我们把数据发给它,所以必须很可笑地调用 setDoOutput(true) 函数,同时调用的还包括 setDoInput(true) 以及 setAllowUserInteraction(false)——注释⑥。最后,可调用 getOutputStream() 来创建一个 OutputStream(输出数据流),并把它封装到一个 DataOutputStream 里,以便能按传统方式同它通信。下面列出的便是一个用于完成上述工作的程序片,必须在从它的各个字段里收集了数据之后再执行它:

//: POSTtest.java
// An applet that sends its data via a CGI POST
import java.awt.*;
import java.applet.*;
import java.net.*;
import java.io.*;

public class POSTtest extends Applet {
  final static int SIZE = 10;
  Button submit = new Button("Submit");
  TextField[] t = new TextField[SIZE];
  String query = "";
  Label l = new Label();
  TextArea ta = new TextArea(15, 60);
  public void init() {
    Panel p = new Panel();
    p.setLayout(new GridLayout(t.length + 2, 2));
    for(int i = 0; i < t.length; i++) {
      p.add(new Label(
        "Field " + i + "  ", Label.RIGHT));
      p.add(t[i] = new TextField(30));
    }
    p.add(l);
    p.add(submit);
    add("North", p);
    add("South", ta);
  }
  public boolean action (Event evt, Object arg) {
    if(evt.target.equals(submit)) {
      query = "";
      ta.setText("");
      // Encode the query from the field data:
      for(int i = 0; i < t.length; i++)
         query += "Field" + i + "=" +
           URLEncoder.encode(
             t[i].getText().trim()) +
           "&";
      query += "submit=Submit";
      // Send the name using CGI's POST process:
      try {
        URL u = new URL(
          getDocumentBase(), "cgi-bin/POSTtest");
        URLConnection urlc = u.openConnection();
        urlc.setDoOutput(true);
        urlc.setDoInput(true);
        urlc.setAllowUserInteraction(false);
        DataOutputStream server = 
          new DataOutputStream(
            urlc.getOutputStream());
        // Send the data
        server.writeBytes(query);
        server.close();
        // Read and display the response. You
        // cannot use 
        // getAppletContext().showDocument(u);
        // to display the results as a Web page!
        DataInputStream in = 
          new DataInputStream(
            urlc.getInputStream());
        String s;
        while((s = in.readLine()) != null) {
          ta.appendText(s + "\n");
        }
        in.close();
      }
      catch (Exception e) {
        l.setText(e.toString());
      }
    }
    else return super.action(evt, arg);
    return true;
  }
} ///:~

⑥:我不得不说自己并没有真正理解这儿都发生了什么事情,这些概念都是从 Elliotte Rusty Harold 编著的《Java Network Programming》里得来的,该书由 O'Reilly 于 1997 年出版。他在书中提到了 Java 连网函数库中出现的许多令人迷惑的 Bug。所以一旦涉足这些领域,事情就不是编写代码,然后让它自己运行那么简单。一定要警惕潜在的陷阱!

信息发送到服务器后,我们调用 getInputStream(),并把返回值封装到一个 DataInputStream 里,以便自己能读取结果。要注意的一件事情是结果以文本行的形式显示在一个 TextArea(文本区域)中。为什么不简单地使用 getAppletContext().showDocument(u) 呢?事实上,这正是那些陷阱中的一个。上述代码可以很好地工作,但假如试图换用 showDocument(),几乎一切都会停止运行。也就是说,showDocument() 确实可以运行,但从 POSTtest 得到的返回结果是“Zero CONTENT_LENGTH”(内容长度为零)。所以不知道为什么原因,showDocument() 阻止了 POST 查询向 CGI 程序的传递。我很难判断这到底是一个在以后版本里会修复的 Bug,还是由于我的理解不够(我看过的书对此讲得都很模糊)。但无论在哪种情况下,只要能坚持在文本区域里观看自 CGI 程序返回的内容,上述程序片运行时就没有问题。

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文