   Java CGI HOWTO
  David H. Silber javacgi-document@orbits.com
  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.

              ,
          .   
             
      ,     
  javacgi-document@orbits.com.



  1.4.    

      majordomo     
      ,      
       .   
    javacgi-request@orbits.com,   
  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.






























