gb2

NOTE: TO RECEIVE GUEST BOOK ENTRIES, YOU MUST SPECIFY YOUR E-MAIL ADDRESS AS THE 'RECEIVER' PARAMETER IN THE APPLETS HTML TAG.

YOUR LOCAL HOST MUST SUPPORT SMTP MESSAGES ON PORT 25

ADDENDUM TO DOCUMENTATION (7 Feb 1996) - Some of you have been unable to get your guestbook applets to work on your own home pages, while others have been successful.

If you have a chance to study the code of the mailMessage method of the 'send' class, you'll see that guestbook first establishes a socket with the 'mailhost' at port 25, in accordance with TCP/SMTP specs (see RFC 821).

Then, guestbook waits for the 220 'service ready' message transmission over the socket. After successfully receiving 220, it then obtains the 'helohost' domain name from the server and transmits the HELO <domain> command over the socket. If accepted, the receiver-SMTP returns a 250 (OK) reply.

Following that, guestbook sends MAIL FROM: <sender>, then RECPT TO: <receiver>, expecting 250 replies after each. Note that in guestbook, the sender and receiver addresses are the same.

It then sends the DATA command, and expects 354 intermediate reply from the SMTP server. All that follows DATA is the standard text message in the format defined in RFC 822, with a standard 'Subject:' field, followed by a blank line. What follows the blank line is the actual text (your guest's optional name, optional email address and comments or suggestions.)

After the message is transmitted, guestbook transmits a single '\r\n . \r\n', signifying end of message, waits for a 250 (OK) reply, then transmits a final QUIT command, and anticipates receipt of 221, indicating the server is closing the SMTP channel.

The mailMessage method then closes the socket before returning true, only if all of the above were successful. mailMessage returns false on any errors, or if the receiver parameter is null.

Guestbook should work just fine on your homepage, so long as your www host supports the above SMTP protocol. You may otherwise have to experiment to get guestbook to work with custom settings. That could actually be fun... but since guestbook works as-is on my www server, I have no need to mess with it :-(

Please let me know if you manage to get guestbook working by revising it for conditions other than those it is designed for.

Back to the gb2 applet page.

Applet Index
(sorted alphabetically)
A B C D E F G H I J K
L M N O P Q R S T U
V W X Y Z #s

The Java Source
(applets w/source code)
A B C D E F G H I J K
L M N O P Q R S T U
V W X Y Z

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.