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