README : OOP BulkEmailSender

Updated Information

Based on your feed back, OOP-Research will continue to publish and update the examples, the sample source codes, and the articles for this API. You will find the links to them on our web site at the URL of:

Introduction of OOP BulkEmailSender

Serial ID for trial version

The configuration file asks you to write your serial ID. It may be required for the trial version in the future. But, in this distribution, you need not concern about your serial ID at all. If you are using the trial version, you will get:

TrialTimeExpiredException

every one hour during your run-time. In this case, please restart your Servlet/JSP server. Then, you can continue to use the trial version for another hour.

About this distribution

In this distribution, you will find the following files and directories:

README.html	This file.
LICENSE_product.pdf	The license agreement of this product.
LICENSE_trial.txt	The license agreement of the trial version of this product.
apiDoc	The directory for the API documentation (Java Doc). This Java Doc describes the details about the classes and their methods of this API. Please read it while you develop your web application using this API.
conf	In this directory, you will find a set of configuration files. Please read their comments and update their properties for your environment. Then, please put them into (docBase)/WEB-INF/classes directory. You may also find the file with the SQL statements. If this is the case, please run it once. It will create the necessary SQL tables.
JAR files	The binary files of this API. You will find the pair of JAR files. Please put the appropriate JAR file into (docBase)/WEB-INF/lib directory. One of them ends with _trace.jar. Only if you need the trace of the method calls of this API, please install it. Otherwise, please install another one. As for the trace of the method calls, please also read Trace of method calls by AspectJ(TM) section below.

Trace of method calls by AspectJ(TM)

If you install the JAR file that ends with _trace.jar, the method calls on this API can be printed into the log file or the console. Please update:

logging.properties

and add the lines like below:

com.bentofw.foo.execution.level=FINEST
com.bentofw.foo.execution.handler=java.util.logging.FileHandler

Please replace:

com.bentofw.foo

with the package name of the API in which you have an interest. For instance, if you want to print the method calls on the classes in:

com.bentofw.util

they will be:

com.bentofw.util.execution.level=FINEST
com.bentofw.util.execution.handler=java.util.logging.FileHandler

In addition, the method calls are captured by AspectJ(TM). Please download its binary distribution file from:

Home page of AspectJ(TM)

and put:

aspectjrt.jar

into (docBase)/WEB-INF/lib directory.

For JBuilder 2007 and Eclipse

To add the required JAR files to the new project ...

Select File --> New --> Project

Dialog titled New Project will be shown. Please go ahead, then you will reach the section titled Java Setting Otherwise, please finish to set up the new project. You can add the JAR files later on the existing project.

For existing project ...

Select Project --> Properties

Dialog titled Properties for xyz (where xyz is the name of the project) will be shown. On the left navigation tree, select Java Build Path

Select the tab titled Libraries
Click the button titled Add External JARs
Dialog for file selection will be shown. Please select the JAR file.
Click the button titled OK

For JBuilder 2006 or earlier

To add the required JAR files to the new project ...

Select File --> New Project

Dialog titled Project Wizard will be shown. Go ahead to the section titled Step 2 of 3