This example show the creation of a dynamic "phone bill" from a database
query. The same example can be seen on our website at:

  http://bfo.com/products/report/examples.jsp


The files in this directory are:
--------------------------------
PhoneDatabase.java
	A simple JavaBean encapsulating a database connection. We
	wouldn't even think about using this in a production environment
	without adding database pooling etc., but it's fine as an example.

schema.txt
	The SQL database schema. Although this is currently for MySQL, as
	it's ANSI standard SQL it should be easily adapted for any RDBMS.

phonebill.jsp
	The actual JSP that generates the phonebill. Requires an
	"account" parameter (which much be "12345678") and an optional
	"pagesize" parameter (which should be either "A4" or "letter"

bwlogo.jpg
	A bitmap image required by phonebill.jsp

index.html
	The HTML which can be loaded to create a link to the phonebill.


To run the example
------------------
1. Create a database to store the tables, and load the data contained in
   "schema.txt" into that database

2. Modify the "PhoneDatabase.java" class to set the JDBC URL, username and
   password to connect to this database, copy it into the
   "WEB-INF/classes/phonebill" directory of your servlet engine and compile.

3. Copy the "index.html", "phonebill.jsp" and "bwlogo.jpg" files into the
   document root.


For those using a Servlet 2.2 engine, like Tomcat 3.x or JRun:


4. Compile the "SampleServlet.java" in the "examples" directory, and copy it
   into the "WEB-INF/classes" directory of your servlet engine.


For those using a Servlet 2.3 engine, like Resin 2.0.3 or Tomcat 4.x


4. Edit the "index.html" file and uncomment the block marked "for Servlet
   Filter". Edit the "WEB-INF/web.xml" file under your servlet engines document
   root, and add the following block inside the "<webapp>" element.

    <filter>
      <filter-name>pdffilter</filter-name>
      <filter-class>org.faceless.report.PDFFilter</filter-class>
    </filter>
    <filter-mapping>
      <filter-name>pdffilter</filter-name>
      <url-pattern>/phonebill.jsp</url-pattern>
    </filter-mapping>

