������� Java CGI HOWTO
 David H. Silber [email protected]
 v0.5, 1 ��������� 1998

 ��� �� ������ HOWTO ������ �� �� �������� �� ���������� ��� ����
 �� ��������� ����������� CGI �������� �� Java ��� �� ��
 ��������������� �� Java ��� �� ������ ����������� CGI.  �� ��� ���
 �� HOWTO ������ ������ �� ����� �� �� ��������� ������ Linux,
 �� �� ����������� ��� ����� ��������� �� �� ����������� ������
 �� Unix �� ��������������.
 ______________________________________________________________________

 Table of Contents





















































 1. �������

    1.1 ������������ ����
    1.2 ��� �� ������
    1.3 �� ������
    1.4 � ����� ���������

 2. ���������� �� ���������� ��� �� ����� ����������� Java CGI (�� �����������)

    2.1 ���������� ���������
    2.2 ���������� �������� Java CGI
    2.3 �������������� ��� ������ �����
    2.4 ��������� ��� ��� ��������� ������ �������� ���
    2.5 ��������� ��� ����������� ���

 3. ���������� ��� ���������� ��� �� ����� ����������� Java CGI (� ������� �����)

 4. ��������� ��� �������� Java CGI

    4.1 ������ ��� ������� ����������� Java ��� �� �� ������� CGI
       4.1.1 ��� �������� �� ������� ����������� Java ��� �� �������� ����������.
       4.1.2 � Java ��� ��� ������ ������� ��� ����������.
    4.2 ���������� ���������� ��� ������� ����������� Java CGI
       4.2.1 �� java.cgi script
       4.2.2 ������� �� java.cgi �� ��� ����� HTML

 5. �������������� ��� Java CGI �������

    5.1 CGI
       5.1.1 ������ ������
       5.1.2 �������� ������
       5.1.3 ������� ����
       5.1.4 ����� ������
       5.1.5 CGI()
       5.1.6 getNames()
       5.1.7 getValue()
    5.2 CGI[lowbar]Test
       5.2.1 ������� ����
       5.2.2 ����� ������
       5.2.3 main()
    5.3 Email
       5.3.1 ������ ������
       5.3.2 �������� ������
       5.3.3 ������� ����
       5.3.4 ����� ������
       5.3.5 Email()
       5.3.6 send()
       5.3.7 sendTo()
       5.3.8 subject()
    5.4 Email[lowbar]Test
       5.4.1 ������� ����
       5.4.2 ����� ������
       5.4.3 main()
    5.5 HTML
       5.5.1 ������ ������
       5.5.2 �������� ������
       5.5.3 ������� ����
       5.5.4 ����� ������
       5.5.5 HTML()
       5.5.6 author()
       5.5.7 definitionList()
       5.5.8 definitionListTerm()
       5.5.9 endList()
       5.5.10 listItem()
       5.5.11 send()
       5.5.12 title()
    5.6 HTML[lowbar]Test
       5.6.1 ������� ����
       5.6.2 ����� ������
       5.6.3 main()
    5.7 Text
       5.7.1 ������ ������
       5.7.2 �������� ������
       5.7.3 ������� ����
       5.7.4 ����� ������
       5.7.5 add()
       5.7.6 addLineBreak()
       5.7.7 addParagraph()

 6. ���������� �����

 7. �������

    7.1 ������� �� ��� 0.4 ���� 0.5
    7.2 ������� �� ��� 0.3 ���� 0.4
    7.3 ������� �� ��� 0.2 ���� 0.3
    7.4 ������� �� ��� 0.1 ���� 0.2


 ______________________________________________________________________

 1.  �������

 �������� �� ���� �� � Java ����� ����������, � ���������������
 ��� ��� ����� ������� ���� ���������� ������������� �� ���������.
 �������� �� ���� �� ����� ��������� �� Java Development Kit
 (JDK), ����� �������� �� �������������� �������� ������ ��� ��
 ������� ��� ��������, �� ����� ��� ������� ��� ��� ���� �� ���
 ���� ���� ��������� �� ������/CGI ��� HTML.  ������ �����
 ������������ ��� �� ����������, ��� �� ������� ���� ��
 ����.  �������� �������� ��� ������������.

 �� ��� �� ����� ��� ���������� �������� �� 1996, ��� �����
 ������ ������� ���� ��������� Java.  ����� ������ �� ��� �������
 ��� ��� �� ������ Java ����������� ���� �����-��-����������, �����
 ��� ��������� -- ��� �� ������ �� ������ ��� ����� ��� servlets.


 1.1.  ������������ ����

 ������ ��� ���� ��� ������ ���� ��� HTML ��� �� ������ CGI ���
 ��������� ��� ������� ���� �� ���������� HTTP ���.  �� ������
 ������ �� �������� �� �� ��������������� �� Java, ����� ����� ��
 ��� �� �� ������ ����.



 1.2.  ��� �� ������

 � �������� ������ ��� �� ������ ������ �� ��������� ����
 http://www.orbits.com/software/Java_CGI.html.



 1.3.  �� ������

 � �������� ������ �� ������ �� ����������� �� ������ ��
 ������������ ��� ����� FTP ���
 ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz.  � ������� ��
 ������ ������� ������ ����� SGML ��� �� �� ������.


 �� ������ ���������� ��� �� ��� ���� ��� GNU ����������� �������
 ������ �� ����� (Library General Public License). ��� �� ������
 ������ �� ���������� ��� �� ��� ���� ��� �������� ���������
 ��������� �� Linux HOWTOs.

 �� �������������� �� �� ��������, ������� ����� ������ ������
 ���� http://www.orbits.com/software/Java_CGI.html, ���� ���� ��� �����
 �� ������ �� ������� ��� ������� Java CGI.

 ��� �� ���� ���� ��� �� ����� ��� �� ��������� �� �� ������,
 ���� ��� ������ �� ����� � �������� �� ��������.  �� ������
 ���� �� ����� ������ ��������� �� �� �� �������� ���� �� �����
 �� �������� �� �������� ��, ������� ������������ ���� �� ����
 [email protected].



 1.4.  � ����� ���������

 ��� ����������� ��� ����� majordomo ���� �� ������� ������� ��
 ������ � ���� ��� �����, �� ���� �������� �� ���������� ���
 ������������ ��� �������������� �� �� ��������.  ������� ���
 ����� ���� [email protected], ��������������� �� ����
 subscribe.



 2.  ���������� �� ���������� ��� �� ����� ����������� Java CGI (��
 �����������)

 ��� �� ����� �� ��� ����������� ���� ��� ����������� �� ������ ��
 Java CGI �� ������ ����������� ���� ���� �� �������� ���� �� �����
 �� ������������ �� �������� ���.  �� ���� ������ �� �������������
 �� ����������� ��� ��� ����������� ����� ��� �� ����� ��� ���
 ����� ����, ��������� ���� ``���������� ��� ���������� ��� ��
 ����� ����������� Java CGI (� ������� �����)''.



 2.1.  ���������� ���������

 ��� �� �������� �� ������ �� ������ �� ���� unix-like ����������
 ���� �� ��� ������������� �� Java Development Kit.  �� ��
 ���������� �� ��� ������ Debian Linux �� ����� ��� apache ���
 ������� HTTP.  �� ����������� ��� ��� ����� ���� ��� ���
 ����������, ������� ������������ �� �� ����� ���������.  ����� ��
 ``The Mailing List'' ��� ������������.

 ����, � Java run-time ����������� �������� �� ����� ���� ���
 �������� ������ -- ��� �� ������ �� ������ ���� ����������
 megabytes �� RAM ���� ���������� ��� �� �� �������������� ���
 ����������� Java CGI.



 2.2.  ���������� �������� Java CGI

 �� �������� �� ����� ��� �� �������� �� �� ������� Java CGI.
 �������� �� �� ������ �� ��
 ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz.  (� ������
 ������� ������ �� ��� �������).





 2.3.  �������������� ��� ������ �����

 ������ ���� �������� �� ��� ������ ���� ����� �� ������������ ��
 �� ������.  (�� ��� ���� ���� ��� ������ ��� �� �����������
 ������, ������� �� ��������������� ��� /usr/local/src.)  ������������
 �� ������� �� ��� ��� ������:

 gzip -dc java_cgi-0.5.tgz | tar -xvf -


 ���� �� ����������� ���� �������� �� ����� java_cgi-0.5.  ���� ����
 �� ������ �� ����� �� ���������� ��� ������� ��� �� ������.
 (�� � ������ ������� ��� �������, �������������� ��� ������� ��
 ���������� ��� ������� �� ����������).



 2.4.  ��������� ��� ��� ��������� ������ �������� ���

 ������ �� ���������� �� ������ �� ��� �� Java CGI ����������� ���.
 ������, �� ������ �� �� ������������ �� ���� �������� ��������� �� ���
 cgi-bin ������� ���.  � ���� �� ����������� apache ���� ����������
 �� �������������� ��� /var/www/cgi-bin ��� ��� cgi-bin ��������, ����
 ���������� ��� /var/www/javacgi ��� ��� �������� �� ������� ���� ��
 Java CGI �����������.  ������ �� �� ������ �� ������������ �� Java
 CGI ����������� ��� ���� �� ���� �� ��� ��������� ��������
 CLASSPATH.  �������������� �� Makefile ���� �� ����������������� �
 ������ �� �������� ���.  ����������� ��� ���� ������� ��
 ������� root ��� ������ ��� ������ make install.  ���� ��
 ������������ �� Java �����������, �� ������������ �� java.cgi �������
 ��� �� ��������� �� �� ������ ��� ��� �� ������������ �� �����������
 ��� ���������� ����.  �� ������ ��� HTML ������ ���� ��� ����������
 ��� ��� HTML test ������ ��������, ������ ��� ������ make all ����
 ����.



 2.5.  ��������� ��� ����������� ���

 ������������� �� �� ������� ����� HTML ������ �� �����������
 javacgitest.html, javaemailtest.html ��� javahtmltest.html.  ��� ��
 ������������� ��� - all ��� ���������� �����, �� ����� ���� ��������
 �� ���������� ��� WEBDIR ��� Makefile.  �� ��� �� ������, �������� ��
 ������� ��� ������ make test ��� �� �� ������� �� ��
 javacgitest.html-dist, javaemailtest.html-dist ��� javahtmltest.html-
 dist.

 ���� ����� ������� �� � ����������� ��� ������ ����, ��� ��
 ��������� �� ��������� �� CGI_Test.class, Email_Test.class ���
 HTML_Test.class �� ��� JAVACGI ������� ��� ��� �� javacgitest.html,
 javaemailtest.html ��� javahtmltest.html �� ��� WEBDIR ������� ���
 �� ������ ��� ������ ���������� �� ����� �������� ���
 ���������� ���� ����������.




 3.  ���������� ��� ���������� ��� �� ����� ����������� Java CGI (�
 ������� �����)


 �  ����� �� ������ Java CGI �� ��
    ftp://ftp.orbits.com/pub/software/java_cgi-0.5.tgz.  (� ������
    ������� ������ �� ��� �������).


 �  ������������ �� ������� �� ��� ��� ������:

    gzip -dc java_cgi-0.5.tgz | tar -xvf -


 (�� � ������ ������� ��� �������, �������������� ��� ������� ����
 �� ������ �� ������� �� �� �� ������ ��� ������).

 �  �������������� �� Makefile �� �� ������ ��� ���� ������������
    �������� java_cgi-0.5 ���� �� ����� ��������� ��� �� ������ ���.

 �  ��� root, ������ ��� ������ make install.  ���� �� ������������ ��
    Java �����������, �� ������� ��� ������������ ���������� ���
    ������ ��� ��� �� ������������ �� ������ �����.  �� ������ ���
    HTML ������ ���� ��� ���������� ��� ��� HTML test ������, ������
    ��� ������ make all ���� ����.

 �  �� ������ �� ����� ������� �� ����������.




 4.  ��������� ��� �������� Java CGI




 4.1.  ������ ��� ������� ����������� Java ��� �� �� ������� CGI

 ������ �� ���� ���������� ��� ������� ��� ������������ Java ��
 ���� ���������� ����:



 4.1.1.  ��� �������� �� ������� ����������� Java ��� �� ��������
 ����������.

 ���������� �� ������� ��� ��������� Java run-time  ��� �� ������� ���
 ����� ����� (�������� ��� �� �������) ��� ������ ������.  �� ���
 ����� HTML, ��� ������ ����� �������� ��� �� �������� ��� ������
 ������ ���� ���������� ����.



 4.1.2.  � Java ��� ��� ������ ������� ��� ����������.

 ���� ��������� ������������� �� �� ��������� �� �� �������� Java
 ������ �� �������� �� �������.  ��� ������ ����� ������� ������� ��
 �� ��������� ��� C, getenv() .



 4.2.  ���������� ���������� ��� ������� ����������� Java CGI

 ��� �� ������������� ��� �� ������, ����� ��� CGI ��������
 ����� �� ������ ��� ���������� �� ����������� �� ��� Java
 ���������.



 4.2.1.  �� java.cgi script

 ��� �� ������� ����� ������������ ��� ������������� ����� ��
 HTTP ������� ��� �� ������������ Java CGI �� ��������� ��
 ���������������.  ������ �� ����� �� ������������ �� ������ ��
 ������� �� �� �������� �� ��������� �� �� ����������.  �������
 ��� �� �������� ������������� �� ��� ������� �����.  ������, �����
 ��� Java run-time ��������� �� �� ����� �� ����� �� ���
 ���������� ������������� ��� �� ����� �� ������������ �� ����������
 ��� ������-������.

 �� java.cgi script ���������� ��� ������������� ��� ``��������� ���
 ��� ��������� ������ �������� ���''.




 4.2.2.  ������� �� java.cgi �� ��� ����� HTML

 �� ������ �� �� ������������ ����������� Java CGI ��������� ���
 �������� ������ ��� �������:

 <form action="/cgi-bin/java.cgi/CGI_Test" method="POST">


 ��� /cgi-bin/ ����� � ������ ��� CGI binary ���������, java.cgi
 ����� �� Java front-end �� ��� ��������� �� ������ ����������� Java
 ���� ��� ��� �� CGI_Test ����� ��� ���������� ������� ������������
 Java ��� �� �������.



 5.  �������������� ��� Java CGI �������

 ������ ���� �� ���� ����� ����� ������� �� �������������� --
 ``CGI'', ``Email'' ��� ``HTML''.  �������� �� ������� ������� ��� ��
 ���������� �� MIME-���������� ��������� (input) ��� ��������
 (output) -- MIMEin & MIMEout, ���������.

 ������ ������ ������� support ��� test �������.  ``CGI_Test'',
 ``Email_Test'' ��� ``HTML_Test'' ������� �� �������������� ��� ��
 ������� ��� ����������� ���.  ������ ������ �� �������������� ���
 ��� ������-��������� ��� �� ���� ��� ����������� Java ��
 ������������ ��� �� ���������� ������.  � ``Text'' ����� ����� �
 ��������� ��� ��� ��� �� �������, ��� Email ��� ��� HTML.



 5.1.  CGI




 5.1.1.  ������ ������

 public class CGI



 5.1.2.  �������� ������

 � CGI ����� ������� ��� ``CGI ����������'' -- ����������
 ������������� �� ��� ���������� ���� ��� �� �����/���� ��
 ���������� �� ��� ����� ���� � submit �������� ����� ����������.
 ���� �� ���������� ������������ �� ��� Properties �����������
 ������.

 ���� � ����� ����� ��� ������ ``Orbits.net''.




 5.1.3.  ������� ����

 CGI()         //  ������������.

 getNames()    //  ������� �� ����� �������.

 getValue()    //  ������� ��� ���� ������ ���� �������������� �����.



 5.1.4.  ����� ������

 CGI_Test.




 5.1.5.  CGI()


    Purpose
       ����������� ��� ����������� �� ������� �� ��������� CGI
       ��������.

    Syntax
       public CGI()

    Description
       ���� ������������� ��� ����������� CGI, ���� �� ���������� CGI
       ���������� ����������� �� ������� ������ ��� ��� �����������.




 5.1.6.  getNames()


    Purpose
       ����� ����� �� ������� �� ����� ��������� ��� �� ���
       ���������� �����.

    Syntax
       public Enumeration getKeys ()

    Description
       ������ ��� ����� ����� �� ������� ��� �� ����� ����������
       ����� ����� ���������.

    Returns
       ��� Enumeration ��� �� �������� �������.



 5.1.7.  getValue()


    Purpose
       �������� ��� value ���������� �� �� name �� ��� �������.

    Syntax
       public String getValue ( String name )

    Description
       ���� � ������� ������ �� ���������� ����� �� names ���
       values �� ���������� �� ��� HTML �����.

    ����������

       name
          �� ������ ���� �� ����� �� ����� �����������.

    Returns
       ��� String �� ������������ ��� ����.



 5.2.  CGI_Test

 ���� � ����� ������ ��� ���������� �� �� �� �������������� ���
 ����� CGI ��� ��� �������� ����� �� ������ �� �������������� ���
 �� ����������� ��� �� ������ Java CGI ��������� ����.



 5.2.1.  ������� ����

 main()      //  �������� main().




 5.2.2.  ����� ������

 CGI.




 5.2.3.  main()


    Purpose
       ������ ��� main() ������.

    Syntax
       public static void main( String argv[] )

    Description
       ��� ����� �� ������ ��������� ��� ��� �������� CGI �� ���
       ����� ������ ���� �� �� �� ������� ��� ����� �� ��� ��
       ��������� �����/���� ������� ��� ��� ������� ����� ���.

    ����������

       argv[]
          ����������� ��������� ��� �������� �� �� java.cgi script.
          ���� �� ���� �������������.



 5.3.  Email




 5.3.1.  ������ ������

 public class Email extends Text




 5.3.2.  �������� ������

 ������� ������������ �� ��� Text ����� add*() ������ ��� ��� e-
 mail-������������ ������ �� ������������ �� ���� ��� �����.
 ���� ����������, �� ����� ��������� ���� �������� ��.

 ���� � ����� ����� ��� ������ ``Orbits.net''.




 5.3.3.  ������� ����


 Email()      //  ������������.

 send()       //  ������� �� e-mail �����.

 sendTo()     //  ��������� ���� �������� ��� �� �����.

 subject()    //  ������� �� ����: ��� �� �����.




 5.3.4.  ����� ������

 Email_Test, Text.




 5.3.5.  Email()


    Purpose
       ����������� ��� ����������� �� ����� �� ������� ��� email
       �����.

    Syntax
       public Email()

    Description
       ������� ��� ��� ����� ��� �� ���������� �� ��� Email
       ������.

    See Also
       Text.




 5.3.6.  send()


    Purpose
       ������� �� e-mail �����.

    Syntax
       public void send ()

    Description
       ���� ��������� ��� ������� �� �����.  �� ����� �������
       ��������� ��� ��� ��������, �� ���������� ����� ��������.


 5.3.7.  sendTo()


    Purpose
       ��������� ���� �������� ��� �� �� �����.

    Syntax
       public String sendTo ( String address )

    Description
       ��������� ��� address ��� ����� ��������� ���

       ���� ��� ������.  ��� ������ ������ ���� ������� ���� �����
       ��������� �� ��� e-mail ����� ������ �� ���.  ����� �������
       �� �� ���������� �� ����� ������ ������, �������� �� �������
       �� �� ������� ��� ������ ��������� �� � Mail Transport Agent
       ������ �� �������� � �� ����������� �� ����� ���.

    Parameter/

       address
          ���� ��������� ��� �� �������� �� �� �����.




 5.3.8.  subject()


    Purpose
       ������� �� ���� ��� �� �� �����.

    Syntax
       public void subject ( String subject )

    Description
       ���� � ������� ������� �� ������� ��� ��� ������ Subject: ��
       e-mail.  �� ������ ����������� �� ��� �����, �� ��������
       ��������� ���� ����� �� �� ���������������.

    Parameter

       subject
          �� ������� ��� Subject: ������� ��� �� ��������.




 5.4.  Email_Test

 ���� � ����� ������ ��� ���������� �� �� �� �������������� ���
 Email ����� ��� ��� test �������� �� ������ �� �������������� ��� ��
 ����������� ��� �� Java CGI ������ ��������� ����.




 5.4.1.  ������� ����

 main()      //  �������� main().






 5.4.2.  ����� ������

 Email.



 5.4.3.  main()


    Purpose
       ������ ��� main() ������.

    Syntax
       public static void main( String argv[] )

    Description
       ��� ����� �� ������ ��������� ��� ��� �������� CGI ��
       ������� ��� ����� �� ��� �� ��������� �����/���� ������� ���
       ��� ������� ����� ���.  ������, �� ������� ��� �� ����� ����
       ����������� ������� ���� Email ���������.

    ����������

       argv[]
          ����������� ���������� ��� �������� �� �� java.cgi
          �������.  ���� �� ���� �������������.




 5.5.  HTML




 5.5.1.  ������ ������

 public class HTML extends Text



 5.5.2.  �������� ������

 ������� ������������ �� ��� Text ����� add*() ������ ��� ���
 HTML-������������ ������ �� ������������ �� ���� ��� �����.
 ���� ����������, �� ����� ��������� ���� �������� ��.

 ���� �� ����, ��� ������ ������ ������� ��� �� ����������� ���
 �� ������� ����������-������ ��������������� �� ��� ���� �����,
 ���� � ��������������� ������ �� ������� ����� ��� �� ��� ����������
 ��� HTML ������.

 ���� � ����� ����� ��� ������ ``Orbits.net''.



 5.5.3.  ������� ����


 HTML()                  //  ������������.

 author()                //  ������� �� ����� �� ������� ��
 ������.

 definitionList()        //  ������ ��� ����� ������.

 definitionListTerm()    //  ��������� ���� ��� ��� ����� ������.

 endList()               //  �������� ��� �����.

 listItem()              //  ��������� ��� �������� �� ��� �����.

 send()                  //  ������� �� HTML �����.

 title()                 //  ������� �� ������� ��� ��� ����� ��
 ������.



 5.5.4.  ����� ������

 HTML_Test, Text.



 5.5.5.  HTML()


    Purpose
       ��������� ��� ����������� �� �� ������� ��� HTML �����.

    Syntax
       public HTML()

    Description
       ������� ��� ��� ����� �� ��������� �� ��� HTML ������.

    See Also
       Text.



 5.5.6.  author()


    Purpose
       ������� �� ����� �� ������� �� ������.

    Syntax
       public void author ( String author )

    Description
       ������� �� ����� �� ������� �� ������ �� author.

    Parameter/

       author
          �� ������� �� ������ �� �������������� ��� � ��������
          ��� �� ��������.

    See Also
       title().




 5.5.7.  definitionList()


    Purpose
       ������ ��� ����� ������.

    Syntax
       public void definitionList ()

    Description
       ������ ��� ����� ������.  � definition list ����� ��� �����
       ���������� ���� ���� ���� �������� ��� ����� ����� ���� term
       ������������ �� �� text ������ ��� ��� ��� ���.  � ���
       ���� ������ ������ �� ������ �� ����������� �� ���������)
       ��� ����/������� ������ ��� ��� ����� ���� endList() ������.
       �������� ��, ���� �� ����, �� ������ ��� ������ �� �����
       ����������� (nested) � ��� ���� ���� ����.

    See Also
       definitionListTerm(), endList(), listItem().




 5.5.8.  definitionListTerm()


    Purpose
       ��������� ���� ��� ��� ����� ������.

    Syntax
       public void definitionListTerm ()

    Description
       ��������� ���� ��� ��� ����� ������.  �� ������� ��� �� �������
       �� ��� ��� ������� ��������� ������ �� ������ ��
       ������������ ��� ����� �� � ������� ��� �������� ��� ����
       ��� ��������� listItem ������� ��������.

    See Also
       definitionList(), listItem().



 5.5.9.  endList()


    Purpose
       �������� ��� �����.

    Syntax
       public void endList ()

    Description
       �������� ��� �����.

       ���� � ������� ������� ��� �����.  �������� ���, ���� �� ����,
       �� ������ ��� ������ �� ����� ����������� (nested), � ��� ����
       ���� ����.

    See Also
       definitionList().




 5.5.10.  listItem()


    Purpose
       ��������� ��� �������� �� ��� �����.

    Syntax
       public void listItem ()

       public void listItem ( String item )

       public boolean listItem ( String term, String item )

    Description
       ��������� ��� �������� �� ��� �����.

       �� � ���� ����� ���������������, �� ������� ��� ��� �����
       ����������� ������ �� ������ �� ������������ ��� ����� �� �
       ������� ��� �������� ��� ���� ����� ������� ������ ��������.
       ���� ������ ��� ����� �����, �� item ������� �������������� ���
       ��� ���������� ��� ������ ���� �� (� ����������� ��� ��)
       ������������ ��� �����.  � ����� ����� ����� ������ ����
       ������ ������ ��� ������ ��� ��� ��� ��� �� ����� ���
       ��������� ������.

    Parameters

       item
          �� ������� ���� ��� ��������� ������.

       term
          �� ������� ���� ��� ������ ������ �� �������� �� ���
          ���������.

    See Also
       definitionList(), definitionListTerm(), endList().




 5.5.11.  send()


    Purpose
       ������� �� HTML �����.

    Syntax
       public void send ()

    Description
       ������� �� HTML �����.




 5.5.12.  title()


    Purpose
       ������� �� ������� ��� ��� ����� ������.

    Syntax
       public void title ( String title )

    Description
       ������� �� ������� ��� ��� ����� ������.

    Parameter

       title
          �� ������� ��� �� ����� �� ��������.

    See Also
       author().




 5.6.  HTML_Test

 ���� � ����� ������ ��� ���������� �� �� �� �������������� ��� HTML
 ����� ��� ��� test �������� �� ������ �� �������������� ��� ��
 ����������� ��� �� ������ Java CGI ��������� ����.




 5.6.1.  ������� ����


 main()      //  �������� main().





 5.6.2.  ����� ������

 HTML.




 5.6.3.  main()


    Purpose
       ������ ��� main() ������.

    Syntax
       public static void main( String argv[] )

    Description
       ��� ����� �� ������ ��������� ��� ��� �������� CGI ��
       ��������� ��� ����� �� ��������� �����/���� ������� �� ���
       HTML ������, �� �� ���� �����/���� ������ �� ������������� ��
       ��� ������� ������ ������.

    ����������

       argv[]
          ����������� ��������� ��� �������� �� �� java.cgi �������.
          ���� �� ���� �� ���������������.




 5.7.  Text





 5.7.1.  ������ ������

 public abstract class Text


 5.7.2.  �������� ������

 � ����� ����� � ��������� �� Email ��� HTML ������.  �������
 ��������� �� ��� ������ �� ���� ��� ����� ��� ����������� ���
 ����������� �� ��� ������ �� ����������.

 ���� � ����� ����� ��� ������ ``Orbits.text''.




 5.7.3.  ������� ����


 Text()            //  ������������.

 add()             //  ��������� ������� �� �� �� �����������.

 addLineBreak()    //  ��������� ��� ������� �������.

 addParagraph()    //  ��������� ��� ������� ��������.




 5.7.4.  ����� ������

 Email, HTML.




 5.7.5.  add()


    Purpose
       ��������� ������� �� �� �� �����������.

    Syntax
       public void add ( char addition )

       public void add ( String addition )

       public void add ( StringBuffer addition )

    Description
       ��������� addition ��� ��������� ��� �� �����������
       �������.

    Parameter

       addition
          ������� �� ������ �� ��������� ��� ����������� �������

    See Also
       addLineBreak(), addParagraph().




 5.7.6.  addLineBreak()


    Purpose
       ��������� ��� ������� ������� �� �� �� ������ ��� �������.

    Syntax
       public void addLineBreak ()

    Description
       ��������� ��� ������� ������� ��� ������� ��� ����� ������.

    See Also
       add(), addParagraph().




 5.7.7.  addParagraph()


    Purpose
       ������ ��� ��� ��������.

    Syntax
       public void add ()

    Description
       ������ ��� ��� �������� �� �� �� ������ ��� ��� �������.

    See Also
       add(), addLineBreak().




 6.  ���������� �����


 �  �������� ���� Email �����:

    Email( int capacity )
       ��������������� ���� �������� ��� ���� �� ����� �� ���������
       �� ��� ����������.

    sendTo( String [] address )
       ��������� ��� ����� �������� ��������� ��� e-mail �����.

    sendCc( String address )
       ��������� ��� Carbon-Copy �������� ��� e-mail �����.

    sendCc( String [] address )
       ��������� ��� ����� �� Carbon-Copy ���������� ��� e-mail
       �����.

    sendBcc( String address )
       ��������� ��� Blind Carbon-Copy �������� ��� e-mail �����.

    sendBcc( String [] address )
       ��������� ��� ����� �� Blind Carbon-Copy ���������� ��� e-mail
       �����.

 �  �������� ���� 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.

 �  ��������� ����������� (nested) HTML ������.

 �  �������� ����� ����� ������� ��� �� ��������� ���� ���������
    ��� HTML ������ ����� ��������.

 �  � ��������� �� ����� �� �������� ������������� �� ������ ��
    ����� ���������� �� �� Makefile.

 �  �������� �� �� ������ ����� �����/���� ������ �� ����������
    ���� ��� ����� ���� ������������� ��� GET ������ ��� ��������
    ��������.

 �  ���� ��� �� ���� �� CGI �� ������� ��� java.util.Enumeration
    �������� ��� �� ������ ����� ������ ���������.

 �  �������� ���� Test ������, �� �� ������������� ���� ������ ��
    �� �� ������.

 �  ��������� �� �� CGI_Test, Email_Test ��� HTML_Test ��������� �
    ��� ��� ���� ���� ��� �� ������ ��������� ������ ���
    ������ �����������.

 �  ��������� �� � 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.