home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / JAVA_ALL / JDBC / JDODB110 / JDBC-ODB.ZIP / jdbc-odbc / JDBC-ODBC-RELEASE-NOTES < prev    next >
Encoding:
Text File  |  1996-10-18  |  10.0 KB  |  293 lines
  1.         JDBC-ODBC Version 1.1001 Release Notes
  2.  
  3. Version 1.1001 Notes
  4. --------------------
  5. This version fixes a few minor problems and has been updated to use
  6. JDBC 1.1. JdbcOdbc_g.dll no longer is built with the C++ debugging runtime: it now requires msvcrt.dll the same as JdbcOdbc.dll.
  7.  
  8.  
  9. Version 1.0105 Notes
  10. --------------------
  11. With this version the package name for the bridge has been changed to
  12. sun.jdbc.odbc (it was previously jdbc.odbc).  This was done in
  13. preparation for its inclusion in the forthcoming JDK 1.1 release.
  14.  
  15. Be sure to remove any previous versions of the bridge that may still be
  16. installed. This package name change also changes the path name for the
  17. JdbcOdbc.dll file: be sure to change your library path to
  18. jdbc-odbc/sun/jdbc/odbc.
  19.  
  20. The Win32 JdbcOdbc.dll is now dynamically linked and requires
  21. msvcrt.dll and msvcrtd.dll for the normal and debug versions
  22. respectively.
  23.  
  24.  
  25. What is the JDBC-ODBC Bridge?
  26. -----------------------------
  27. The JDBC-ODBC Bridge is a JDBC driver which implements JDBC operations
  28. by translating them into ODBC operations. To ODBC it appears as a
  29. normal application program.
  30.  
  31. The Bridge implements JDBC for any database for which an ODBC driver is
  32. available (for the client environments noted below.)
  33.  
  34. The Bridge is implemented as the sun.jdbc.odbc Java package and contains a
  35. native library used to access ODBC.
  36.  
  37. The Bridge is a joint development of Intersolv and JavaSoft.
  38.  
  39.  
  40. Who to contact?
  41. ---------------
  42. You can contact us at jdbc-odbc@wombat.eng.sun.com
  43.  
  44.  
  45. What version of JDBC is supported?
  46. ----------------------------------
  47. The bridge supports JDBC version 1.1.
  48.  
  49.  
  50. What version of ODBC is supported?
  51. ----------------------------------
  52. The bridge supports ODBC 2.x
  53.  
  54.  
  55. What operating systems are supported?
  56. -------------------------------------
  57. The bridge supports Solaris/Sparc 2.4 or 2.5, WinNT/Intel 3.51 and Win95.
  58.  
  59. The Solaris version is provided as a compressed tar file.
  60.  
  61. The WinNT and Win95 version is provided as zip file.
  62.  
  63.  
  64. The Bridge Implementation
  65. -------------------------
  66. The Bridge is implemented in Java and uses Java native methods to call
  67. ODBC. The only difference between the platform specific versions is the
  68. native library.
  69.  
  70.  
  71. Installation
  72. ------------
  73. See the Java web page (java.sun.com) for info on installing the JDK.
  74. You must also install JDBC, which can be downloaded from
  75. http://splash.javasoft.com/jdbc/
  76.  
  77. See your ODBC driver vendor for info on installing and configuring
  78. ODBC. No special configuration is required for the Bridge.
  79.  
  80. See your database vendor for installation and client configuration
  81. info.
  82.  
  83. Normally, JDBC classes are installed in the jdbc/classes/java/sql
  84. directory. 
  85.  
  86. The Bridge will install its classes in jdbc-odbc/classes/sun/jdbc/odbc.
  87.  
  88. Be sure to add both the jdbc/classes and the jdbc-odbc/classes
  89. directories to your Java CLASSPATH environment variable.
  90.  
  91. For NT and Win95, use a version of unzip that preserves long file names
  92. and use the -d flag. The msvcrt.dll is included.
  93.  
  94. For Solaris, uncompress and extract (tar xvf) the files.
  95.  
  96. On Solaris you need to add the directory containing libJdbcOdbc.so to
  97. your LD_LIBRARY_PATH. The libJdbcOdbc.so shared library has the following dependencies:
  98.  
  99.     libodbcinst.so.1
  100.     libodbc.so.1
  101.     libm.so.1
  102.     libc.so.1
  103.     libdl.so.1
  104.  
  105. Some ODBC driver managers name their libs libodbcinst.so and
  106. libodbc.so. These require symbolic links to the names above.
  107.  
  108. On WinNT and Win95, you need to add the directory containing
  109. jdbcodbc.dll to your PATH. The jdbcodbc dll has the following
  110. dependencies:
  111.  
  112.     kernel32.dll
  113.     odbc32.dll
  114.     odbccp32.dll
  115.     msvcrt.dll   - this is included with the bridge
  116.  
  117. In addition to the Bridge class files, a sample JDBC app,
  118. simpleselect.java, that uses the Bridge is provided. You will need to
  119. edit its data source name, UID, PWD and table name.
  120.  
  121.  
  122. Using the Bridge
  123. ----------------
  124.  
  125. The Bridge is used by opening a JDBC connection using a URL with the
  126. odbc subprotocol. See below for URL examples.
  127.  
  128. Prior to connecting, the bridge driver class, sun.jdbc.odbc.JdbcOdbcDriver,
  129. must either be added to the java.lang.System property named
  130. 'jdbc.drivers' or it must be explicitly loaded using the Java class
  131. loader. Explicit loading is done by:
  132.  
  133. Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
  134.  
  135. When loaded, the ODBC driver (like all good JDBC drivers) creates an
  136. instance of itself and registers this with the JDBC driver manager.
  137.  
  138.  
  139. Using the Bridge from an Applet
  140. -------------------------------
  141. There have been a number of questions about the use of JDBC from
  142. applets and, in particular, the use of the JDBC-ODBC Bridge driver from
  143. applets.
  144.  
  145. JDBC is designed to support both intranet and web access to databases.
  146. It also is designed to support database access from servers written in
  147. Java.  The specific nature of access provided depends on the
  148. capabilities of the JDBC driver you're using.
  149.  
  150. The JDBC spec describes several database access scenarios. It is likely
  151. that there will soon be drivers supporting these scenarios as well as
  152. others.
  153.  
  154. JavaSoft provides the JDBC-ODBC Bridge driver which allows JDBC
  155. developers to tap into the existing database access facilities provided
  156. by the ODBC API and the drivers that support it. The Bridge driver does
  157. have a few limitations.
  158.  
  159. First, there are the limitations of ODBC itself. The ODBC Driver
  160. Manager, ODBC driver and, in most cases, the DBMS client library all
  161. execute in the same program as JDBC and the JDBC-ODBC Bridge. Getting
  162. this to happen typically involves some complicated ODBC and DBMS
  163. installation and configuration. Most ODBC drivers do not support
  164. database access via the Web although its likely that a few do.
  165.  
  166. Second, the Bridge accesses ODBC via Java native C calls. This requires
  167. a native library that is platform specific and must be installed
  168. manually on each Bridge client.
  169.  
  170. Third, the Bridge cannot tell to which TCP/IP address it is connecting
  171. to. This means that it must deny service to all untrusted Java code. It
  172. defines trusted code as either code with no security manager or code
  173. whose security manager allows file writes.  Some browsers provide a
  174. mechanism for locally installing trusted applets and some do not. All
  175. browsers treat downloaded applets as untrusted. This will change with
  176. the introduction of signed applets later this year.
  177.  
  178. So, for these reasons it is not practical to use the Bridge for Web
  179. database access.
  180.  
  181. The Bridge can be used for intranet access. This requires that each
  182. client have ODBC, the Bridge native library, the Bridge itself, and
  183. JDBC installed (JDBC will be added to the next JDK release; the Bridge
  184. will not be part of the JDK but it is being provied as an optional
  185. utility being distributed with JDK 1.1.) This will work from a Java
  186. application and from trusted applets.  Depending on the security
  187. restrictions imposed by your browser, you may or may not be able treat
  188. locally installed applets as trusted. At present, the Bridge does not
  189. work with Netscape or Explorer.
  190.  
  191.  
  192. Tested Configurations
  193. ---------------------
  194. From Solaris, we have used the Bridge to access Oracle 7.1.6 and Sybase
  195. Version 10 running on Solaris. 
  196.  
  197. From NT, we have used the Bridge to access SQL Server 6.x.
  198.  
  199.  
  200. ODBC Drivers Known to Work with the Bridge
  201. ------------------------------------------
  202. Visigenic provides ODBC drivers which have been tested with the the
  203. Bridge.  Drivers are available for Oracle, Sybase, Informix, Microsoft
  204. SQL Server, and Ingres.  To purchase the ODBC DriverSet 2.0 please
  205. contact Visigenic sales at 415-312-7197, or visit the web site
  206. www.visigenic.com.
  207.  
  208. The INTERSOLV ODBC driver suite should be completely compatible with
  209. the JDBC-ODBC bridge.  The following drivers have successfully passed a
  210. minimal test suite:  Oracle, xBASE, Sybase (Windows NT/95 only),
  211. Microsoft SQL-Server, and Informix. To evaluate or purchase INTERSOLV
  212. ODBC drivers, please contact INTERSOLV DataDirect Sales at 1
  213. 800-547-4000 Option 2 or via the World Wide Web at
  214. http:\\www.intersolv.com.
  215.  
  216. The MS SQL Server driver has also been used successfully on NT.
  217.  
  218. Many other ODBC drivers will likely work.
  219.  
  220.  
  221. ODBC Driver Incompatibilities
  222. -----------------------------
  223. On Solaris, we have found that the Sybase ctlib based drivers don't
  224. work because ctlib has a signal-handling conflict with the Java VM.
  225. This is likely not a problem on NT due to differences in the NT Java
  226. VM; however, this has not been verified.
  227.  
  228. Some ODBC drivers only allow a single ResultSet to be active per
  229. Connection.
  230.  
  231.  
  232. What is the JDBC URL supported by the Bridge?
  233. ---------------------------------------------
  234. The Bridge driver uses the odbc sub protocol. Url's for this
  235. subprotocol are of the form:
  236.  
  237. jdbc:odbc:<data-source-name>[;<attribute-name>=<attribute-value>]*
  238.  
  239. For example:
  240.  
  241. jdbc:odbc:sybase
  242.  
  243. jdbc:odbc:mydb;UID=me;PWD=secret
  244.  
  245. jdbc:odbc:ora123;Cachesize=300
  246.  
  247.  
  248. Some Details About Versioning
  249. -----------------------------
  250. The JDBC API has methods for returning the driver name and version.  
  251. getDriverName and getDriverVersion (in DatabaseMetaData) will return the 
  252. following for the JDBC-ODBC Bridge:
  253.  
  254. getDriverName:          JDBC-ODBC Bridge (<odbc-driver-name>)
  255.  
  256.  
  257. getDriverVersion:       1.1001 (<odbc-driver-version>)
  258.  
  259. The Bridge version number breaks down as:
  260.  
  261.                         1.1001
  262.                         | | |____  01 - Current Bridge version for this
  263.                         | |              version of DriverManager 
  264.                         | |______  10 - Supported DriverManager minor 
  265.                         |                version
  266.                         |________   1 - Supported DriverManager major       
  267.                                          version
  268.  
  269.  
  270. Debugging
  271. ---------
  272.  
  273. The Bridge provides extensive tracing when DriverManager tracing is
  274. enabled. The following line of code enables tracing and sends it to
  275. standard out:
  276.  
  277.     java.sql.DriverManager.setLogStream(java.lang.System.out);
  278.  
  279.  
  280. General Notes
  281. -------------
  282. The Bridge was compiled with JDK 1.0.2.
  283.  
  284. The Bridge assumes that ODBC drivers are not reentrant. This means the
  285. Bridge must synchronize access to these drivers. The result is that the
  286. Bridge provides limited concurrency. This is a limitation of the
  287. Bridge; JDBC itself supports a high degree of concurrency and the JDBC
  288. drivers now being developed should significantly improve concurrent
  289. access.
  290.  
  291.  
  292.  
  293.