**QuickTable 2.0.

5**
Thank you for downloading the Quicktable. If you ever have questions about using
QuickTable,
or if you wish to report a bug, please contact admin@quicktable.org
If you have downloaded free version of quicktable, optionally you can purchase Q
uicktable source code
For more information about purchasing, please visit the following url.
http://quicktable.org/purchase.htm
If you find any problem, please look at the Quicktable discussion forum found at
http://quicktable.org/discussion/cutecast/cutecast.pl
If you don't see any solution there, please send a mail to admin@quicktable.org
1.0 Prerequisites
1) JDK 1.1 or higher installed
If you don't have jdk installed, download the latest jdk from http://java
.sun.com/j2se/1.3/
2) Swing 1.1 or Swing 1.03
Swing is available with Jdk1.2 & jdk1.3 version, if you are using jdk 1.1
and if you don't
have swing , download the latest swing version from http://java.sun.com/p
roducts/jfc/download.html
3) JDBC driver for your database
Every JDK comes with a default jdbc-odbc driver. If you don't want to use
odbc, you can find a jdbc driver
for your database from http://industry.java.sun.com/products/jdbc/drivers
2.0 Setup
Extract the downloaded zip/tar file, it would create the following directorie
s

1) doc - Contains the API documentation of Quicktable
using a web browser open the file index.html under this doc directory, th
is will
open the API documentation
2) lib - Has the Quicktable jar file. There will be two Quicktable jar files
under
this directory. quicktable2swing103design.jar and quicktable2swing1
03.jar for
swing 103 version or quicktable2swing11design.jar and quicktable2swi
ng11.jar for
swing 11 version.The difference between the design time jar and the
regular jar file is, the design time jar
has more classes for the customizer. So when you distribute the quic
ktable jar file with
your application, distribute the quicktable2swing11.jar or quicktabl
e2swing103.jar , but
while using with IDEs use quicktable2swing11design.jar or quicktable
2swing103design.jar .
SimpleTextDriver JDBC driver is also included in this directory.
This should be used ONLY for running the samples. To distribute simp
leTextDriver
with your application, visit http://www.thoughtinc.com and get licen
se
3) samples - Has the sample java files which uses quicktable. There are two s
ets of
sample files. One set of sample files will work with SimpleText
Database,
the other with MS Access database. The java files which uses sim
ple Text
database are under the directory samples and their database text
files
are under samples/database. The java files which uses MS Access
database are under the directory samples/MSAccessSample and thei
r database
mdb files are under samples/database directory.
4) src - If you have purchased with source code, this directory will contain
all the source
code for QuickTable.
To run your applications using QuickTable. Add the quicktable2swing103.jar or
quicktable2swing11.jar
found in lib directory to the CLASSPATH and then run your application.
If you are beginner to QuickTable/Swing, have a look at the QuickTableFrame.j
ava file in
the samples directory. If you are an experienced swing developer, have a look
at the
CustomerOrderDemo.java which explains about most of the features of QuickTabl
e. Before
you write any serious application using quicktable, you should read the Custo
merOrderDemo.java
3.0 Using Quicktable with your IDEs like Visual age, Jbuilder, Visual Cafe
Import the quicktable2swing11design.jar or quicktable2swing103design.jar fou
nd in the
lib directory to your IDE. Look at your IDE documentation for importing the
jar and
using Customizer. You can also look at the quicktable discussion forum for t
hese
information. You can use the property sheets and customizer when you use
quicktable with IDE.
4.0 Running Samples
1) Check whether JDK is properly installed in your system. Run "java" in your
command prompt
If your system is able to locate the java command, then you are fine
WINDOWS ONLY:
If you have more than one version of java or if your java command is not a
vailable
in PATH variable, then you can assign the JAVA_HOME which you want use, in
the check.bat file in samples directory.
JAVA_HOME directory is the directory which contains the bin directory
e.g if java.exe is found in c:\jdk1.2\bin\java.exe, then JAVA_HOME is c:\j
dk1.2
2) You need swing to run the samples. Swing is available with Jdk1.2 & jdk1.3
version, if you
are using jdk 1.1 and if you don't have swing , download the latest swing
version from
http://java.sun.com/products/jfc/download.html. From the downloaded file,
get
the swingall.jar file and copy it to the lib directory of quicktable or ad
d the jar
file to the classpath. WITHOUT SWINGALL.JAR THE SAMPLES WON'T WORK FOR JDK
1.x
3) Run the runSample.bat or runSample.sh file under the root directory to run
the sample file.
You will find more sample files under samples directory. Run the .bat or .sh fi
les under that directory
to run them.
WARNING: There are some problem with the SimpleText JDBC driver which is used b
y the samples. Whenever
the data in quicktable is updated , it corrupts the database text file
s in the database directory.
The next time when try to run a sample it will throw Exception. During
those times copy all the
.SDF files under sample/database/backupdatabase into sample/database a
nd then then run the samples.
Alternatively you may run the MS Access samples. To run the MSAccess s
amples, follow steps 1 & 2
and then setup the ODBC datasource with the name "quicktabledemo" wit
h the quicktable.mdb file
found under samples/database
Run any .bat or .sh files under sample/MSAccessSample
5.0 Running JDBC Test
There is a JDBC test application which is created using quicktable. It is used
to test any jdbc driver and url and also
to see the data in any table or results of a query.
1) Add your jdbc driver to the classpath.
2) Check whether the steps 1 & 2 of 4.0 is done.
3) Run the JdbcTest.bat or JdbcTest.sh file in the root directory.
6.0 Running the Customizer
Usually the customizer for quicktable can be ran only through IDE. We have cre
ated a standalone Quicktable
customizer application, which can be used to customize quicktable for a partic
ular query. This will be helpful
in setting the column widths and column header names.
1) Add your jdbc driver to the classpath.
2) Check whether the steps 1 & 2 of 4.0 is done.
3) Run the Customizer.bat or Customizer.sh file in the root directory.
4) Copy the source code created by the customizer and paste it to your code.
If you have any questions please contact:
admin@quicktable.org
Visit the QuickTable website
http://quicktable.org