Differences

This shows you the differences between two versions of the page.

--- dev:jdbc:home [2011/01/12 20:09]
els
+++ dev:jdbc:home [2016/06/28 22:38] (current)
@@ Line 3: / Line 3: @@
 ====== Development: JDBC Interface ======
-**[[dev:jdbc:home|Overview]]** | [[dev:jdbc:datasources|JDBC Datasources]] | [[dev:jdbc:sample|Sample Program]]
+**[[dev:jdbc:home|Overview]]** | [[dev:jdbc:sample|Sample Java Program]]
 ----
@@ Line 9: / Line 9: @@
 ===== Overview =====
-Omnidex provides a JDBC driver for Java applications against an Omnidex enhanced database, on any supported platform. The Omnidex JDBC driver supports standard JDBC statements and syntax as well as some additional Omnidex specific statements, functions and syntax. See the SQL Reference for a complete list of supported SQL.
-The Omnidex JDBC driver is used for all types of Java applications including console apps, swing apps, applets, JSP and Servlets.
+The Omnidex JDBC Driver is a standard-compliant JDBC driver that provides Java access to Omnidex Environments.  The Omnidex JDBC Driver is supported on Microsoft Windows and Linux operating systems.
-The Omnidex JDBC class files are store in a jar file named omnidex.jar, which is located in the bin subdirectory of the Omnidex home directory on the server, or the lib directory of the Omnidex Client home directory on the client machine.
+==== The Omnidex JDBC Classes =====
-===== Connecting Through the Omnidex JDBC Driver =====
+The Omnidex JDBC class files are stored in a jar file named Omnidex.jar, which is located in the bin subdirectory of the Omnidex home directory on a Microsoft Windows computer (%OMNIDEX_HOME%/bin/Omnidex.jar), or the lib directory on a Linux computer ($OMNIDEX_HOME/lib/Omnidex.jar).
-Connecting to an Omnidex enhanced database through the Omnidex JDBC driver is the same as connecting to any other database using any other JDBC driver, with three notable exceptions:
-The Omnidex JDBC classes and the java.sql classes must be imported into the Java class file.
+JDBC classes require that you import java.sql into the Java application.
-The Omnidex JDBC driver must be loaded and registered with java.sql.DriverManager.
-The connection url must point to an Omnidex Generic data source.
-Both the Omnidex JDBC classes and the java.sql classes must be imported into the Java application. This is because the java.sql.DriverManager is used to register the Omnidex JDBC driver and all objects returned are from the java.sql package.
-import java.sql.*;
+  import java.sql.*;
-import omnidex.jdbc.*;
-The following code snippet will load the Omnidex JDBC driver and register it with the java.sql.DriverManager. This ensures that the Omnidex JDBC driver will be used for all subsequent connections.
+The Omnidex JDBC driver requires that you load it using the following statement.
-Class.forName("omnidex.jdbc.OdxJDBCDriver");
+  Class.forName("omnidex.jdbc.OdxJDBCDriver");
-Pass the connection url to the DriverManager class to obtain a connection.
+==== Connecting to an Omnidex Environment ====
-OdxJDBCConnection conn = (OdxJDBCConnection)DriverManager.getConnection(
+Connecting to an Omnidex Environment File in JDBC simply requires referencing the Omnidex connection string in the call to DriverManager.getConnection:
-"jdbc:omnidex:c:\\odxtesting\\dsn\\odx_file_ordersffl.dsn");
-Notice that the Connection object returned by the DriverManager is being cast to an OdxJDBCConnection object. This is because the DriverManager returns a java.sql.Connection, not an omnidex.jdbc.OdxJDBCConnection. All of the Omnidex JDBC Driver classes implement the java.sql classes and inherit all of the constructors, methods and properties. The Omnidex JDBC classes also contain some additional methods a properties specific to Omnidex.
-===== Using the JDBC Interface =====
-Connecting to an Omnidex enhanced database through the Omnidex JDBC driver is the same as connecting to any other database using any other JDBC driver, with two notable exceptions:
-  * The Omnidex JDBC driver must be loaded and registered with java.sql.DriverManager.
-  * The connection url must point to an Omnidex Generic data source.
-The java.sql classes must be imported into the Java program along with any other desired Java packages. This is because the java.sql.DriverManager is used to register the Omnidex JDBC driver. Also, the Omnidex JDBC classes throw java.sql.SQLExceptions.
-  import java.sql.*;
-The following code snippet will load the Omnidex JDBC driver and register it with the java.sql.DriverManager. This ensures that the Omnidex JDBC driver will be used for all subsequent connections.
+  Connection conn =
+    DriverManager.getConnection( "jdbc:omnidex:[server1:7555]C:\\class\\simple.xml");
-<code>
+It is also possible to reference a File DSN in the call to DriverManager.getConnection.  File DSN's are typically used with ODBC applications, but can be useful for externalizing the connection string.  Consult the [[dev:odbc:filedsn| ODBC File DSN Syntax Specification]] for instructions to build a File Datasource.
-Class.forName("omnidex.jdbc.OdxJDBCDriver");
-// Pass the connection url to the DriverManager class to obtain a connection.
-Connection conn = DriverManager.getConnection(
-"jdbc:omnidex:c:\\odxtesting\\dsn\\odx_file_ordersffl.dsn");
-</code>
-All of the Omnidex JDBC Driver classes implement the java.sql classes and inherit all of the constructors, methods and properties. The Omnidex JDBC classes also contain some additional methods and properties specific to Omnidex.
+  Connection conn =
+    DriverManager.getConnection( "jdbc:omnidex:simple.dsn");
 =====  =====
-**[[dev:jdbc:datasources|Next]]**
+**[[dev:jdbc:sample|Next]]**
 ====== Additional Resources ======
@@ Line 68: / Line 45: @@
 See also:
+  * [[dev:odbc:filedsn| ODBC File DSN Syntax Specification]]
 {{page>:dev:see_also&nofooter&noeditbtn}}
 {{page>:bottom_add&nofooter&noeditbtn}}

Back to top

dev/jdbc/home.1294862964.txt.gz · Last modified: 2016/06/28 22:38 (external edit)

Sitemap Recent Changes