home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / JAVA_ALL / JDBC / JDBC_TES / JDBC-TES.ZIP / jdbc-tests / JDBC-TESTS-RELEASE-NOTES < prev    next >
Encoding:
Text File  |  1996-10-18  |  3.5 KB  |  119 lines
  1.         JDBC Test Suite Version .05 Release Notes
  2.  
  3. Version .05 Notes
  4. -----------------
  5. Added connection tests RetainedResultSet RetainedStatement
  6. Deleted connection test DisableAutoClose
  7. Fixed bugs in the dbmetadata Keys test
  8. Revised tests to use java.lang.Bignum in place of java.sql.Numeric
  9.  
  10. What is the JDBC Test Suite?
  11. -----------------------------
  12. The JDBC Test Suite is a set of java classes that each extend
  13. jdbcTest.harness.TestModule class. These tests can only be run by the
  14. JDBC Test Harness. The tests are divided into packages - one for each
  15. JDBC interface being tested.
  16.  
  17. Over time the test suite will grow into its intended role as a JDBC
  18. driver certification mechanism. Currently, it is a useful mechanism for
  19. examining the functionality provided by a JDBC driver.
  20.  
  21. The Test Suite is written entirely in Java.
  22.  
  23. The Test Suite was jointly developed by JavaSoft and Intersolv.
  24.  
  25.  
  26. Who to contact?
  27. ---------------
  28. You can contact us at jdbc@wombat.eng.sun.com
  29.  
  30.  
  31. What version of JDBC is supported?
  32. ----------------------------------
  33. The Test Suite supports JDBC version 1.1.
  34.  
  35.  
  36. What operating systems are supported?
  37. -------------------------------------
  38. The Test Suite can be run on any system that supports Java. It was
  39. developed with JDK 1.0.2.
  40.  
  41.  
  42. Installation
  43. ------------
  44. You must have already installed Java, JDBC and a JDBC driver. You will
  45. also need the JDBC Test Harness.
  46.  
  47. See the Java web page for info on installing the JDK and JDBC.
  48.  
  49. You must have access to a database and permission to create tables and
  50. database procedures.
  51.  
  52. The Test Suite will install itself in the jdbc-tests directory; be sure to
  53. add the jdbc-tests/classes directory to your Java CLASSPATH environment
  54. variable.
  55.  
  56. Both a compressed tar file for Unix and a zip file for Windows is
  57. provided. Be sure to use a version of unzip that preserves long file
  58. names.
  59.  
  60. For Solaris uncompress and extract (tar xvf) the files.
  61.  
  62.  
  63. Using the Test Suite
  64. --------------------
  65. See the JDBC Test Harness release notes.
  66.  
  67.  
  68. Resource ini Files
  69. ------------------
  70. Some of the tests rely on existing objects in the database. The objects
  71. are loaded and removed using SQL statements provided in resource files.
  72. The test suite provides versions of these files for Oracle, SQLServer
  73. and Sybase.
  74.  
  75. If you are using a different database you will likely have to create
  76. translated version of these. The harness allows you to set the resource
  77. directory for a test run.
  78.  
  79. Each file is named for its corresponding test. For instance, the
  80. jdbcTest.data.CreateTables test has an ini file named
  81. jdbcTest.data.CreateTables.ini
  82.  
  83.  
  84. Writing Your Own Tests
  85. ----------------------
  86. You can write your own JDBC tests. See the jdbc-tests/jdbcTest/examples
  87. directory for several runnable example tests.
  88.  
  89. If you have tests you would like to donate to us please send them to
  90. jdbc@wombat.eng.sun.com.
  91.  
  92.  
  93.  
  94. Debugging
  95. ---------
  96. Most test failures should be clear from the logging provided by the
  97. test itself. In the cases where this is insufficient, you can enable
  98. DriverManager tracing in JDBCTestWin.ini with:
  99.  
  100. [Driver Options]
  101. ;Set this to ON if you want full JDBC DriverManager tracing enabled.
  102. DriverManagerLog = ON
  103.  
  104. When DriverManager tracing is enabled all JDBC drivers should show a
  105. detailed trace of their activities. This will be interspersed with the
  106. logging done by the test itself.
  107.  
  108.  
  109. Known Bugs
  110. ----------
  111. There are no known test bugs; however, different drivers and DBMS's are
  112. bound to find problems. We would like to know about any problems you
  113. encounter. Please send a DriverManager test log with each report.
  114.  
  115. If you have suggestions for improving the Test Suite let us know.
  116.  
  117.  
  118.  
  119.