下一页 上一页 目录

5. 使用 Java CGI 类。

目前支持三个主要的类 -- CGIEmailHTML。我正在考虑添加类来处理 MIME 格式的输入和输出 -- 分别是 MIMEin 和 MIMEout。

还有一些支持和测试类。CGI_TestEmail_TestHTML_Test 旨在用于测试您的安装。它们也可以用作您自己的 Java 程序的起点,这些程序使用此类库。Text 类是 EmailHTML 类的超类。

5.1 CGI

类语法

public class CGI

类描述

CGI 类保存“CGI 信息”——Web 服务器设置的环境变量以及当选择其提交操作时从表单发送的名称/值。所有信息都存储在 Properties 类对象中。

此类在“Orbits.net”包中。

成员摘要


        CGI()         //  Constructor.
        getNames()    //  Get the list of names.
        getValue()    //  Get form value by specifying name.

参见

CGI_Test.

CGI()

目的

构造一个包含可用 CGI 数据的对象。

语法

public CGI()

描述

当构造 CGI 对象时,所有可用的 CGI 信息都会被吸收到新对象的本地存储中。

getNames()

目的

列出已定义具有对应值的名称。

语法

public Enumeration getKeys ()

描述

提供已定义对应值的完整名称列表。

返回值

所有已定义名称的 Enumeration

getValue()

目的

检索与指定的名称关联的

语法

public String getValue ( String name )

描述

此方法提供从 HTML 表单发送的 namesvalues 之间的对应关系。

参数

name

用于选择值的键。

返回值

一个 String,包含该值。

5.2 CGI_Test

此类既提供了如何使用 CGI 类的示例,又提供了一个测试程序,可用于确认 Java CGI 包是否正常运行。

成员摘要


        main()      //  Program main().

参见

CGI.

main()

目的

提供 main() 方法。

语法

public static void main( String argv[] )

描述

这是一个 CGI 程序的入口点,该程序除了返回可用名称/值对及其当前值的列表外,什么也不做。

参数

argv[]

java.cgi 脚本传递给程序的参数。目前未使用。

5.3 Email

类语法

public class Email extends Text

类描述

消息使用 Text 类的 add*() 方法和此类添加的特定于电子邮件的方法构建。完成后,消息将发送到其目的地。

此类在“Orbits.net”包中。

成员摘要


        Email()      //  Constructor.
        send()       //  Send the e-mail message.
        sendTo()     //  Add a destination for message.
        subject()    //  Set the Subject: for message.

参见

Email_Test, Text.

Email()

目的

构造一个将包含电子邮件消息的对象。

语法

public Email()

描述

设置一个空消息,以便由 Email 方法完成。

参见

Text.

send()

目的

发送电子邮件消息。

语法

public void send ()

描述

这将格式化并发送消息。如果未设置目标地址,则不执行任何操作。

sendTo()

目的

为此消息添加目标地址。

语法

public String sendTo ( String address )

描述

address 添加到此方法的目的地列表。电子邮件消息可以拥有的目的地数量没有设定限制。我确信,如果您构建的列表足够大,您可以超出 邮件传输代理 可以接受的参数列表的大小,或者耗尽您的内存。

参数/

address

要将此消息发送到的目的地。

subject()

目的

为此消息设置主题。

语法

public void subject ( String subject )

描述

此方法设置电子邮件“主题:”行的文本。如果多次调用,则使用最后设置的主题。

参数

subject

此消息的“主题:”行的文本。

5.4 Email_Test

此类既提供了如何使用 Email 类的示例,又提供了一个测试程序,可用于确认 Java CGI 包是否正常运行。

成员摘要


        main()      //  Program main().

参见

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()                  //  Constructor.
        author()                //  Set the name of the document author.
        definitionList()        //  Start a definition list.
        definitionListTerm()    //  Add a term to a definition list.
        endList()               //  End a list.
        listItem()              //  Add an entry to a list.
        send()                  //  Send the HTML message.
        title()                 //  Set the text for the document 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().

参见

HTML.

main()

目的

提供 main() 方法。

语法

public static void main( String argv[] )

描述

这是一个 CGI 程序的入口点,该程序返回 HTML 文档中可用名称/值对的列表,每个名称/值对都显示在定义列表元素中。

参数

argv[]

java.cgi 脚本传递给程序的参数。目前未使用。

5.7 Text

类语法

public abstract class Text

类描述

此类是 EmailHTML 类的超类。消息使用此类中的方法构建,并使用子类中的方法完成和格式化。

此类在“Orbits.text”包中。

成员摘要


        Text()            //  Constructor.
        add()             //  Add text to this object.
        addLineBreak()    //  Add a line break.
        addParagraph()    //  Add a paragraph break.

参见

EmailHTML

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()


下一页 上一页 目录