home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / sampjdbc.zip / README.TXT < prev    next >
Text File  |  2002-10-02  |  11KB  |  208 lines
  1. =======================================================================
  2.         Ardent Software's UniObjects for Java sample applications                
  3.                                                                  
  4.  ⌐ Copyright 1998 Ardent Software, Inc. - All Rights Reserved
  5.  These are the instructions for using the supplied sample applications.
  6.  The sample applications are for the sole purpose of demonstrating
  7.  product functionality.
  8.  Ardent Software takes no responsibility for any damages of any kind
  9.  resulting from the use of this sample application software.
  10. =======================================================================
  11.  
  12. These instructions cover the installation and usage of the UniObjects 
  13. for Java demo applet/application that we have included with this 
  14. distribution.
  15.  
  16. These applications are JDK1.1.5 compatible and should work with any
  17. development or runtime environment that is also JDK1.1.5 compatible.
  18.  
  19. CONTENTS:
  20. A) Setup and usage of the demo applet/application
  21. B) Setup and usage of the catalog applet/application
  22. C) IDE, environment, browser notes
  23. D) Other
  24.  
  25. -----------------------------------------------------------------------
  26. A) Setup and usage of the demo applet/application.
  27. -----------------------------------------------------------------------
  28.  
  29.  1. Include the path of the Java class files, which are stored in zip 
  30.     file format, in the CLASSPATH environment variable of your 
  31.     development environment or operating system.
  32.     An example is, "CLASSPATH=c:\uvdk\uojsdk\lib\asjava.zip".
  33.     This will allow you to build the demo applet/application and run
  34.     it as an application. To run it as an applet see the web browser
  35.     instructions. The reason we refer to our demo as 
  36.     both an applet and application is because it is just that. The demo
  37.     can be run as one or the other. From now on we will refer to the 
  38.     demo as an applet but it can always be run as an application.
  39.  
  40.  2. To run the demo just launch it in a Java enabled environment. This 
  41.     could be a development IDE, a browser or command line Java tool. 
  42.     Two examples of launching the demo app. are, 
  43.     "c:\uvdk\uojsdk\samples\demo\java FileDemo" or 
  44.     "c:\uvdk\uojsdk\samples\demo\appletviewer FileDemo.html".
  45.  
  46.     The primary purpose of this demo is to show how UniObjects is used 
  47.     to access UniVerse from a Java environment. When the demo is run as 
  48.     an application or from the appletviewer, it will be able to access 
  49.     any UniVerse server available on your network. If the demo applet 
  50.     is run in a Web browser or some other restricted environment, only 
  51.     an installation of UniVerse on the web browser will be accessible.
  52.  
  53.     To use the demo applet from a web browser we recommend placing the 
  54.     demo applet classes as well as the asjava.zip package on a web server 
  55.     in the same directory and then access the applet through the web 
  56.     server. This will show you what a user would experience and the 
  57.     security issues faced when the applet is accessed this way. 
  58.     Browsers deal with local and remote java security differently.
  59.  
  60.  3. Operating the demo applet is very straight forward. The idea is to 
  61.     click all the buttons on the left side of the applet in order. 
  62.     After each button is clicked, the selected action is performed and 
  63.     a detailed description of the classes and methods used to perform 
  64.     the action as well as the results of that action are displayed in 
  65.     the applet. When the "Connect" button is pressed, a dialog box is 
  66.     displayed in which to enter the needed logon information. The 
  67.     applet supports environment parameters for this information and 
  68.     they may be specified in the included "FileDemo.html" file.
  69.  
  70.     The applet and application are slightly different in that, the 
  71.     "Exit Demo" button only appears when the demo is run as an 
  72.     application. This is because an applet has no concept of closing 
  73.     its instance. The application that launched the applet controls its
  74.     removal.
  75.  
  76.     We recommend running the demo as an application at first as this 
  77.     should be the most trouble free and simple way to experience the 
  78.     functionality of UniObjects.
  79.  
  80.  4. The demo applet and UniObjects was tested on Internet Explorer 4 
  81.     ver. 4.72.2106.8 and Sun's JDK 1.1.5 and should be fully compatible.
  82.  
  83. -----------------------------------------------------------------------
  84. B) Using the included catalog applet/application
  85. -----------------------------------------------------------------------
  86.  
  87.  1. Include the path of the Java class files, which are stored in zip 
  88.     file format, in the CLASSPATH environment variable of your 
  89.     development environment or operating system. An example
  90.     is, "CLASSPATH=c:\uvdk\uojsdk\lib\asjava.zip". This will allow
  91.     you to build the catalog demo applet/application and run
  92.     it as an application. To run it as an applet see the web browser
  93.     instructions. The reason we refer to our catalog demo as both an
  94.     applet and application is because it is just that. The catalog demo
  95.     can be run as one or the other. From now on we will refer to the 
  96.     catalog demo as an applet but it can always be run as an application.
  97.  
  98.  2. The catalog demo requires some server side setup before it can be
  99.     used. First pick an existing UniVerse account or create one. Next
  100.     create a UniVerse file named "MUSIC_CAT" in the account. The
  101.     command to do this at the TCL prompt will look like "CREATE.FILE
  102.     MUSIC_CAT 25". Next
  103.     use the UniVerse tool "loadfile.exe" to load the catalog data file
  104.     into the "MUSIC_CAT" file. You need to load the data
  105.     file and it's dictionary. The data file is named "MUSIC_CAT" and
  106.     the dictionary is named "D_MUSIC_CAT". The two raw data files are
  107.     located in the catalog directory with the names, "music_catalog.u"
  108.     and "d_music_catalog.u". The two commands should
  109.     look something like this;
  110.       "C:\Ardent\UV\bin\loadfile music_catalog.u MUSIC_CAT" 
  111.       "C:\Ardent\UV\bin\loadfile d_music_catalog.u D_MUSIC_CAT" 
  112.     You are now ready to run the catalog demo.
  113.  
  114.  3. To run the catalog demo just launch it in a Java enabled environment.
  115.     This could be a development IDE, a browser or command line Java tool. 
  116.     Two examples of launching the catalog demo app. are, 
  117.     "c:\uvdk\uojsdk\samples\catalog\java CatalogDemo" or 
  118.     "c:\uvdk\uojsdk\samples\catalog\appletviewer CatalogDemo.html".
  119.     If you are going to launch it with the appletviewer, you must fill in
  120.     all the param values for the applet HTML tag or it will not work 
  121.     correctly.
  122.  
  123.     The primary purpose of the catalog demo is to demonstrate how a
  124.     web based catalog viewing applet/application could be developed
  125.     using the UniObjects for Java Software Development Kit.
  126.  
  127.     To use the catalog demo applet from a web browser we recommend placing
  128.     the CatalogDemo applet classes as well as the asjava.zip package on
  129.     a web server in the same directory and then access the applet through
  130.     the web server. This will show you what a user would experience and
  131.     the security issues faced when the applet is accessed this way. 
  132.     Browsers deal with local and remote java security differently.
  133.     Currently there is a bug in the catalog demo applet which prevents
  134.     the "Selection Details" button from displaying the details of a
  135.     musical selection.
  136.     
  137.  
  138.  3. Operating the catalog demo applet is very straight forward. When the
  139.     the applet/application first is launched, it will ask you to logon
  140.     to a UniVerse server. After you fill in the appropriate information
  141.     you can click the "OK" button. The proxy server information will
  142.     not be used unless you have un commented the proxy server related
  143.     code and recompiled the CatalogDemo.java file. The application 
  144.     will login to UniVerse and retrieve all the music catalog 
  145.     information that is needed to fill the display. The user can then
  146.     adjust what artists are displayed in the text are by using the list 
  147.     boxes on the left to choose different music categories and artists.
  148.     This version of the demo application does not support the "CD" & "CS"
  149.     designations. You may select one or more musical selections and 
  150.     press the "Selection Details" button to display more detailed
  151.     information about those selections. For all selections we display
  152.     a UniVerse GIF image. If you like you can specify different images
  153.     for each selection in the "MUSIC_CAT" file and place corresponding
  154.     files in the images subdirectory of the catalog demo directory.
  155.  
  156.  4. The catalog demo applet and UniObjects was tested on Internet Explorer 4 
  157.     ver. 4.72.2106.8 and Sun's JDK 1.1.5 and should be fully compatible.
  158.  
  159. -----------------------------------------------------------------------
  160. C) Browser and IDE specific information and issues.
  161. -----------------------------------------------------------------------
  162.  
  163.  1. Internet Explore Version 4 in its default configuration can not 
  164.     launch the demo applet from the local file system without getting a 
  165.     security violation. There is no problem when the demo applet is 
  166.     accessed from a web server.
  167.     
  168.     UniObjects and the demo applet have both been verified with
  169.     Internet Explorer 4 ver. 4.72.2106.8.
  170.  
  171.     BUGS: Internet Explorer 4 included with WindowsNT 5.0 beta will not
  172.     run this demo applet. It crashes when you try.
  173.  
  174.  2. Netscape Navigator Version 4 may also display security violations 
  175.     in the same instances. Depending on your installation of Navigator, 
  176.     you may have issues with JDK 1.1 support as well. This is only an 
  177.     issue with our demo applet, not our asjava package.
  178.  
  179.     BUGS: Navigator 4 on SGI-IRIX that supports JDK1.1.2 will not run 
  180.     this demo applet. It appears to have a JDK compatibility problem. 
  181.  
  182. -----------------------------------------------------------------------
  183. D) Other
  184. -----------------------------------------------------------------------
  185.  
  186.  1. Please forward all bugs or other observed issues with this product 
  187.     to Ardent Software. This will enable us to improve the stability of 
  188.     the product and address any issues with it before the first 
  189.     release. 
  190.  
  191.     We can be reached at:
  192.         Ardent Software, Inc.
  193.         50 Washington Street
  194.         Westboro, MA 01581
  195.         PHONE:  (508)366-3888
  196.         FAX:    (508)366-3669
  197.         WEB:    http://www.ardentsoftware.com/
  198.         EMAIL:  support@ardentsoftware.com
  199.  
  200.  2. This product is developed with and is compatible with Sun's Java 
  201.     Development Kit(JDK), version 1.1.5. We have only tested our product 
  202.     with other products that also support JDK1.1.5 or higher. UniObjects
  203.     is tested and verified with Sun's version of the JDK1.1.5 for 
  204.     Microsoft Windows.
  205.  
  206. -----------------------------------------------------------------------
  207. The End
  208. -----------------------------------------------------------------------