home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 July / Chip_1998-07_cd.bin / zkuste / JBuilder / JBuild / jbuilder / jruntime.z / README.JRE < prev    next >
Text File  |  1997-08-25  |  14KB  |  328 lines
  1.  
  2.                              README
  3.  
  4.                   The Java(tm) Runtime Environment
  5.                            JRE 1.1.2 
  6.  
  7. -----------------------------------------------------------------------
  8. CONTENTS
  9.  
  10.  
  11.   Overview of Java Runtime
  12.     - Introduction
  13.     - Required vs. Optional Files
  14.     - Win 32 Files 
  15.        - Required Files
  16.        - Optional Files
  17.     - Solaris Files 
  18.        - Required Files
  19.        - Optional Files
  20.  
  21.   Bundling and Running the Java Runtime
  22.     - Bundling the Java Runtime
  23.     - Java Runtime Example
  24.     - Runtime Documentation
  25.  
  26.  
  27. =======================================================================
  28.                         OVERVIEW OF JAVA RUNTIME
  29. =======================================================================
  30.  
  31. -----------------------------------------------------------------------
  32. INTRODUCTION
  33. -----------------------------------------------------------------------
  34.  
  35. This is version 1.1.2 of the Java Runtime Environment, also known as 
  36. the Java Runtime, or JRE.  The Java Runtime is the minimum standard
  37. Java Platform for running Java programs.  It contains the Java 
  38. Virtual Machine, Java Core Classes and supporting files. 
  39.  
  40. This document uses the term "vendors" to refer to licensees, 
  41. developers, and independent software vendors (ISVs) who 
  42. license and distribute the JRE with their Java programs.
  43.  
  44. The Win32 version of JRE 1.1.2 has an installer suitable for use 
  45. by end-users. This gives software developers the option of not 
  46. bundling the JRE with their applications. Instead, they can direct 
  47. end-users to download and install the JRE themselves.
  48.  
  49. An installer is not available for Solaris versions of the JRE. 
  50. Developers should bundle the JRE and an installer with their Solaris 
  51. applications. 
  52.  
  53. The JRE includes all of the non-debuggable .dll or .so files plus
  54. the necessary classes from the JDK 1.1.2 to support a runtime-only 
  55. program.  The JRE does not include any of the development tools
  56. (such as appletviewer or javac) or classes that would pertain only 
  57. to a development system.
  58.  
  59. Vendors must follow the terms of the JRE Binary Code License agreement, 
  60. which includes these terms:
  61.  
  62.  - Don't arbitrarily subset the JRE. You may omit only the
  63.    files listed below as optional. 
  64.  
  65.  - Include in your product's license the provisions called out
  66.    in the JRE Binary Code License.
  67.     
  68. The JRE is a product of Sun Microsystems, Inc.  
  69. JavaSoft is an operating company of Sun, and develops the JRE.
  70.  
  71.  
  72. -----------------------------------------------------------------------
  73. REQUIRED vs. OPTIONAL FILES
  74. -----------------------------------------------------------------------
  75.  
  76. Licensees must follow the terms of the accompanying LICENSE.  
  77. The files that make up the JRE are divided into two categories:
  78. required and optional.  To paraphrase that license, files that 
  79. are marked "optional" here do not need to be included with the 
  80. licensee's program.
  81.  
  82. The term "required" means licensees who distribute the runtime 
  83. must include those files with their program, whether or not 
  84. their program ever uses those files.  Those files are a 
  85. required part of the Java Platform.
  86.  
  87. In general, the optional files provide localization support for
  88. languages.
  89.  
  90. The JRE includes the bin and lib directories which both must
  91. reside in the same directory.  We call this directory <runtime-dir>.
  92.  
  93. In the following lists, all paths are relative to the <runtime-dir>
  94. directory (which is originally "jre1.1.2").
  95.  
  96. -----------------------------------------------------------------------
  97. WIN32 FILES
  98. -----------------------------------------------------------------------
  99.  
  100. Two versions of JRE 1.1.2 for Win32 are available. One version contains 
  101. files for internationalization support. This version contains all the 
  102. files listed below under both the REQUIRED FILES and OPTIONAL FILES 
  103. subsections. A smaller version of the Win32 JRE is available that does
  104. not contain those optional files that provide internationalization 
  105. support.
  106.  
  107. REQUIRED FILES --------------------------------------------------------
  108.  
  109.    The Win32 bin directory contains the executables and native libraries:
  110.  
  111.    bin\jre.exe                   Java runtime executable
  112.    bin\jrew.exe                  Java runtime executable, no console window
  113.    bin\javai.dll                 Java runtime native code library
  114.    bin\jdbcodbc.dll              native code support for sun.jdbc
  115.    bin\jpeg.dll                  native code support for sun.jpeg
  116.    bin\math.dll                  native code support for java.math
  117.    bin\mmedia.dll                native code support for sun.audio
  118.    bin\net.dll                   native code support for java.net
  119.    bin\sysresource.dll           native code support for sun.net.www.protocol
  120.    bin\winawt.dll                native code support for sun.awt
  121.    bin\zip.dll                   native code support for java.util.zip
  122.  
  123.    The Win32 lib directory contains the classes and property files:
  124.  
  125.    lib\rt.jar                    Java runtime core classes
  126.    lib\awt.properties            properties for key events for java.awt
  127.    lib\font.properties           Win32 font properties for java.awt
  128.    lib\serialver.properties      serialization properties
  129.    lib\security\java.security    properties for java.security
  130.  
  131. OPTIONAL FILES --------------------------------------------------------
  132.  
  133. The following files are optional:
  134.  
  135.    lib\i18n.jar                  I18N character conversion classes from sun.io
  136.    lib\content-types.properties  MIME-type properties 
  137.    lib\font.properties.ja        AWT font properties for Japanese locale
  138.    lib\font.properties.ko        AWT font properties for Korean locale
  139.    lib\font.properties.ru        AWT font properties for Russian locale
  140.    lib\font.properties.zh        AWT font properties for Simplified Chinese locale
  141.    bin\msvcrt.dll                native code C runtime library
  142.  
  143.  
  144. -----------------------------------------------------------------------
  145. SOLARIS FILES
  146. -----------------------------------------------------------------------
  147.  
  148. The following is a complete list of files included with the JRE 1.1.2 
  149. for Solaris.  
  150.  
  151. REQUIRED FILES --------------------------------------------------------
  152.  
  153. The directory <sys> varies depending on the hardware architecture and
  154. threads implementation. For this release only Solaris/SPARC with Green 
  155. threads is supported, so <sys> should be 'sparc/green_threads'.
  156.  
  157.    The Solaris bin directory contains the shell scripts and executables:
  158.  
  159.    bin/java                      Java runtime shell script
  160.    bin/<sys>/java                Java runtime executable
  161.  
  162.    The Solaris lib directory and its subdirectories contain the 
  163.    classes, properties files and native libraries:
  164.  
  165.    lib/rt.jar                    Java runtime core classes
  166.    lib/awt.properties            properties for key events for java.awt
  167.    lib/font.properties           Solaris font properties for java.awt
  168.    lib/serialver.properties      serialization properties
  169.    lib/security/java.security    properties for java.security
  170.  
  171.    lib/<sys>/libjava.so          Java runtime library
  172.    lib/<sys>/libnet.so           native code support for java.net
  173.    lib/<sys>/libmath.so          native code support for java.math
  174.    lib/<sys>/libmmedia.so        native code support for sun.audio
  175.    lib/<sys>/libawt.so           native code support for sun.awt
  176.    lib/<sys>/libjpeg.so          native code support for sun.jpeg
  177.    lib/<sys>/libJdbcOdbc.so      native code support for sun.jdbc
  178.    lib/<sys>/libsysresource.so   native code support for sun.net
  179.    lib/<sys>/libzip.so           native code support for java.util.zip
  180.  
  181. OPTIONAL FILES --------------------------------------------------------
  182.  
  183. The following files are optional.
  184.  
  185.    lib/i18n.jar                  I18N character conversion classes from sun.io
  186.    lib/content-types.properties  MIME-type properties 
  187.    lib/font.properties.cs        AWT font properties for Czech locale
  188.    lib/font.properties.pl        AWT font properties for Polish locale
  189.    lib/font.properties.hu        AWT font properties for Hungarian locale
  190.    lib/font.properties.lt        AWT font properties for Lithuanian locale
  191.    lib/font.properties.lv        AWT font properties for Latvian locale
  192.    lib/font.properties.el        AWT font properties for Greek locale
  193.    lib/font.properties.tr        AWT font properties for Turkish locale
  194.    lib/font.properties.ja        AWT font properties for Japanese locale
  195.    lib/font.properties.ru        AWT font properties for Russian locale
  196.    lib/font.properties.ko        AWT font properties for Korean locale
  197.    lib/font.properties.zh        AWT font properties for Simplified Chinese locale
  198.    lib/font.properties.zh_TW     AWT font properties for Traditional Chinese locale
  199.    lib/<sys>/libXm.so            Symbolic link to Motif runtime library 
  200.    lib/<sys>/libXm.so.3          Motif runtime library
  201.  
  202. libXm.so.3 is present in Solaris 2.5 and later, so is needed only if the 
  203. ultimate target of your program is to run on Solaris 2.4 or earlier.
  204.  
  205.  
  206. =======================================================================
  207.                 BUNDLING AND RUNNING THE JAVA RUNTIME
  208. =======================================================================
  209.  
  210. -----------------------------------------------------------------------
  211. BUNDLING THE JAVA RUNTIME
  212. -----------------------------------------------------------------------
  213.  
  214. This release of the JRE for Win32 comes with its own installer that 
  215. makes is suitable for downloading by end users. Java application 
  216. developers have the option of not bundling the JRE with their software. 
  217. Instead, they can direct end-users to download and install the JRE 
  218. themselves.
  219.  
  220. Solaris versions of the JRE do not have an installer. Software 
  221. developers should bundle the JRE and installer with their Solaris 
  222. software. 
  223.  
  224. When bundling the JRE with application software on Solaris, the 
  225. following points should be considered:
  226.  
  227. 1) It is suggested that the JRE be installed in its own subdirectory
  228.    (referred to below as <runtime-dir>).  Include all the the required
  229.    files listed above in the bin and lib subdirectories of 
  230.    <runtime-dir>, following the same directory hierarchy and 
  231.    relative placement of files.  The internationalization files 
  232.    marked optional can be included for language localization support.
  233.  
  234. 2) It is suggested that all application-specific classes be placed 
  235.    in a directory other than <runtime-dir>. Application-specific 
  236.    classes may be individual .class files, .jar files, or .zip 
  237.    files.
  238.  
  239.    An example directory structure might look like the following:
  240.  
  241.                <app-dir>
  242.        ________________|___________
  243.       |         |               |
  244.          bin       lib           <runtime-dir>
  245.           |         |          ________|________
  246.                  app.jar      |                 | 
  247.                              bin               lib         
  248.                               |                 |
  249.                        
  250.  
  251. 3) If native code support is required, then the native library must be 
  252.    located in LD_LIBRARY_PATH on Solaris or the executable search PATH 
  253.    on Win32. The best way to do this is to install the native libraries
  254.    in either <app-dir>/lib/<sys> on Solaris or <app-dir>\bin 
  255.    on Win32. LD_LIBRARY_PATH (on Solaris) or PATH (on Win32) should 
  256.    then be set to include these directories.
  257.  
  258. 4) The application can be invoked by using the jre command-line tool, 
  259.    using the -cp option to specify the application's class path. In 
  260.    the example directory tree above, for example, the command might 
  261.    look like this:
  262.  
  263.    <app-dir>/<runtime-dir>/bin/jre -cp <app-dir>/lib/app.jar <classname>
  264.  
  265.    Information on the jre command-line tool can be found in the 
  266.    JRE 1.1.2 CHANGES file and on the JavaSoft web site at 
  267.    http://java.sun.com/products/jdk1.1/docs/tooldocs/solaris/jre.html
  268.    and
  269.    http://java.sun.com/products/jdk1.1/docs/tooldocs/win32/jre.html
  270.  
  271.    Source code for the jre tool can be found in the Windows JDK 1.1.2 
  272.    directory tree in the jdk1.1.2\demo\jre\win32 folder. For the 
  273.    Solaris JDK 1.1.2, jre source code files can be found in the 
  274.    jdk1.1.2/demo/jre/solaris directory.
  275.  
  276.   
  277. For more information that might be relevant to installing and running
  278. the JRE, refer to the JDK installation instructions:
  279.  
  280.     http://java.sun.com/products/jdk/1.1/installation-win32-x86.html
  281.     http://java.sun.com/products/jdk/1.1/installation-solaris2.html
  282.  
  283.  
  284. -----------------------------------------------------------------------
  285. JAVA RUNTIME EXAMPLE
  286. -----------------------------------------------------------------------
  287.  
  288. The following web page has a Hello World example that you can download 
  289. demonstrating how to create a simple Java application that runs on, 
  290. and is bundled with, the Java Runtime Environment.  
  291.  
  292.      http://java.sun.com/products/jdk/1.1/jre/example/
  293.  
  294. This example shows how to make a simple, seamless transition
  295. from developing an application with the JDK, to deploying it with 
  296. the more-lightweight JRE.
  297.  
  298.  
  299. -----------------------------------------------------------------------
  300. RUNTIME DOCUMENTATION
  301. -----------------------------------------------------------------------
  302.  
  303. Runtime documentation is any documentation that an end-user might
  304. need after they have installed a Java program that runs on the JRE.
  305.  
  306. We supply the following runtime documentation:
  307.  
  308.   - Each property file contains comments that describe what the
  309.     file is useful for and how to modify it.
  310.  
  311.   - awt.properties file - KeyEvent uses it to print out properties of
  312.     key events, usually for debugging purposes.  This might be used
  313.     by a GUI debugger that needs to print out events.
  314.  
  315.   - fontprop.html file has a web page describing how to add 
  316.     fonts to the runtime.  This document is part of the 
  317.     JDK documentation, and is located both in the JDK documentation
  318.     download bundle and at the JavaSoft website:
  319.  
  320.     http://java.sun.com/products/jdk/1.1/docs/guide/intl/fontprop.html
  321.  
  322.  
  323. -----------------------------------------------------------------------
  324. Copyright ⌐ 1997 Sun Microsystems, Inc.
  325. 2550 Garcia Ave., Mountain View, CA 94043-1100 USA.
  326. All rights reserved.
  327.  
  328.