What is this servlet for? From the one side it is a Java servlet implements classical message board. But from the another site it is a new concept. You do not need to go to particular web site for checking messages. The whole discussion will be locked within your mailbox. All what do you need is a mail clients supports HTML messages (most of them do this nowadays).
How does it work? With the help of this servlet you can start a new discussion. You type your message and mail it to the people you want to be joined to your discussion (including yourself). After that all what do you (and they) need is only check from time to time this letter from your (their) mailbox (mailboxes). Of course when you do that you must be online and MailBoard servlet (maintains all discussions) must be up.
The same servlet can serve many discussions and you can have different configurations for different discussions.
How to use it:
1. Download mailBoardPackage.jar and save it in your WEB-INF/lib folder.
2) Define servlet in your web.xml file.
For each your board you must provide a configuration file describes how to save messages as well as various interface settings. You can use MailBoardServlet in two forms.
a) pass configuration file as a parameter. E.g.:
b) define your configuration file as an initial parameter for servlet
(parameter name is config):
and use servlet in this form: http://your_host/servlet/mailboard
Configuration file is a text file, each line describes one parameter in the form of
Empty lines and any line starts with # or // are ignored. Current version supports the following list of parameters:
# Persistence. You can use file based persistence -
# Base directory, this parameter must be set
# JNDI name (instead of the above mentioned pair)
# Optional parameter: user name for JDBC connection. You can omit this parameter.
# name of the table
# SMTP mail host. This parameter is mandatory
# Mail domain. This parameter is mandatory
# SMTP port. Default value is 25
# address 'From'. Initial letter will be sended
# title. Default value is empty (no title)
# background color. Default value is #FFFFFF (white)
#foreground color. Default value is #000000 (black)
#font size (by default is current browser's font)
#font face (by default is current browser's font)
# space (empty lines) between threads. Default value is 0 (no space)
# Date format. By default board will use full date.
# offset. By default board will use server's time (offset=0). You can
# Sorting. How to output messages.
# Messages per page. Default value is 10 (One long thread will be always
on the same page,
# Frame to display messages. By default it is _self. In other
# localization support. You can set character encoding for input parameters
2. Evaluation version displays first three pages only.
More about database persistence
All data will be saved in the one table. Name of this table is included
in your configuration file (table=your_table). So if you support several
forums each of them has got own table (probably in the same database).
Table must be created before the first use of servlet with the appropriate
configuration file. Use your database admin tools for doing this. Here
is a DDL statement for this table:
CREATE TABLE your_table_name (
Id CHAR(30) PRIMARY KEY,
Msg LONG VARCHAR);
You must use the same names for columns but depends on your database you can change the type for the last column (Msg). This column (domain) will keep text data for individual messages. You may decide to use TEXT for example. Check out your DB manual for supported SQL data types. You may also change types from CHAR to VARCHAR.
Initial dialog (screen).
This screen lets you start new discussion. You may replace it completely, or
create discussions from your JSP/Perl/PHP script etc. In order to start a new discussion
you have to post data to MailBoard servlet. Names for parameters (fields for HTML form)
are: a2 - author, a3 - subject, a4 - message, a5 - "mail to" list.
And action for HTML form is
See also JSOS - the largest collection of servlets and filters.
Also in JSOS: