home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 May / PCWorld_1999-05_cd.bin / software / Vyzkuste / inprise / INTRCLNT_15 / DATA.Z / JBuilderNotes.txt < prev    next >
Text File  |  1998-09-21  |  6KB  |  156 lines
  1. JBuilder Integration Notes (JBuilderNotes.txt)
  2. InterClient 1.50
  3. Last modified September 21, 1998
  4.  
  5. __________________________________________________________________
  6. Contents:
  7.     I.   JBuilder.INI and Library.INI
  8.     II.  Using borland.sql.dataset
  9.  
  10. __________________________________________________________________
  11. JBuilder.INI and Library.INI
  12.  
  13. NOTE: JBuilder must *not* be running in order for the InterClient
  14. Install to properly modify JBuilder INI settings.
  15.  
  16. The JBuilder 2 configuration files differ from those of JBuilder 1.
  17.  
  18. For JBuilder 1, the InterClient installation appends interclient.jar 
  19. to both ClassPath and IDEClassPath in the JBuilder.INI file.  
  20. JBuilder.INI is located in the JBuilder 1 bin directory.
  21.  
  22. For JBuilder 2, the InterClient installation appends interclient.jar
  23. to IDEClassPath as before.  But now InterClient 1.50 is added to the
  24. [Java_Default_Paths] Libraries setting in the JBuilder.INI file.
  25. A library entry for InterClient is created in the new JBuilder 2 
  26. Library.INI file.  Both JBuilder.INI and Library.INI are located in 
  27. the JBuilder 2 bin directory.
  28.  
  29. Here are the JBuilder 2 INI file modifications (assuming an install
  30. directory of C:\InterClient):
  31.  
  32. JBuilder.INI
  33.  
  34.     [Java_Global]
  35.     IDEClassPath=C:\InterClient\interclient.jar;...
  36.     HelpZips=.\interclient.zip;...
  37.  
  38.     [Java_Default_Paths]
  39.     Libraries=InterClient 1.50;...
  40.  
  41. Library.INI
  42.  
  43.     [Library_InterClient 1.50]
  44.     ClassPath=C:\InterClient\interclient.jar
  45.     DocPath=C:\InterClient\docs
  46.     Features=3
  47.  
  48. The JBuilder 2 help system is extended with the addition
  49. of an interclient.zip in the JBuilder doc directory, and
  50. an interclient.dat file in the JBuilder doc\interclient
  51. directory. 
  52.  
  53. To integrate InterClient documentation with the JBuilder help
  54. system, perform these steps:
  55. 1) Edit the HelpZips setting in JBuilder.INI to include
  56.    .\interclient.zip, if it is not already.
  57. 2) Copy interclient.zip from the InterClient jbuilder_help 
  58.    directory to the JBuilder doc directory.  interclient.zip
  59.    replaces an older file in the JBuilder distribution.
  60. 3) Copy interclient.dat from the InterClient jbuilder_help
  61.    directory to the JBuilder doc\interclient directory.
  62.    Replace the older file if necessary.  interclient.dat 
  63.    replaces an older file in the JBuilder distribution.
  64.  
  65. For both JBuilder 1 and 2, these changes can only be made by
  66. the InterClient install if JBuilder is installed before installing 
  67. InterClient.  Furthermore, the InterClient 1.50 library may not
  68. be added to the default paths for pre-existing projects.  Follow
  69. the steps below for adding the InterClient 1.50 library to your
  70. project.
  71.  
  72. If interclient.jar is not in the IDEClassPath for your project
  73. then the interbase.interclient.Driver will not be loaded.
  74.  
  75. The InterClient 1.50 library may be added to your project as follows:
  76. 1) Select File | Project Properties from the JBuilder menu.
  77. 2) Click the Add button.
  78. 3) Select InterClient 1.50 and click the Ok button.
  79.    Note: If InterClient 1.50 is not available
  80.          then click the New button to create
  81.          an InterClient 1.50 library and follow
  82.          the instructions below starting at step 4.
  83.  
  84. To create an InterClient library (if not already created by the
  85. InterClient installation) perform these steps:
  86. 1)  Choose File | Project Properties.
  87. 2)  Choose Libraries.
  88. 3)  Choose New.
  89. 4)  In the Name field, type "InterClient". 
  90.     Press the Edit button next to the Class path field.
  91. 5)  Choose Add Zip/JAR.
  92. 6)  Enter the interclient.jar file from the InterClient directory
  93.     into the File name field.
  94. 7)  Choose Open.
  95. 8)  Chose OK from the next two dialog boxes.
  96. 9)  From the Properties page, choose Add.
  97. 10) Select InterClient, and choose OK.
  98. 11) From the Properties page, choose OK.
  99.  
  100. If you want this change to affect all future projects, choose 
  101. Tools | Default Project Properties and follow the steps above 
  102. starting with step 2.
  103.  
  104. Uninstalling InterClient does not remove JBuilder.INI and 
  105. Library.INI settings for InterClient.  These can be removed 
  106. manually if desired.
  107.  
  108. __________________________________________________________________
  109. Using borland.sql.dataset
  110.  
  111. JDBC-specific classes in borland.jbcl.dataset have been moved to 
  112. a new package, borland.sql.dataset.  See JBuilder's README for
  113. incompatibilities with JBuilder 1.0.
  114.  
  115. Here is how to establish a database connection with the dataset package
  116. that comes with JBuilder Professional and JBuilder Client/Server.
  117.  
  118.   import borland.sql.dataset.*;
  119.  
  120.   Database database = null;
  121.   QueryDataSet queryDataSet = null;
  122.   try {
  123.     database = new Database ();
  124.     database.setConnection (
  125.       new ConnectionDescriptor (
  126.         "jdbc:interbase://server/c:/databases/employee.gdb",
  127.         "SYSDBA",
  128.         "masterkey", 
  129.         false, 
  130.         "interbase.interclient.Driver"));
  131.     queryDataSet = new QueryDataSet ();
  132.     queryDataSet.setQuery (
  133.       new QueryDescriptor (
  134.         database, 
  135.         "select * from employee", 
  136.         null, 
  137.         true, 
  138.         false));
  139.   }
  140.   catch (DataSetException e) {
  141.     e.printStackTrace ();
  142.   }
  143.  
  144. Depending on your version of JBuilder, the Database, QueryDataSet, 
  145. QueryDescriptor, and ConnectionDescriptor classes may reside in 
  146. either the borland.sql.dataset package or the borland.jbcl.dataset
  147. package.  If the code above produces the error 
  148.  
  149.   "cannot access directory borland/sql" 
  150.  
  151. with your version of JBuilder Professional, then change all
  152. borland.sql.dataset references to borland.jbcl.dataset.  
  153. For more information, see the JBuilder Programmer's Guide, Chapter 5.
  154.  
  155. __________________________________________________________________
  156.