java-cgi-howto.txt

linux-bible.rar linux-bible.rar

   [22]Email.
   
  main()
  
   目的
          提供 main() 方法．
          
   语法
          public static void main( String argv[] )
          
   描述
          这是 CGI 程式的入口，返回可用的名称/数值对与其现值的列表． 它也
          将列表送到由 Email 变数所指定的位址．
          
   参数 
          
        argv[]
                由 java.cgi 指令稿传入的参数．目前未使用．
                
5.5 HTML

  类别语法
  
   public class HTML extends Text
   
  类别描述
  
   讯息由 Text 类别的 add*() 方法所建立，并加入 HTML 专用的方法． 完成後，
   讯息被送到它的目的地．
   
   目前，还没有错误检查机制以确保列表建立的方法被以正确的顺序使用． 因此程
   式设计者必须自行确定没有违反 HTML 的语法．
   
   这个类别位於 ``Orbits.net'' 包装中．
   
  成员摘要
     _________________________________________________________________
   
        HTML()                  //  建构子
        author()                //  设定文件作者的名字
        definitionList()        //  起始一定义列表
        definitionListTerm()    //  在定义列表中增加一项目
        endList()               //  结束列表
        listItem()              //  在列表中增加一项目
        send()                  //  送出此 HTML 讯息
        title()                 //  设定文件标题的文字
     _________________________________________________________________
   
  请参阅
  
   HTML_Test, Text.
   
  HTML()
  
   目的
          建立一包含 HTML 讯息的物件．
          
   语法
          public HTML()
          
   描述
          建立一空的讯息以利由 HTML 方法加以完成．
          
   请参阅
          Text.
          
  author()
  
   目的
          设定文件作者的名字．
          
   语法
          public void author ( String author )
          
   描述
          将文件的作者名字设定为 author．
          
   参数
          
        author
                用来作为此讯息作者的文字．
                
   请参阅
          title().
          
  definitionList()
  
   目的
          起始一定义列表．
          
   语法
          public void definitionList ()
          
   描述
          起始一定义列表． 一个定义列表是一种特别的列表，列表中的每一项是
          由 项目 其後跟著定义的 文字 所形成的． 一定义列表的起始应跟著(至
          少)一项目/文字配对以及一个 endList() 方法的呼叫． 请注意，目前列
          表不能是巢状的．
          
   请参阅
          definitionListTerm(), endList(), listItem().
          
  definitionListTerm()
  
   目的
          在定义列表中增加一项目．
          
   语法
          public void definitionListTerm ()
          
   描述
          在定义列表中增加一项目． 目前列表的项目部份的文字应该在此方法被
          呼叫後并且在对应的 listItem 方法被呼叫前加入．
          
   请参阅
          definitionList(), listItem().
          
  endList()
  
   目的
          结束一列表．
          
   语法
          public void endList ()
          
   描述
          本方法结束一列表．注意，目前列表不能是巢状的．
          
   请参阅
          definitionList().
          
  listItem()
  
   目的
          在列表中增加一项目．
          
   语法
          public void listItem ()
          
   public void listItem ( String item )
          
   public boolean listItem ( String term, String item )
          
   描述
          在列表中增加一项目． 如果使用第一种形式，目前列表项目的文字应在
          此方法被叫後并在任何其它列表方法被呼叫前加入． 在第二及第三种形
          式中，item 文字被指定为方法的参数而不是在其後被加入． 第三种形式
          是定义列表专用并且同时指定列表的项目与定义文字部份．
          
   参数
          
        item
                此列表项目的文字．
                
        term
                此定义列表的项目部份的文字．
                
   请参阅
          definitionList(), definitionListTerm(), endList().
          
  send()
  
   目的
          送出此 HTML 讯息．
          
   语法
          public void send ()
          
   描述
          送出此 HTML 讯息．
          
  title()
  
   目的
          设定文件标题的文字．
          
   语法
          public void title ( String title )
          
   描述
          设定此文件的标题文字．
          
   参数
          
        title
                此文件标题的文字．
                
   请参阅
          author().
          
5.6 HTML_Test

   这个类别提供一个如何使用 HTML 类别的例子以及一个用来确定 Java CGI 套件
   运作正常的测试程式．
   
  成员摘要
     _________________________________________________________________
   
        main()      //  Program main().
     _________________________________________________________________
   
  请参阅
  
   [23]HTML.
   
  main()
  
   目的
          提供 main() 方法．
          
   语法
          public static void main( String argv[] )
          
   描述
          这是 CGI 程式的入口，返回在一 HTML 文件中可用的名称/数值配对与其
          现值的列表，并将每一名称/数值配对显示在一定义列表的元素里．
          
   参数 
          
        argv[]
                由 java.cgi 指令稿传入的参数．目前未使用．
                
5.7 Text

  类别语法
  
   public abstract class Text
   
  类别描述
  
   本类别为 [24]Email 与 [25]HTML 的基础类别． 讯息以此类别的方法建立，并
   以衍生类别的方法完成并编排．
   
   这个类别位於 ``Orbits.net'' 包装中．
   
  成员摘要
     _________________________________________________________________
   
        Text()            //  建构子
        add()             //  加入文字到此物件
        addLineBreak()    //  加入分行符号
        addParagraph()    //  加入分段符号
     _________________________________________________________________
   
  请参阅
  
   [26]Email, [27]HTML.
   
  add()
  
   目的
          在此项目中加入文字．
          
   语法
          public void add ( char addition )
          
   public void add ( String addition )
          
   public void add ( StringBuffer addition )
          
   描述
          在这个文字项目的内容中加入 addition．
          
   参数
          
        addition
                加入此文字项目的文字．
                
   请参阅
          addLineBreak(), addParagraph().
          
  addLineBreak()
  
   目的
          强迫在目前文字位置分行．
          
   语法
          public void addLineBreak ()
          
   描述
          在目前位置加入一分行符号．
          
   请参阅
          add(), addParagraph().
          
  addParagraph()
  
   目的
          起始一新的段落．
          
   语法
          public void add ()
          
   描述
          在目前的文字位置起始一新的段落．
          
   请参阅
          add(), addLineBreak().
          
6. 未来的计画

     * Email 类别的扩充:
       
        Email( int capacity )
                用来当我们知道需多少空间来储存讯息时．
                
        sendTo( String [] address )
                增加原始电子邮件目的地的列表．
                
        sendCc( String address )
                增加一个复制电子邮件目的地．
                
        sendCc( String [] address )
                增加复制电子邮件目的地的列表．
                
        sendBcc( String address )
                增加一个 Blind Carbon-Copy 的电子邮件目的地．
                
        sendBcc( String [] address )
                增加 Blind Carbon-Copy 的电子邮件目的地列表
                
     * HTML 类别的扩充:
       
        HTML( int capacity )
                用来当我们知道需多少空间来储存讯息时．
                
        public void unorderedList()
                起始一无序列表．
                
        public void orderedList()
                起始一有序列表．
                
        public void directoryList()
                起始一目录列表．
                
        public void menuList()
                起始一选单列表．
                
        void anchor( String anchorName )
                指定一锚(anchor)．
                
        void link( String url, String text )
                指定一连结．
                
        void applet( String url, String altText )
                指定一 applet 连结．
                
     * 允许巢状的 HTML 列表．
     * 增加错误检查码以强迫修正 HTML 列表格式码的顺序．
     * 环境变数资料的档案位置应能由 Makefile 设定．
     * 除去在处理 GET 方法的资料传送时出现之假的空名称/数值对．
     * 考虑让 CGI 实作 java.util.Enumeration 界面以依序地提供变数名称．
     * 加入一 Test 类别，使用本套件中的每个方法．
     * 说明 CGI_Test, Email_Test 与 HTML_Test 如何相互建立以提供侦错目的用
       的渐进测试．
     * 说明如何测试使用本套件的每一个特徵．
       
7. 版本修改记录

7.1 由 0.4 到 0.5 的修改

     * 更新文件与注解以反应新释出的版本。
       
7.2 由 0.3 到 0.4 的修改

     * 增添 HTML 类别提供的基本功能．
     * 增加 HTML_Test 类别与 javahtmltest.html-dist．
     * 增加 HTML 方法来处理定义列表．
       
7.3 由 0.2 到 0.3 的修改

     * 加入 Text 与 Email 类别． HTML 也被加入，但此时只是一小部份而已．
     * 将不同的类别放入包装中． 主要的类别在 Orbits.net.*，支援用的类别
       Text 放在 Orbits.text.Text．
     * 将 CGItest 改为 CGI_Test．
     * 增加 Email_Test 类别．
       
7.4 由 0.1 到 0.2 的修改

     * 环境变数被放入一暂存档中而不是勉强挤入 Java 解译器的命令列里． CGI
       类别与 java.cgi 已被修改．
     * 将 javacgitest.html 文件加入成为套件的一部份．
     * 安装时由 make 所修改的档案全都以结尾 -dist 来命名．

References

   1. mailto:[e-mail]
   2. http://www.phys.ntu.edu.tw/~cwhuang/pub/
   3. mailto:[e-mail]
   4. http://www.orbits.com/software/Java_CGI.html
   5. ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz
   6. http://www.orbits.com/software/Java_CGI.html
   7. mailto:[e-mail]
   8. mailto:[e-mail]
   9. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#install-short
  10. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#mailing-list
  11. ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz
  12. ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz
  13. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#make-programs
  14. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#cgi-class
  15. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-class
  16. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#html-class
  17. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#cgi-test-class
  18. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-test-class
  19. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-test-class
  20. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#text-class
  21. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#cgi-class
  22. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-class
  23. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#html-class
  24. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-class
  25. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#html-class
  26. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#email-class
  27. file://localhost/tmp/bg5sgmltools.29662/Java-CGI-HOWTO.txt.html#html-class