Oracle Java Application Tutorial

31
Oracle Java Application Tutorial In this tutorial I will guide you through the steps to create your own Java Database Application using an Oracle Database. To create a Java Application you will need at least some version of Java on the machine that you are working on. To make this a more practical effort you should also use a Java IDE. To create a Database Application you will also need a database. This tutorial will use the “Oracle Database 10g Express Edition”. This database provides all the functionality of a full commercial Oracle Database for an individual working on a local machine work free of charge. 1) Setup Decisions Evaluate the machine that you will use for your project. i. Do you have the correct Java ? You need a Java SDK (standard development kit) and a Java Application Server. The most commonly available and supported components are generally in Java 2. If you do not have Java on your machine download J2EE from sun which will install the current updated Java 2 environment including the SDK and an Application Server. J2EE link: https://sdlc5c.sun.com/ECom/ EComActionServlet;jsessionid=55115726FB21F17C8D1652ADA1F4EE06

Transcript of Oracle Java Application Tutorial

Page 1: Oracle Java Application Tutorial

Oracle Java Application Tutorial

In this tutorial I will guide you through the steps to create your own Java Database Application using an Oracle Database. To create a Java Application you will need at least some version of Java on the machine that you are working on. To make this a more practical effort you should also use a Java IDE. To create a Database Application you will also need a database. This tutorial will use the “Oracle Database 10g Express Edition”. This database provides all the functionality of a full commercial Oracle Database for an individual working on a local machine work free of charge.

1) Setup Decisions

Evaluate the machine that you will use for your project.

i. Do you have the correct Java ?

You need a Java SDK (standard development kit) and a Java Application Server.

The most commonly available and supported components are generally in Java 2.

If you do not have Java on your machine download J2EE from sun which will install the current updated Java 2 environment including the SDK and an Application Server.

J2EE link:

https://sdlc5c.sun.com/ECom/EComActionServlet;jsessionid=55115726FB21F17C8D1652ADA1F4EE06

ii. Do you have an Oracle Database ?

If you do:

You will need the server name and port number for it as well as a user name and password.

Page 2: Oracle Java Application Tutorial

If you don’t:

Download “Oracle Database 10g Express Edition” from Oracle and install it. Using the installed administrator account create a user account with appropriate permissions.

“Oracle Database 10g Express Edition” link:

http://www.oracle.com/technology/software/products/database/xe/index.html

iii. Do you have a Java IDE ?

You can choose to write your java classes by hand in a text editor and compile them to create your application. With modern IDEs freely available this is a pretty senseless waste of time.

In this tutorial I will show you the main steps to create your Oracle Java Application using the NetBeans 5.5 Java IDE. If you have NetBeans on your machine then just follow the steps shown. If you don’t have it, download it here:

NetBeans 5.5.1 link:

http://www.netbeans.info/downloads/index.php

(If you have your own favorite Java IDE then you can also try to replicate the steps in this tutorial in it.)

iv. Do you have the appropriate Java Oracle drivers ?

These come in the form of java libraries (packages) that can be imported in your java programs. Example (after the first line in your code which is the package declaration, after your import statements you can define your classes):

import oracle.sql.*;

For our purposes the “Oracle Database 10g Express Edition” database can be driven with the following libraries:

import java.sql.*;

import oracle.jdbc.*;

import oracle.jdbc.pool.*;

Page 3: Oracle Java Application Tutorial

import oracle.sql.*;

Check to see if you can import these libraries with your IDE because it may have been included with your Java environment. (Another reason why IDEs are good.)

If not, then download an implementation of these libraries in the form of a jar file and add a reference to it in your project before you try importing them in your code.

Oracle JDBC library link:

http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc101040.html

(Get the ojdbc.jar file (should be around 1,378,346 bytes))

Now you have all the components you need to implement any idea as a Java Oracle Database Application. (All free and available with public support to play with!)

In this tutorial, our idea is a way for us, as a startup bookstore, to manage our inventory.

2) Implementation Steps

Our example intends to demonstrate how to complete SQL transactions between a Java application and our Oracle database.

The extent of the specification to start us on this tutorial project is the following:

This Tutorial Project Specification:

We will make a simple database of book entries that we will search by title in our application. Our books database will consist of one table; with the following fields:

Title Edition Publisher Copyright Price<item>

Step 1: Create Example Books Database

1. Use the Oracle Database administrator with the user account created for yourself to create a books item table:

Page 4: Oracle Java Application Tutorial

Logged in as user: SYS with password from installation

Create a user – it should be self-explanatory so I will skip further image cuts.

2. Fill in example data into our new books database:

Log in as the user you just created.Choose the Object Browser.Create new TableAdd all the columns from the specification from above.Add one more called Unique_ID and set it to be your primary key.

(To do this you have make sure that it cannot be null;Then choose: “Populated from a new sequence”)

For a primary key select your extra unique id designated column.Under constraints make sure that it is unique.Create new table Add dummy data

Page 5: Oracle Java Application Tutorial

Here is what our example database table looks like:

Page 6: Oracle Java Application Tutorial

Step 2: Create our Java Application Project

1. Create new Java Application Project

Choose Project

Choose a General – Java Application

Page 7: Oracle Java Application Tutorial

Name and Location

Choose a name for your project and uncheck the Create Main class option.

Adjust location to a place you know so if you have to come back to your work then you know how. (In a school lab you might want to set this location to a shared drive where you have access to a folder.)

2. Design User Interface and Project Components

Step 1: Add the components you need to your project

Page 8: Oracle Java Application Tutorial

In my example I named my project, OraJavaBooksClient. (Name your own.)

For our application we will use a user interface, a data interface, and an error component. (Aside from the Main which is required by all Java applications.) These are:

BooksClientFrame.javaDataHandler.javaError.javaMain.java

Page 9: Oracle Java Application Tutorial

For our user interface I used some JLabels, a JList, and a JTextArea. You can design your own interface by selecting the components you want from the Palette and dragging it to the design area. By right clicking on a component in your design area you can also let the IDE generate the methods associated for that control and place it into your code. (This is only a method definition that is empty.)

An empty shell actionPerformed method used by our Submit button can be generated by selecting Events and then Action from the items right click menu.

Page 10: Oracle Java Application Tutorial

This is our Error form that displays different error messages from our application.

The following is the code for our application components:

Java Code:BooksClientFrame.java

Refer to file called BooksClientFrame.java that came along with this tutorial.

Error.java

Refer to file called Error.java that came along with this tutorial.

Page 11: Oracle Java Application Tutorial

3. Database Connectivity

Here I encourage you to make your own designs in the implementation of your version of this example. To connect to data in a database from an application you will need the following elements:

A connection string – specific to our drivers and database (user/pass) A connection object – which we can close or open An SQL data-reader

In my example I created a DataHandler object, which takes care of connectivity and gives me an interface using the above elements.

For our Books database interface we use the DataHandler class. For our demonstration we need at least a way to get a connection and a way to read the data. getDBConnection() and DBRead(string stmt) fulfills this purpose. getDBConnection() setups a connection and DBRead(string stmt) returns an SQL result set object based on the “stmt” argument, which in our case is an SQL command made by the user interface form object (our BooksClientFrame.java class).

Here is the code for our DataHandler project package item (our database interface class):

DataHandler.java

Refer to file called DataHandler.java that came along with this tutorial.

Once we have all the pieces we build the solution with the green triangle button on the IDE.

3) Debug and Demo

Build Application:

In NetBeans just press the green triangle button (without the red square in front of it; which is the debug build version – I recommend trying this though, placing breakpoints in your code and using the IDE’s debugging mode to step through your code line by line (if user command is next then the debugger halts and waits for you to enter something into your application). This allows you to check variables values in an actively running instance and see what you are doing.)

Page 12: Oracle Java Application Tutorial

Fix Build & Debug:

The highlighted statement in the editor (where the arrow is) is where execution is halted and you have full control of the IDE in debug mode (explore this if you have time). As you can see the “Watches” tab is highlighted in which I added by hand the rs.getString(1). During the first instance of the program halting by my breakpoint the value of it can be seen. Using the blue square buttons you can step through execution. Pressing the continue button continues execution until it hits the next instance of our breakpoint or some other breakpoint in our code.

Page 13: Oracle Java Application Tutorial

Running the Application:

Our java application after load (a build and a run; which is what the green triangle does):

As you can see the application displays all the items currently in our Books Oracle database upon load.

Page 14: Oracle Java Application Tutorial

Our java application after a selected input submission:

As you can see it only displays the items with that the inputted name, “How to Program C#”. The only visible result here is that you can see that there are 3 of those items in the database.

(In a more real world scenario you would be interested in displaying other things as well along with other functionality.)

4) Review

There is one serious potential structural problem. This is due to an omission in our tutorial example. If this example were expanded into a larger application, the developer might run into hard to understand run-time errors. Can you guess what this omission could be in our tutorial?

(The page after the Appendix section of this tutorial will have your answer.)

Page 15: Oracle Java Application Tutorial

Appendix

Del:Detectar idioma▼

Al:afrikaans▼

traducción del inglés al español

Oracle Application Tutorial de Java 

En este tutorial te guiará a través de los pasos para Crea tu propia base de datos de aplicaciones Java con un Base de datos Oracle. Para crear una aplicación Java que se necesitan por lo menos alguna versión de Java en la máquina que que está trabajando. Para hacer de esto una práctica más esfuerzo que usted también debe usar un IDE Java. Para crear un Base de datos que la aplicación también necesitará una base de datos. En este tutorial se utilizará la "base de datos Oracle 10g Express Edición ". Esta base de datos proporciona toda la funcionalidadde un comercial completa base de datos Oracle para un individuo trabajando en una obra del equipo local de forma gratuita. 

1) Las decisiones de instalación 

Evaluar la máquina que va a utilizar para su del proyecto. i. ¿Tiene la correcta Java? Se necesita un Java SDK (kit de desarrollo) y un Java Application Server. Los componentes más comúnmente disponibles y con el apoyo están generalmente en Java 2. Si no tienes Java en su máquina de descarga J2EE 

Page 16: Oracle Java Application Tutorial

de sol que se instalará la corriente actualizada de Java 2 medio ambiente, incluyendo el SDK y una aplicación Servidor. J2EE enlace: https: / / sdlc5c.sun.com/ECom/EComActionServlet; jsessioni d = 55115726FB21F17C8D1652ADA1F4EE06 

ii. ¿Tiene una base de datos de Oracle? 

Si lo hace: Necesitará el nombre del servidor y número de puerto para que lo así como un nombre de usuario y contraseña. 

Si no lo hacen: Ver todas las letras de Oracle Database 10g Express Edition "de Oracle e instalarlo. Uso de la instalación cuenta de administrador crear una cuenta de usuario con permisos adecuados. "Oracle Database 10g Express Edition" link: http://www.oracle.com/technology/software/products/data base / xe / index.html 

iii. ¿Usted tiene un IDE de Java? Usted puede optar por escribir tus clases java a mano en un editor de texto y compilarlos para crear su solicitud. Con IDE modernos libremente disponible este es una pérdida de tiempo bastante sin sentido. En este tutorial te mostraré los principales pasos a Crea tu Oracle Java Application con el NetBeans 5.5 Java IDE. Si usted tiene NetBeans en su máquina después sólo tienes que seguir los pasos indicados. Si no lo tiene, descargarlo de aquí: NetBeans 5.5.1 enlace: http://www.netbeans.info/downloads/index.php (Si usted tiene su propio favorito Java IDE entonces puede También tratan de reproducir los pasos de este tutorial él). 

iv. ¿Tiene el caso de Oracle Java los conductores? Estos vienen en forma de bibliotecas Java (paquetes) que se pueden importar en los programas de Java. Ejemplo (Después de la primera línea en su código que es el paquete de

Page 17: Oracle Java Application Tutorial

declaración, después de sus declaraciones de importación se puede definir sus clases): importación oracle.sql .*; Para nuestros propósitos, la "base de datos Oracle 10g Express Edición "base de datos puede ser utilizado con los siguientes bibliotecas: importación java.sql .*; importación oracle.jdbc .*; importación oracle.jdbc.pool .*; importación oracle.sql .*; Compruebe para ver si usted puede importar estas bibliotecas con el IDE, ya que puede haber sido incluido con su entorno Java. (Otra razón por la IDE son buenos.) Si no es así, descargar una aplicación de estas las bibliotecas en la forma de un archivo jar y agregue una referencia a él en su proyecto antes de intentar importarlos en el código. Oracle JDBC biblioteca de vínculos: http://www.oracle.com/technology/software/tech/java/sql j_jdbc/htdocs/jdbc101040.html (Obtener el archivo ojdbc.jar (debe estar alrededor de 1378346 bytes)) 

Ahora usted tiene todos los componentes que necesita para implementar alguna idea de como Java de Oracle de base de datos de aplicaciones. (Todos los gratuito y está disponible con el apoyo del público para jugar!) En este tutorial, nuestra idea es una manera para nosotros, como librería de inicio, para gestionar nuestro inventario. 

2) Medidas de Aplicación Nuestro ejemplo tiene la intención de demostrar cómo completar SQL las transacciones entre una aplicación Java y Oracle nuestra base de datos. El alcance de la especificación para nosotros en este inicio proyecto de tutorial es la siguiente: Esta especificación del proyecto Tutorial: Vamos a hacer una simple base de datos de anotaciones en cuenta que buscará el título en nuestra aplicación. Nuestros libros base de datos consistirá en una mesa, con las siguientes campos: Edición de Derecho de Autor Título Editorial Precio <item> 

Paso 1: Crear el ejemplo de base de datos Libros 1. Utilice el administrador de base de datos Oracle con la 

Page 18: Oracle Java Application Tutorial

cuenta de usuario creada por sí mismo para crear un libro tabla del artículo: 

Registra como usuario: SYS con la contraseña de la instalación   Crear un usuario - debe explicarse por sí mismo lo que se saltar más recortes de imagen. 

2. Rellena los datos de ejemplo en nuestros libros nuevos base de datos: 

Inicie la sesión como el usuario que acaba de crear. Elija el Examinador de objetos. Crear tabla nueva Agrega todas las columnas de la especificación de lo alto. Añadir un UNIQUE_ID más llamados y que sea su clave principal. (Para hacer esto usted tiene que asegurarse de que no puede ser nulo; A continuación, seleccione: "residencial de una nueva secuencia") Para obtener una clave principal seleccione su identificador único extra designado columna. Bajo las restricciones asegurarse de que es única. Crear una tabla nueva Añadir los datos simulados 

Esto es lo que nuestra tabla de base de datos de ejemplo el siguiente aspecto:   

Paso 2: Crear nuestro proyecto de aplicación de Java 1. Crear nuevo proyecto de aplicación de Java 

Elija Proyecto 

Page 19: Oracle Java Application Tutorial

Elegir un general - Aplicación de Java 

  

Nombre y ubicación 

Elegir un nombre para su proyecto y desmarcar la opción Crear Principal opción de clase. 

  

Ajuste la ubicación a un lugar que sabe lo que si tiene que volver a su trabajo, entonces usted sabe cómo. (En una escuela de laboratorio es posible que desee establecer este lugar a una responsabilidad compartida unidad en la que tienen acceso a una carpeta.) 

2. Diseño de interfaz de usuario y componentes del proyecto 

Paso 1: Agregue los componentes que necesita para su proyecto 

En mi ejemplo he llamado a mi proyecto, OraJavaBooksClient. (Nombre de su cuenta.) 

Para nuestra aplicación vamos a utilizar una interfaz de usuario, un Interfaz de datos, y un componente de error. (Aparte de los Principal, que es requerida por todas las aplicaciones Java.) Estas son los siguientes: 

BooksClientFrame.java DataHandler.java 

Page 20: Oracle Java Application Tutorial

Error.java Main.java 

  

Por nuestra interfaz de usuario que utiliza algunas JLabels, un JList, y un JTextArea. Usted puede diseñar su propia interfaz de seleccionar los componentes que desee en la paleta y arrastrándolo al área de diseño. Haciendo clic derecho sobre una componente en el área de diseño también puede dejar que el IDE generar los métodos correspondientes para que el control y colocarlo en el código. (Esto es sólo un método definición que está vacía.) 

Un método actionPerformed cáscara vacía utilizada por nuestros botón Enviar se puede generar mediante la selección de eventos y a continuación, la acción de los elementos de menú del botón derecho. 

  

Esta es nuestra forma de error que muestra error diferente mensajes de nuestra aplicación. 

  

Page 21: Oracle Java Application Tutorial

El siguiente es el código de nuestra aplicación componentes: 

Código de Java: BooksClientFrame.java 

Consulte el archivo llamado BooksClientFrame.java que viene junto con este tutorial. 

Error.java 

Consulte el archivo llamado Error.java que vino junto con este tutorial. 

3. Database Connectivity 

Aquí os animo a hacer sus propios diseños en el implementación de su versión de este ejemplo. Para conectarse a los datos en una base de datos de una aplicación que tendrá los siguientes elementos: • Una cadena de conexión - específicas para nuestros pilotos y base de datos (usuario / contraseña) • Un objeto de conexión - que se puede cerrar o abierta • Un lector de datos de SQL En mi ejemplo he creado un objeto DataHandler, que se encarga de la conectividad y me da una interfaz utilizando los elementos anteriores. Por nuestra interfaz de base de datos de los libros que utilizamos la DataHandler clase. Para nuestra demostración necesitamos por lo menos una forma de obtener una conexión y una manera de leer los datos. getDbConnection () y DBRead (stmt cadena) cumple este propósito. getDbConnection () las configuraciones de una conexión y DBRead (stmt cadena) devuelve un resultado conjunto de objetos de SQL basado en el "stmt" el argumento, que en nuestro caso es un comando SQL hechas por el objeto de usuario de forma de interfaz (nuestra clase BooksClientFrame.java). Aquí está el código de nuestro paquete de proyectos DataHandler punto (nuestra clase de interfaz de base de datos): DataHandler.java 

Consulte el archivo llamado DataHandler.java que llegó con este tutorial. 

Page 22: Oracle Java Application Tutorial

Una vez que tengamos todas las piezas que construir la solución con el botón triángulo verde en el IDE. 

3) Depurar y Demo 

Construir la aplicación: En NetBeans sólo tiene que pulsar el botón triángulo verde (Sin el cuadrado rojo en frente de ella, que es el la versión de depuración - Recomiendo probar este, sin embargo, colocar puntos de interrupción en el código y utilizando el IDE modo de depuración para recorrer el código línea por línea (Si es el próximo comando de usuario a continuación, se detiene el depurador y espera a que escriba algo en su aplicación). Esto le permite comprobar los valores de las variables en una instancia activa en ejecución y ver lo que está haciendo.) 

Fijar Diseña y depuración: La declaración puso de relieve en el editor (donde la flecha) es donde la ejecución se detiene y se ha control total de la IDE en modo de depuración (explorar esta opción si tienes tiempo). Como se puede ver el "Relojes" ficha puso de relieve en los que he añadido por la mano del rs.getString (1). Durante la primera instancia de la programa de detener a mi punto de corte el valor de la misma puede ser visto. Utilizando los botones azules plaza se paso través de la ejecución. Al pulsar el botón de continuar continúa la ejecución hasta que llega a la siguiente instancia de nuestro punto de interrupción o algún otro punto de ruptura en nuestro código.   

Ejecutar la aplicación: Nuestras aplicaciones Java después de la carga (a construir y ejecutar una; que es lo que el triángulo verde hace):   Como se puede ver la aplicación muestra todos los elementos Actualmente en nuestra base de datos Oracle en los Libros de carga. 

Page 23: Oracle Java Application Tutorial

Nuestras aplicaciones Java después de una presentación de entrada seleccionada:   Como se puede ver que sólo muestra los elementos con que el nombre introducido, "Cómo programar C #". El único visible resultado aquí es que se puede ver que hay 3 de los elementos de la base de datos. 

(En un escenario mundial más real que estaría interesado en mostrar otras cosas y junto con otros funcionalidad.) 

4) Revisar Hay un grave problema estructural potencial. Este se debe a una omisión en nuestro ejemplo tutorial. Si este ejemplo, se expandió a una aplicación más grande, el desarrollador podría encontrarse difícil de entender en tiempo de ejecución errores. ¿Puedes adivinar lo que esta omisión podría estar en nuestro tutorial? (La página después de la sección de apéndice de este tutorial tendrá su respuesta.) 

Apéndice 

  

La respuesta a la pregunta de la sección de Revisión anterior es que no se cierre nuestra conexión de base de datos después de que lo utilice, de manera explícita. ¿Se puede saber dónde tiene que ir?

Page 24: Oracle Java Application Tutorial

The answer to the question from the Review section above is we are not closing our database connection after we use it, explicitly. Can you figure out where it needs to go?