home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 March / PCWorld_2001-03_cd.bin / Software / Komercni / VAgeJava / ivj35 / setup / REP.Cab / F21463_README.txt < prev    next >
Text File  |  2000-07-30  |  6KB  |  156 lines
  1. This file tells you how to run SwingSet, both as an applet and
  2. as an application.
  3.  
  4.  
  5. ==================================
  6. RUNNING SWINGSET AS AN APPLICATION
  7. ==================================
  8.  
  9. JDK 1.1.x (Solaris)
  10. -------------------
  11.   setenv SWING_HOME <path to swing release>
  12.   setenv JAVA_HOME <path to jdk1.1.x release>
  13.   runnit
  14.  
  15. JDK 1.1.x (win32)
  16. -----------------
  17.   set CLASSPATH=<path to jdk1.1.x release>\lib\classes.zip
  18.   set SWING_HOME=<path to swing release>
  19.   runnit
  20.  
  21.  
  22. =============================
  23. RUNNING SWINGSET AS AN APPLET
  24. =============================
  25.  
  26. JDK 1.1.x
  27. ----------------------
  28. You can choose from several approaches to running the SwingSet demo as
  29. an applet.  You need to apply only one approach, not all.  This section
  30. tells you how to run SwingSet as an applet in the following browsers:
  31.  
  32. - JDK Applet Viewer 
  33. - IE 4.0
  34. - Netscape Communicator 4.04 with the latest 1.1 patch
  35.   (obtained from http://developer.netscape.com/software/jdk/download.html)
  36.  
  37. The usual approach to running a Swing applet is to put the Swing class
  38. libraries in a local directory where the browser can find them.
  39. Another (much slower) scheme is to store the Swing class libraries with
  40. the applet's classes, which allows clients to download the Swing class
  41. libraries over the network.
  42.  
  43. Here are the three ways to put Swing class libraries in a local directory
  44. where the browser can find them:
  45.  
  46. 1. Use the CLASSPATH environment variable.
  47. 2. Specify the class path in another way (only the JDK Applet Viewer
  48.    allows this, to our knowledge).
  49. 3. Put the Swing classes in a browser-specific directory.
  50.  
  51. Setting the CLASSPATH environment variable appears to work for all
  52. browsers.  However, setting CLASSPATH can sometimes lead to trouble,
  53. since it's easy to forget to update it when you update your JDK version
  54. or your browser.  Take care if you choose to use CLASSPATH.
  55.  
  56. The file SwingSetApplet.html contains the <APPLET> tag necessary for
  57. running SwingSet, assuming that the Swing classes are locally
  58. available to the browser.  
  59.  
  60.  
  61. JDK Applet Viewer (any platform)
  62. --------------------------------
  63. Enter this command:
  64.   runapplet
  65.  
  66.  
  67. IE 4.0 or Netscape Communicator 4.04 with latest 1.1 patch (Win NT)
  68. -------------------------------------------------------------------
  69. This is the CLASSPATH solution for Windows NT.
  70.  
  71. 1) Open ControlPanel->System->Environment.
  72. 2) In *User* Variables window, add or modify SWING_HOME and CLASSPATH
  73.    to look like like following:
  74.     SWING_HOME=<path to swing installation>
  75.     CLASSPATH=<currentclasspath>;%SWING_HOME%\swing.jar;%SWING_HOME%\motif.jar;%SWING_HOME%\windows.jar
  76. 3) Remember to "Set" the changes, then press OK.
  77. 4) To ensure the changes take effect, restart your computer.
  78.  
  79.  
  80. IE 4.0 or Netscape Communicator 4.04 with latest 1.1 patch (Win95)
  81. -------------------------------------------------------------------
  82. This is the CLASSPATH solution for Windows 95.
  83.  
  84. 1) Use your favorite ASCII editor to add the following to the
  85.    c:\autoexec.bat file:
  86.    set SWING_HOME=<location of Swing directory>
  87.    set CLASSPATH=%CLASSPATH%;%SWING_HOME%\swing.jar;%SWING_HOME%\windows.jar;%SWING_HOME\motif.jar
  88. 2) Restart the computer.
  89.  
  90.  
  91. IE4.0 (win32)
  92. -------------
  93. To put the Swing classes where IE4.0 can find them (without using
  94. CLASSPATH), you must first unjar the Swing archives and then put the
  95. resulting files in the java\classes directory under the IE installation
  96. directory.  For example, on Windows NT:
  97.  
  98. 1) Go to IE's java/classes directory:
  99.    cd <location-of-IE-install>/java/classes
  100. 2) Unarchive the files:
  101.    jar xf %SWING_HOME%/swing.jar
  102.    jar xf %SWING_HOME%/windows.jar
  103.    jar xf %SWING_HOME%/motif.jar
  104.  
  105.  
  106. Netscape Communicator 4.04 with latest 1.1 patch (Win95)
  107. --------------------------------------------------------
  108. To put the Swing classes where Netscape Communicator can find them
  109. (without using CLASSPATH), put the Swing JAR files under the
  110. Communicator installation's Java\Classes directory.  By default, this
  111. directory will be located here:
  112.  
  113.    c:\Program Files\Netscape\Communicator\Program\Java\Classes
  114.  
  115. For example:
  116.  
  117.    copy %SWING_HOME%/*.jar c:\<netscape-dir>\Communicator\Program\Java\Classes
  118.  
  119.  
  120. Any browser: Loading Swing classes over the network
  121. ---------------------------------------------------
  122. If you wish to download the Swing classes over the network, you need to
  123. first put the Swing class libraries in the same directory as the
  124. applet's class files.  Then create a JAR file containing all the other
  125. files needed by SwingSet.  (This last step is not necessary for every
  126. browser, but it will help it load faster.)  For example:
  127.  
  128.   cd classes
  129.   jar cvf SwingSet.jar *.class *.txt images
  130.   copy ..\..\..\*.jar .
  131.  
  132. Once you've performed these steps, you should be able to visit the
  133. SwingSetApplet2.html page in any 1.1 browser. It will take several
  134. minutes for the applet to start running, since the Swing class libraries
  135. have to be completely downloaded before the applet can run.
  136.  
  137.  
  138. Known problems with running Swing applets:
  139. ------------------------------------------
  140. - Internet Explorer supports either class files or archive files in
  141.   the <APPLET> tag, not both.  To work around this, you can put the
  142.   SwingSet classes in a JAR files, as described above.
  143.  
  144. - Both browsers exhibit different problems with missed repaints.
  145.   Moving the mouse around or minimizing and restoring the frame "fixes"
  146.   this problem.  We're investigating how to workaround these problems.
  147.  
  148. - Internet Explorer doesn't implement Class.getResource() for JAR
  149.   files.  The visual effect is missing text and graphics files in
  150.   SwingSet.
  151.  
  152. - Internet Explorer may throw exceptions "Event queue access denied".
  153.   These can be ignored.
  154.  
  155. - Netscape Communicator loads large JAR files very slowly.  
  156.