Υπάρχουν προς το παρόν τρεις κύριες κλάσεις που υποστηρίζονται -- CGI, Email και HTML. Σκέφτομαι να προσθέσω κλάσεις για να αντιμετωπίσω τα MIME-διαμορφωμένα εισαγόμενα (input) και εξαγόμενα (output) -- MIMEin & MIMEout, αντίστοιχα.
Υπάρχουν επίσης μερικές support και test κλάσεις.
CGI_Test,
Email_Test και
HTML_Test σκοπεύουν να χρησιμοποιηθούν για να
ελέγξουν την εγκατάστασή σας.
Μπορούν επίσης να χρησιμοποιηθούν σαν ένα σημείο-εκκίνησης για τα δικά σας προγράμματα Java που χρησιμοποιούν αυτή τη βιβλιοθήκη κλάσεων.
Η
Text κλάση είναι η υπερκλάση και για τις δύο κλάσεις, την
Email και την HTML.
public class CGI
Η CGI κλάση κρατάει τις ``CGI Πληροφορίες'' -- Μεταβλητές περιβάλλοντος
από τον διακομιστή ιστού και το όνομα/τιμή που στέλνονται από μία φόρμα
όταν η submit ενέργεια είναι επιλεγμένη.
Όλες οι πληροφορίες αποθηκεύονται σε ένα Properties αντικείμενο κλάσης.
Αυτή η κλάση είναι στο πακέτο ``Orbits.net''.
CGI() // Κατασκευαστής.
getNames() // Παίρνει τη λίστα ονομάτων.
getValue() // Παίρνει την τιμή φόρμας κατά προσδιορισμένο όνομα.
CGI_Test.
Κατασκευάζει ένα αντικείμενο που περιέχει τα διαθέσιμα CGI δεδομένα.
public CGI()
Όταν κατασκευάζεται ένα αντικείμενο CGI, όλες οι διαθέσιμες CGI πληροφορίες αναρροφούνται σε αποθήκη τοπικά στο νέο αντικείμενο.
Κάνει λίστα των ονομάτων που είναι ορισμένες για να έχουν αντίστοιχες τιμές.
public Enumeration getKeys ()
Παρέχει την πλήρη λίστα των ονομάτων για τα οποία αντίστοιχες τιμές είναι ορισμένες.
Μία Enumeration όλων των ορισμένων ονομάτων.
Επανακτά την value συσχετισμένη με το name που έχει οριστεί.
public String getValue ( String name )
Αυτή η μέθοδος παρέχει τη αντιστοιχία μεταξύ των
names και values που στέλνονται από μία HTML φόρμα.
Το κλειδί κατά το οποίο οι τιμές επιλέγονται.
Ένα String που περιλαμβάνει την τιμή.
Αυτή η κλάση παρέχει ένα παράδειγμα του πώς να χρησιμοποιείτε την κλάση CGI
και ένα πρόγραμμα ελέγχου που μπορεί να χρησιμοποιηθεί για να επιβεβαιώσει ότι το πακέτο Java CGI λειτουργεί σωστά.
main() // Πρόγραμμα main().
CGI.
Παρέχει μία main() μέθοδο.
public static void main( String argv[] )
Αυτό είναι το σημείο καταχώρησης για ένα πρόγραμμα CGI που δεν κάνει τίποτα άλλο από το να αναφέρει μία λίστα με όλα τα διαθέσιμα όνομα/τιμή ζευγάρια και τις τρέχουσες τιμές τους.
Επιχειρήματα περασμένα στο πρόγραμμα από
το java.cgi script.
Προς το παρόν αχρησιμοποίητη.
public class Email extends Text
Μηνύματα σχηματίζονται με την Text κλάση add*() μεθόδους
και τις e-mail-συγκεκριμένες μεθόδους που προστίθενται από αυτήν την κλάση.
Όταν ολοκληρωθεί, το μήνυμα στέλνεται στον προορισμό του.
Αυτή η κλάση είναι στο πακέτο ``Orbits.net''.
Email() // Κατασκευαστής.
send() // Στέλνει το e-mail μήνυμα.
sendTo() // Προσθέτει έναν προορισμό για το μήνυμα.
subject() // Ρυθμίζει το Θέμα: για το μήνυμα.
Email_Test, Text.
Κατασκευάζει ένα αντικείμενο το οποίο θα περιέχει ένα email μήνυμα.
public Email()
Ρυθμίζει ένα κενό μήνυμα για να ολοκληρωθεί από τις Email μεθόδους.
Text.
Στέλνει το e-mail μήνυμα.
public void send ()
Αυτή διαμορφώνει και στέλνει το μήνυμα. Αν καμία διεύθυνση προορισμού δεν έχει ρυθμιστεί, δε λαμβάνεται καμία ενέργεια.
Προσθέτει έναν προορισμό για αυτό το μήνυμα.
public String sendTo ( String address )
Προσθέτει την address στη λίστα προορισμών για
αυτήν την μέθοδο.
Δεν υπάρχει κανένα όριο ρύθμισης στον αριθμό προορισμών που ένα e-mail μήνυμα μπορεί να έχει.
Είμαι σίγουρος πως αν σχηματίσετε τη λίστα αρκετά μεγάλη, μπορείτε να υπερβεί τε
το μέγεθος της λίστας παραμέτρων που ο Mail Transport
Agent μπορεί να αποδεχθεί ή να καταναλώσετε τη μνήμη σας.
Ένας προορισμός για να στείλετε αυτό το μήνυμα.
Στέλνει το θέμα για αυτό το μήνυμα.
public void subject ( String subject )
Αυτή η μέθοδος ρυθμίζει το κείμενο για την γραμμή Subject:
του e-mail.
Αν κληθεί περισσότερες από μία φορές, το τελευταίο ρυθμισμένο θέμα είναι αυτό που χρησιμοποιείται.
Το κείμενο της Subject: γραμμής αυτού του μηνύματος.
Αυτή η κλάση παρέχει ένα παράδειγμα του πώς να χρησιμοποιείτε την Email κλάση
και ένα test πρόγραμμα που μπορεί να χρησιμοποιηθεί για να επιβεβαιώσει ότι το Java CGI
πακέτο λειτουργεί σωστά.
main() // Πρόγραμμα main().
Email.
Παρέχει μία main() μέθοδο.
public static void main( String argv[] )
Αυτό είναι το σημείο καταχώρησης για ένα πρόγραμμα CGI
που αναφέρει μία λίστα με όλα τα διαθέσιμα όνομα/τιμή ζευγάρια και τις τρέχουσες τιμές τους.
Επίσης, θα στείλει αυτή τη λίστα στην καθορισμένη διεύθυνση στην Email
μεταβλητή.
Επιχειρήματα περνιούνται στο πρόγραμμα από
το java.cgi σενάριο.
Προς το παρόν αχρησιμοποίητα.
public class HTML extends Text
Μηνύματα σχηματίζονται με την Text κλάση add*() μεθόδους
και τις HTML-συγκεκριμένες μεθόδους που προστίθενται από αυτήν την κλάση.
Όταν ολοκληρωθεί, το μήνυμα στέλνεται στον προορισμό του.
Προς το παρόν, δεν υπάρχει έλεγχος σφαλμάτων για να επιβεβαιώσει ότι οι μέθοδοι δημιουργίας-λίστας χρησιμοποιούνται σε μία σωστή σειρά, οπότε ο προγραμματιστής πρέπει να παίρνει μέτρα για να μην παραβιάσει την HTML σύνταξη.
Αυτή η κλάση είναι στο πακέτο ``Orbits.net''.
HTML() // Κατασκευαστής.
author() // Ρυθμίζει το όνομα του συγγραφέα του εγγράφου.
definitionList() // Ξεκινά μία λίστα ορισμών.
definitionListTerm() // Προσθέτει έναν όρο στη λίστα ορισμών.
endList() // Τελειώνει μία λίστα.
listItem() // Προσθέτει μία καταχώριση σε μία λίστα.
send() // Στέλνει το HTML μήνυμα.
title() // Ρυθμίζει το κείμενο για τον τίτλο του εγγράφου.
HTML_Test, Text.
Δημιουργεί ένα αντικείμενο που θα περιέχει ένα HTML μήνυμα.
public HTML()
Ρυθμίζει ένα κενό μήνυμα να συμπληρωθεί από τις HTML μεθόδους.
Text.
Ρυθμίζει το όνομα του συγγραφέα του εγγράφου.
public void author ( String author )
Ρυθμίζει το όνομα του συγγραφέα του εγγράφου σε author.
Το κείμενο που πρέπει να χρησιμοποιηθεί σαν ο συγγραφέας αυτού του μηνύματος.
title().
Αρχίζει μια λίστα ορισμών.
public void definitionList ()
Αρχίζει μια λίστα ορισμών.
Η definition list είναι μία λίστα ειδικευμένη έτσι ώστε κάθε καταχώριση στη
λίστα είναι ένας term ακολουθούμενος από το text ορισμών
για αυτόν τον όρο.
Η αρχή μιας λίστας ορισμών θα πρέπει να ακολουθείται από
τουλάχιστον) ένα όρος/κείμενο ζευγάρι και μία κλήση στην endList() μέθοδο.
Σημειώστε πως, προς το παρόν, οι λίστες δεν μπορούν να είναι φωλιασμένες (nested)
η μία μέσα στην άλλη.
definitionListTerm(), endList(),
listItem().
Προσθέτει έναν όρο στη λίστα ορισμών.
public void definitionListTerm ()
Προσθέτει έναν όρο στη λίστα ορισμών.
Το κείμενο για το κομμάτι του όρου της τρέχουσας καταχώρησης λίστας θα πρέπει να επισυνάπτεται
στο μήνυμα αφού η μέθοδος αυτού καλείται και πριν μια αντίστοιχη
listItem μέθοδος καλείται.
definitionList(), listItem().
Τελειώνει μια λίστα.
public void endList ()
Τελειώνει μια λίστα. Αυτή η μέθοδος κλείνει μία λίστα. Σημειώστε ότι, προς το παρόν, οι λίστες δεν μπορούν να είναι φωλιασμένες (nested), η μία μέσα στην άλλη.
definitionList().
Προσθέτει μία καταχώρηση σε μία λίστα.
public void listItem ()
public void listItem ( String item )
public boolean listItem ( String term, String item )
Προσθέτει μία καταχώρηση σε μία λίστα.
Αν η πρώτη φόρμα χρησιμοποιείται, το κείμενο για την τρέχων αντικείμενο λίστας θα πρέπει να
επισυνάπτεται στο μήνυμα αφού η μέθοδος αυτή καλείται και πριν άλλες
μέθοδοι λίστας καλούνται.
Στην δεύτερη και τρίτη φόρμα, το item κείμενο προσδιορίζεται σαν μία
παράμετρος στη μέθοδο αντί να (ή επιπροσθέτως στο να) επισυνάπτεται στο
μήνυμα.
Η τρίτη φόρμα είναι ειδική στις λίστες ορισμών και παρέχει και τον
όρο και του ορισμό της καταχώρησης λίστας.
Το κείμενο αυτής της καταχώρησης λίστας.
Το κείμενο αυτής της λίστας ορισμών του κομματιού του όρου καταχώρησης.
definitionList(), definitionListTerm(),
endList().
Στέλνει το HTML μήνυμα.
public void send ()
Στέλνει το HTML μήνυμα.
Ρυθμίζει το κείμενο για τον τίτλο εγγράφου.
public void title ( String title )
Ρυθμίζει το κείμενο για τον τίτλο εγγράφου.
Το κείμενο αυτού του τίτλου του μηνύματος.
author().
Αυτή η κλάση παρέχει ένα παράδειγμα του πώς να χρησιμοποιείτε την HTML κλάση
και ένα test πρόγραμμα που μπορεί να χρησιμοποιηθεί για να επιβεβαιώσει ότι το πακέτο
Java CGI λειτουργεί σωστά.
main() // Πρόγραμμα main().
HTML.
Παρέχει μία main() μέθοδο.
public static void main( String argv[] )
Αυτό είναι το σημείο καταχώρησης για ένα πρόγραμμα CGI που επιστρέφει μία λίστα των διαθέσιμων όνομα/τιμή ζευγαριών σε ένα HTML έγγραφο, με το κάθε όνομα/τιμή ζευγάρι να απεικονίζεται σε ένα στοιχείο λίστας ορισμών.
Επιχειρήματα περασμένα στο πρόγραμμα από
το java.cgi σενάριο.
Προς το παρόν δε χρησιμοποιούνται.
public abstract class Text
Η κλάση είναι η υπερκλάση των Email και HTML
κλάσεων.
Μηνύματα χτίζονται με τις μεθόδους σε αυτήν την κλάση και συμπληρώνεται και
διαμορφώνεται με τις μεθόδους σε υποκλάσεις.
Αυτή η κλάση είναι στο πακέτο ``Orbits.text''.
Text() // Κατασκευαστής.
add() // Προσθέτει κείμενο σε αυτό το αντικείμενο.
addLineBreak() // Προσθέτει μια διακοπή γραμμής.
addParagraph() // Προσθέτει μία διακοπή παραγράφου.
Email, HTML.
Προσθέτει κείμενο σε αυτό το αντικείμενο.
public void add ( char addition )
public void add ( String addition )
public void add ( StringBuffer addition )
Προσθέτει addition στα περιεχόμενα αυτού του αντικειμένου κειμένου.
Κείμενο που πρέπει να προστεθεί στο αντικείμενο κειμένου
addLineBreak(), addParagraph().
Αναγκάζει μία διακοπή γραμμής σε αυτό το σημείο στο κείμενο.
public void addLineBreak ()
Προσθέτει μία διακοπή γραμμής στο κείμενο στο τρέχον σημείο.
add(), addParagraph().
Αρχίζει μία νέα παράγραφο.
public void add ()
Αρχίζει μία νέα παράγραφο σε αυτό το σημείο στη ροή κειμένου.
add(), addLineBreak().