Date Sample Application

This document is organized into following sub-sections :

1. Overview of the Sample Application
2. Required Software
3. Installation and Configuration
4. Description of Sample Files

The application tries to illustrate the use of DATE data type access through JDBC calls. It populates a text field with current date. The user can enter the specific departure date manually or by using the Up Down button next to the text field. When the Select button is pressed the application retrieves all the rows from the FLIGHT_DEPARTURES table with the given departure date.

Steps in the Sample

1. After invoking the application, status of the connection is shown in the status bar. Errors, if any, are shown in the status bar.
2. Enter the desired Departure Date in the text field and press the SELECT button to retrieve the rows for the specified date.
3. Press "EXIT" to exit the application.

• Oracle9i JDeveloper or higher ( Note: JDeveloper is Oracle's Visual Java Development Tool and can be downloaded from here )
  or
  JDK1.2.x or above (can be downloaded from here )

• Oracle9i (Database) or higher running SQL*Net TCP/IP listener. This can be downloaded from here.
• Travel Schema needs to be loaded into the database. This can be downloaded from here.

The section has step-by-step instructions to run this application successfully.
This will be discussed in the following subsections

Install the sample

Database setup

Run the sample using Oracle9i JDeveloper

Run the sample using the JDK environment

Install the sample

Step 1. Unjar DateSample.jar using Winzip, or using the following command:

> jar xvf DateSample.jar

You will find jar.exe in JDK_HOME\bin. Ensure JDK_HOME\bin is present in your system path. (JDK_HOME is the root directory of the JDKx.x installation ). This creates a folder DateSample with all the source files

Step 2. Edit Connection.properties file located in the directory DateSample\src. Change the hostname, portnumber and database name to those of the database instance you want to connect to.

Change the following lines:

HostName	=	insn104a.idc.oracle.com
SID	=	otn9i
Port	=	1521
UserName	=	travel
Password	=	travel

Database Setup

The application requires the Travel Schema to be loaded into the database

Run the sample using Oracle9i JDeveloper

Step 1. Using JDeveloper File/Open option select the DateSample.jws from the DateSample directory.

Step 2. Select Project/Make from JDeveloper main menu and select Make Project "DateSample.jpr"

Step 3. Select Run/Run DateSample.jpr from JDeveloper main menu to run the application.

 Step 1. Install Oracle JDBC Driver and include the zip/jar files in the CLASSPATH. Ensure that DateSample\src directory is also added to the CLASSPATH

 Step 2.  Change directory to DateSample\src\oracle\otnsamples\jdbc\datetype. Compile the files using javac:

               %javac *.java

 Step 3. Run the class file using java:            
            
              %java oracle.otnsamples.jdbc.datetype.DateSample

DateSample is the top level directory.

Please enter your comments about this sample in the OTN Sample Code Discussion Forum.