程序片2007-05-29 yycnet.yeah.net yyc译程序片实际要比NameSender.java简单一些。这部分是由于很容易即可发出一个GET请求。此外，也不必等候回复信息。现在有两个字段，而非一个，但大家会发现许多程序片都是熟悉的，请比较NameSender.java。
//: NameSender2.java// An applet that sends an email address// via a CGI GET, using Java 1.02.import java.awt.*;import java.applet.*;import java.net.*;import java.io.*;public class NameSender2 extends Applet {final String CGIProgram = "Listmgr2.exe";Button send = new Button（"Add email address to mailing list"）;TextField name = new TextField（"type your name here", 40）,email = new TextField（"type your email address here", 40）;String str = new String（）;Label l = new Label（）, l2 = new Label（）;int vcount = 0;public void init（） {setLayout（new BorderLayout（））;Panel p = new Panel（）;p.setLayout（new GridLayout（3, 1））;p.add（name）;p.add（email）;p.add（send）;add（"North", p）;Panel labels = new Panel（）;labels.setLayout（new GridLayout（2, 1））;labels.add（l）;labels.add（l2）;add（"Center", labels）;l.setText（"Ready to send email address"）;}public boolean action （Event evt, Object arg） {if（evt.target.equals（send）） {l2.setText（""）;// Check for errors in data:if（name.getText（）.trim（） .indexOf（" "） == -1） {l.setText（"Please give first and last name"）;l2.setText（""）;return true;}str = email.getText（）.trim（）;if（str.indexOf（" "） ！= -1） {l.setText（"Spaces not allowed in email name"）;l2.setText（""）;return true;}if（str.indexOf（","） ！= -1） {l.setText（"Commas not allowed in email name"）;return true;}if（str.indexOf（"@"） == -1） {l.setText（"Email name must include "@""）;l2.setText（""）;return true;}if（str.indexOf（"@"） == 0） {l.setText（"Name must preceed "@" in email name"）;l2.setText（""）;return true;}String end = str.substring（str.indexOf（"@"））;if（end.indexOf（"."） == -1） {l.setText（"Portion after "@" must " +"have an extension, such as ".com""）;l2.setText（""）;return true;}// Build and encode the email data:String emailData = "name=" + URLEncoder.encode（name.getText（）.trim（）） +"&email=" + URLEncoder.encode（email.getText（）.trim（）.toLowerCase（）） +"&submit=Submit";// Send the name using CGI"s GET process:try {l.setText（"Sending..."）;URL u = new URL（getDocumentBase（）, "cgi-bin/" +CGIProgram + "？" + emailData）;l.setText（"Sent: " + email.getText（））;send.setLabel（"Re-send"）;l2.setText（"Waiting for reply " + ++vcount）;DataInputStream server =new DataInputStream（u.openStream（））;String line;while（（line = server.readLine（）） ！= null）l2.setText（line）;} catch（MalformedURLException e） {l.setText（"Bad URl"）;} catch（IOException e） {l.setText（"IO Exception"）;} }else return super.action（evt, arg）;return true;}} ///:~
CGI程序（不久即可看到）的名字是Listmgr2.exe。许多Web服务器都在Unix机器上运行（Linux也越来越受到青睐）。根据传统，它们一般不为自己的可执行程序采用.exe扩展名。但在Unix操作系统中，可以把自己的程序称呼为自己希望的任何东西。若使用的是.exe扩展名，程序毋需任何修改即可通过Unix和Win32的运行测试。
和往常一样，程序片设置了自己的用户界面（这次是两个输入字段，不是一个）。唯一显著的区别是在action（）方法内产生的。该方法的作用是对按钮按下事件进行控制。名字检查过以后，大家会发现下述代码行：
String emailData = "name=" + URLEncoder.encode（name.getText（）.trim（）） +"&email=" + URLEncoder.encode（email.getText（）.trim（）.toLowerCase（）） +"&submit=Submit";// Send the name using CGI"s GET process:try {l.setText（"Sending..."）;URL u = new URL（getDocumentBase（）, "cgi-bin/" +CGIProgram + "？" + emailData）;l.setText（"Sent: " + email.getText（））;send.setLabel（"Re-send"）;l2.setText（"Waiting for reply " + ++vcount）;DataInputStream server =new DataInputStream（u.openStream（））;String line;while（（line = server.readLine（）） ！= null）l2.setText（line）;// ...
name和email数据都是它们对应的文字框里提取出来，而且两端多余的空格都用trim（）剔去了。为了进入列表，email名字被强制换成小写形式，以便能够准确地对比（防止基于大小写形式的错误判断）。来自每个字段的数据都编码为URL形式，随后采用与HTML页中一样的方式汇编GET字串（这样一来，我们可将Java程序片与现有的任何CGI程序结合使用，以满足常规的HTML GET请求）。
到这时，一些Java的魔力已经开始发挥作用了：如果想同任何URL连接，只需创建一个URL对象，并将地址传递给构建器即可。构建器会负责建立同服务器的连接（对Web服务器来说，所有连接行动都是根据作为URL使用的字串来判断的）。就目前这种情况来说，URL指向的是当前Web站点的cgi-bin目录（当前Web站点的基础地址是用getDocumentBase（）设定的）。一旦Web服务器在URL中看到了一个“cgi-bin”，会接着希望在它后面跟随了cgi-bin目录内的某个程序的名字，那是我们要运行的目标程序。程序名后面是一个问号以及CGI程序会在QUERY_STRING环境变量中查找的一个参数字串（马上就要学到）。
我们发出任何形式的请求后，一般都会得到一个回应的HTML页。但若使用Java的URL对象，我们可以拦截自CGI程序传回的任何东西，只需从URL对象里取得一个InputStream（输入数据流）即可。这是用URL对象的openStream（）方法实现，它要封装到一个DataInputStream里。随后就可以读取数据行，若readLine（）返回一个null（空值），就表明CGI程序已结束了它的输出。
我们即将看到的CGI程序返回的仅仅是一行，它是用于标志成功与否（以及失败的具体原因）的一个字串。这一行会被捕获并置放第二个Label字段里，使用户看到具体发生了什么事情。
1. 从程序片里显示一个Web页
程序亦可将CGI程序的结果作为一个Web页显示出来，就象它们在普通HTML模式中运行那样。可用下述代码做到这一点：
getAppletContext（）.showDocument（u）;
其中，u代表URL对象。这是将我们重新定向于另一个Web页的一个简单例子。那个页凑巧是一个CGI程序的输出，但可以非常方便地进入一个原始的HTML页，所以可以构建这个程序片，令其产生一个由密码保护的网关，通过它进入自己Web站点的特殊部分：
//: ShowHTML.javaimport java.awt.*;import java.applet.*;import java.net.*;import java.io.*;public class ShowHTML extends Applet {static final String CGIProgram = "MyCGIProgram";Button send = new Button（"Go"）;Label l = new Label（）;public void init（） {add（send）;add（l）;}public boolean action （Event evt, Object arg） {if（evt.target.equals（send）） {try {// This could be an HTML page instead of// a CGI program. Notice that this CGI // program doesn"t use arguments, but // you can add them in the usual way.URL u = new URL（getDocumentBase（）, "cgi-bin/" + CGIProgram）;// Display the output of the URL using// the Web browser, as an ordinary page:getAppletContext（）.showDocument（u）;} catch（Exception e） {l.setText（e.toString（））;} }else return super.action（evt, arg）;return true;}} ///:~
URL类的最大的特点就是有效地保护了我们的安全。可以同一个Web服务器建立连接，毋需知道幕后的任何东西。
易网时代-编程资源站