SQLJ

This is the source distribution of the SQLJ reference implementation
version 1.0.1.1.

You must have JDK1.1 or later, JavaCC 0.7.1, GNUmake, and Unix utilities
to compile this source distribution.

If you want to install and compile the sources right away, you can run
gmake and follow the instructions that are displayed.

————————————————————————-
WHAT IS SQLJ?

Oracle, IBM, Sybase, Tandem, Informix, Microsoft, Sun Microsystems, and
others have produced the SQLJ Standard for embedding static SQL statements
and constructs in Java programs (ANSI proposal X3H2 98-227).

SQLJ is a way to reduce the development and maintenance costs of Java
programs that require Database connectivity. SQLJ provides a simpler model
for Java code containing static SQL Statements (SQL which does not change each
time you run your application or applet. Applications typically contain
much more static SQL than dynamic SQL).

The reductions in the development and maintenance costs arise because SQLJ
uses an easier methodology of embedding SQL directly into Java programs,
resulting in code that is more concise and more legible. SQLJ can further
make coding easier by providing compile-time checks on the SQL statements
your application uses. In using dynamic SQL API’s such as JDBC, you won’t
find out if your SQL is syntactically or semantically wrong until you test
the line in your code which runs it.

This implementation is intended to work with any standard JDBC Driver running
against any Database Management System.

For more information visit the SQLJ homepage at

http://www.sqlj.org/

or Oracle’s SQLJ homepage at

http://www.oracle.com/st/products/sqlj/

If you have questions or suggestions about SQLJ, please send email to:

SQLJSUP@US.ORACLE.COM

—————————————————————————
WHO IS THIS DISTRIBUTION FOR?

This distribution contains the source code of the SQLJ reference
implementation. Unless you want to:
– write SQLJ profile customizations, e.g. to support features or
additional databases,
– write SQLJ SQL checkers for particular databases, or
– embed the SQLJ preprocessor in IDE environments
you will probably not need to use this distribution.

Also note, that this distribution contains SOURCE ONLY. Documentation of
the SQLJ specification and the SQLJ preprocessor is packaged with the
binary SQLJ Reference Distribution 1.0.1.1.

This source distribution contains
- this file [README]
- a GNU makefile for building and compiling the source [GNUmakefile]
- a makefile include for specifying the location for generated classes
[ClassRepository]
- one subdirectory for each of the Java packages that make up SQLJ

—————————————————————————
INSTALLATION

(1) Unzip the distribution file as per operating system instructions below.
The sources will be installed in a directory sqlj/src.

Unix
gzip -dc sqlj___RELEASEFILE__src.tgz | tar xvf -

NT/Win95
Use Winzip to unzip sqlj___RELEASEFILE__src.zip to sqlj___RELEASEFILE__src_stored.zip
and then unzip that file.

(2) SQLJ uses Java 1.1 or later. You can download a Java 1.1 or later
development kit from:

http://www.javasoft.com/products/jdk/1.1/

SQLJ uses JavaCC 0.7.1 and the Java 1.1 grammar provided with it.
You can download JavaCC (including jjtree) version 0.7.1 from

http://www.suntest.com/JavaCC/download.html

The Java 1.1 grammar is copyright by Sun Microsystems and can not be
included in this distribution. However, you can obtain it from:

http://www.cs.ucla.edu/~dongwon/JavaCC/java/Java1.1.jj

Once you have downloaded it, you must place the Java1.1.jj file into
this directory to allow gmake to continue.

(3) Edit the ClassRepository file to make the repository variable
point to the directory where you want the compiled class files
to be placed.

(4) The oracle.util.javadep package is not part of SQLJ proper.
However, since it is used for ‘gmake depend’ targets, it is also built.

(5) After you have retrieved Java1.1.jj and made changes to ClassRepository,
you can build and compile the source by typing ‘gmake’.

Other targets:
gmake clean – removes created classes and files
gmake all – rebuilds all packages
gmake depend – rebuilds intra-package dependencies
gmake javadoc – creates Javadoc pages for all packages

————————————————————————-
SUPPORT

There is no official Oracle support for this source distribution.

However, your may direct suggestions for fixes and enhancements to:

SQLJSUP@US.ORACLE.COM

————————————————————————-
LEGAL TERMS UNDER WHICH THIS DISTRIBUTION IS MADE AVAILABLE

Oracle expressly places this Software in the public domain.
However, Oracle grants no other rights, whether express or
implied, to users of this Software, and Oracle provides this
Software on an “AS-IS” basis, exclusive of any warranty
including, without limitation, all warranties of merchantability
or fitness for a particular purpose, noninfringement or any other
warranty, whether expressed or implied. You use this Software at
your own risk and agree that Oracle shall not be liable for any
damages, including but not limited to, direct, indirect, incidental,
special, cover, reliance, or consequential damages, arising from
your use of the Software.

————————————————————————
COPYRIGHT ACKNOWLEDGEMENTS

SQLJ is built with the Java Compiler Compiler Version 0.7.1 (Parser Generator)
which is Copyright (c) 1996, 1997 Sun Microsystems Inc.

SQLJ utilizes a modified version of the Java Compiler Compiler grammar for
Java 1.1, which is Copyright (C) 1996, 1997 Sun Microsystems Inc.