Nota: antes de utilizar esta información y el producto al que da soporte, asegúrese de leer la información general que aparece en Avisos.
Esta edición del README se aplica a IBM Developer Kit para Windows, Java 2 Technology Edition, Versión 1.3.1, versión de 32 bits y a todos los releases y modificaciones subsiguientes, a menos que se indique lo contrario en nuevas ediciones.
(c) Copyright Sun Microsystems, Inc. 1997, 2001, 901 San Antonio Rd., Palo Alto, CA 94303 USA. Reservados todos los derechos.
(c) Copyright International Business Machines Corporation, 1999, 2002. Reservados todos los derechos.
Derechos restringidos para los usuarios del Gobierno de los Estados Unidos - Su uso, duplicación o divulgación están restringidos por el GSA ADP Schedule Contract con IBM Corp.
Este archivo README proporciona información acerca del paquete Runtime Environment que se proporciona con el IBM(R) Developer Kit para Windows(R), Java(TM) 2 Technology Edition, Versión 1.3.1, versión de 32 bits. Utilice este archivo README si tiene previsto distribuir el Runtime Environment con su producto.
El Runtime Environment recibe soporte en los siguientes productos:
El Runtime Environment contiene la Java Virtual Machine (JVM), clases Java de Sun Microsystems y archivos de soporte. El Runtime Environment no contiene todas las clases que se hallan en el paquete Developer Kit.
Runtime Environment incluye todos los archivos .dll más las clases que dan soporte a un programa Java en tiempo de ejecución. Runtime Environment no incluye ninguna de las herramientas de desarrollo, del tipo appletviewer o javac, ni clases que pudieran pertenecer sólo a un sistema de desarrollo.
Consulte Requisitos de redistribución para obtener información acerca de los archivos que se deben redistribuir con programas Java.
El compilador JIT genera código máquina de forma dinámica para las secuencias de códigos de bytes utilizadas con más frecuencia en una aplicación o applet Java durante la ejecución. El compilador JIT (jitc.dll) se habilita por omisión.
Es posible inhabilitar el JIT para contribuir a aislar un problema con una aplicación Java, un applet o el mismo compilador.
Hay dos maneras de inhabilitar el JIT:
set JAVA_COMPILER=NONE
En Windows NT, Windows 2000 y Windows XP, también puede establecer permanentemente JAVA_COMPILER en el valor Entorno de las Propiedades del sistema. (En Windows NT, seleccione Panel de control y Sistema; a continuación, seleccione Entorno. En Windows 2000 y Windows XP, seleccione Panel de control y Sistema; a continuación, en la pestaña Avanzada, seleccione Variables de entorno).
java -Djava.compiler=NONE myapp
Para habilitar el JIT, escriba lo siguiente en un indicador de mandatos:
set JAVA_COMPILER=jitc
Para verificar si el JIT está habilitado o no, escriba lo siguiente en un indicador de mandatos:
java -version
Si el JIT se está utilizando, aparece un mensaje similar al siguiente:
JIT enabled: jitc
En caso contrario, aparecerá el mensaje siguiente:
JIT disabled
Para obtener el número de versión y de compilación de IBM, escriba lo siguiente en el indicador de mandatos:
java -version
Para ejecutar una aplicación Java, escriba el texto siguiente en un indicador de mandatos:
java nombreclase
donde nombreclase
es el nombre del archivo de clase Java
(la aplicación Java) que desea ejecutar. Para obtener información acerca de los parámetros que
puede utilizar al invocar la herramienta java, vea Java Runtime
Interpreter.
Nota: si no ha instalado el Entorno de ejecución (Runtime Environment) como JVM del sistema, primero debe establecer la vía de acceso que incluya los directorios apropiados. Para actualizar la vía de acceso, escriba lo siguiente en un indicador de mandatos:
set path=dirjava\jre\bin;%path%
donde dirjava
es el directorio en el que se ha instalado Runtime Environment.
Por omisión, este directorio es
Cuando redistribuya el Runtime Environment, es necesario que incluya archivos del siguiente paquete:
Para obtener información concreta acerca de los archivos que se deben redistribuir, consulte el documento de acuerdo de licencia que acompaña a este producto.
El término required significa que los poseedores de licencia que distribuyen el tiempo de ejecución deben incluir dichos archivos con su programa, los utilice o no.
Runtime Environment incluye los directorios \bin y \lib y sus subdirectorios. Estos dos directorios y sus subdirectorios deben residir en el mismo directorio. El directorio bin contiene archivos ejecutables y bibliotecas nativas. El directorio lib contiene los archivos de clase y property.
Todos los archivos de los directorios bin y lib son necesarios para la redistribución.
Nota: la biblioteca de tiempo de ejecución del código nativo C, msvcrt.dll, se halla en el directorio de sistema de Windows. Asegúrese de que dicho archivo se halla en el directorio de sistema de Windows. La ubicación de este directorio varía en diferentes sistemas operativos, pero acostumbra a ser:
La herramienta java invoca el Java Runtime Interpreter para ejecutar aplicaciones Java. La sintaxis para iniciar la herramienta java es la siguiente:
java [-opciones] nombreclase <args>
El argumento nombreclase
es el nombre del archivo de clase que se debe
ejecutar. Los argumentos que tengan que acompañar a la clase se deben colocar tras el
nombreclase en la línea de mandatos.
java -jar [-opciones] archivojar <args>
El argumento archivojar
es el nombre del archivo jar que se debe ejecutar.Los
argumentos que tengan que acompañar al archivo jar se deben colocar después del archivojar en
la línea de mandatos.
Hay disponible una alternativa a la herramienta java, javaw. La herramienta javaw es idéntica a la herramienta java, excepto que ésta no invoca una ventana de consola. La sintaxis para iniciar la herramienta javaw es la siguiente:
javaw [opciones] nombreclase <args>
Las opciones para la herramienta Java son las siguientes:
Las opciones -X no son estándar y están sujetas a cambios sin previo aviso.
La página Web de Sun contiene un ejemplo "Hello World". El ejemplo muestra cómo crear una aplicación Java sencilla que se ejecuta y se empaqueta en el Java Runtime Environment. El sitio Web de Sun es http://java.sun.com y puede hallar el ejemplo "Hello World" buscando en "Hello World" y "Notes for Developers".
El ejemplo muestra cómo pasar de forma muy sencilla de desarrollar aplicaciones con un Developer Kit a utilizar las técnicas más novedosas de Runtime Environment.
En su producto debe proporcionar una manera de:
Si redistribuye Runtime Environment, deberá asegurarse de que el procedimiento de instalación no altere ninguna instalación existente (a menos que la versión existente de Java Runtime Environment sea una versión antigua).
El método preferido consiste en tomar los archivos contenidos en el archivo comprimido de Runtime Environment de redistribución, ibm-jre-n131p-win32-x86.zip, e instalarlo en la misma estructura de directorios. Asegúrese de incluir todos los archivos de los directorios bin y lib y sus subdirectorios. Estos directorios se describen en Requisitos de redistribución. El software de Runtime Environment sólo se puede redistribuir si se incluyen todos estos archivos. A efectos prácticos, cuando distribuya su aplicación, ésta tendrá su propia copia del Runtime Environment.
Si usa este método, no intente imitar los pasos de instalacón realizados por el programa de instalación del Runtime Environment.
Nota: cuando instala el Runtime Environment, debe anotar la información de programa en el Registro de Windows, como sigue:
Java2 Runtime Environment/1.3.1/JavaHome | directorio raíz de java\jre |
Java2 Runtime Environment/1.3.1/JavaRuntimeLib | directorio raíz de java\jre\bin\classic\jvm.dll |
Java2 Runtime Environment/1.3.1/Microversion | 0 |
Java Plug-in/1.3.1/JavaHome | directorio raíz de java\jre |
Java Plug-in/1.3.1/JavaRuntimeLib | directorio raíz de java\jre\bin\classic\jvm.dll |
Nombre de clave | Valor de clave |
Lucida Sans Typewriter Regular (TrueType) | LucidaTypewriterRegular.ttf |
Lucida Bright Demibold Italic (TrueType) | LucidaBrightDemiItalic.ttf |
Lucida Bright Italic (TrueType) | LucidaBrightItalic.ttf |
Lucida Bright Regular (TrueType) | LucidaBrightRegular.ttf |
Lucida Sans Demibold (TrueType) | LucidaSansDemiBold.ttf |
Lucida Sans Demibold Oblique (TrueType) | LucidaSansDemiOblique.ttf |
Lucida Sans Oblique (TrueType) | LucidaSansOblique.ttf |
Lucida Sans Regular (TrueType) | LucidaSansRegular.ttf |
Lucida Sans Typewriter Bold (TrueType) | LucidaTypewriterBold.ttf |
Lucida Sans Typewriter Bold Oblique (TrueType) | LucidaTypewriterBoldOblique.ttf |
Lucida Sans Typewriter Oblique (TrueType) | LucidaTypewriterOblique.ttf |
Lucida Bright Demibold (TrueType) | LucidaBrightDemiBold.ttf |
Un ejemplo de la vía de acceso completa de un valor clave es:
Este Developer Kit presenta la opción de tiempo de ejecución JVM -Xgcpolicy para especificar la política de recopilación de desechos.
-Xgcpolicy acepta dos valores, optthruput (el valor por omisión) y optavgpause. La opción controla el comportamiento del recopilador de desechos, realizando intercambios entre la salida de la aplicación y el sistema en general y los tiempos de pausa provocados por la recopilación de desechos.
El formato de la opción y sus valores son:
-Xgcpolicy:optthruputy
-Xgcpolicy:optavgpause
Cuando un intento de una aplicación de crear un objeto no se puede cumplir inmediatamente con el espacio disponible en el almacenamiento dinámico, corresponde al recopilador de desechos identificar los objetos sin referencia (desechos), suprimirlos y reinstaurar el almacenamiento dinámico a un estado en el que las peticiones de asignación inmediatas y posteriores se puedan satisfacer rápidamente. Estos ciclos de recopilación de desechos provocan pausas inesperadas ocasionales en la ejecución del código de la aplicación. A medida que el tamaño y la complejidad de las aplicaciones aumenta y los almacenamientos dinámicos crecen en consecuencia, este tiempo de pausa de recopilación de desechos tiende a aumentar en duración e importancia. El valor por omisión de la recopilación de desechos, optthruput, proporciona una salida muy alta para las aplicaciones, pero al coste de estas pausas ocasionales, que pueden variar de unos pocos milisegundos a varios segundos, en función del tamaño del almacenamiento dinámico y la cantidad de desechos.
El valor optavgpause reduce substancialmente el tiempo invertido en estas pausas de recopilación de desechos, además de limitar el efecto de incremento del tamaño del almacenamiento dinámico en la duración de la pausa de recopilación de desechos. Esto tiene una importancia especial en configuraciones con almacenamientos dinámicos grandes. (Un almacenamiento dinámico se considera grande cuando es al menos de 1 GB.) Los tiempos de pausa se reducen intercalando actividades de recopilación de desechos con la ejecución normal del programa. Esta intercalación comporta una pequeña reducción de la salida de la aplicación.
Si el almacenamiento dinámico de Java está casi lleno y hay muy pocos desechos que recopilar, es posible que las peticiones de objetos nuevos no se puedan satisfacer rápidamente ya que no hay espacio disponible inmediatamente. Si se trabaja con un almacenamiento dinámico casi lleno, el rendimiento de las aplicaciones puede resentirse sin importar cuál de las opciones anteriores se usa y, si se siguen realizando peticiones de más espacio de almacenamiento dinámico, la aplicación recibe una excepción de Memoria agotada, que provoca la interrupción del JVM si esta excepción no se detecta y gestiona. En estas situaciones, se recomienda incrementar el tamaño del almacenamiento dinámico mediante la opción -Xmx o reducir el número de objetos de aplicación en uso.
Para obtener información adicional acerca del ajuste del tamaño del almacenamiento dinámico y las implicaciones de la recopilación de recursos en el rendimiento de las aplicaciones, vea:
Sun proporciona el Java Access Bridge para facilitar a las tecnologías de asistencia nativas de Windows, como los lectores de pantalla, acceso al soporte Java Accessibility en una aplicación Java. Estas tecnologías de asistencia nativas de Windows deben haberse escrito para realizar llamadas al Java Access Bridge.
El Java Access Bridge que facilita Sun incluye un programa de instalación, que coloca cinco archivos en los directorios correctos: access-bridge.jar, jaccess.jar, accessibility.properties, JavaAccessBridge.dll y WindowsAccessBridge.dll.
Si ya ha instalado el IBM Accessibility Bridge (JawBridge), que permite que el Windows 2000 Magnifier funcione con aplicaciones Swing, y desea ejecutar al mismo tiempo el Java Access Bridge, edite la línea del archivo accessibility.properties para que diga:
#
para desactivar ambas pasarelas.
El siguiente sitio Web le indica cómo descargar el Java Access Bridge:
Cada archivo property contiene comentarios que describen la utilidad del archivo y cómo modificarlo.
Esta información se ha desarrollado para productos y servicios que se ofrecen en los EE.UU.
IBM puede que no ofrezca los productos, servicios o características que se discuten en este documento en otros países. Consulte a su representante local de IBM para obtener información acerca de los productos y servicios actualmente disponibles en su zona. Cualquier referencia a un producto, programa o servicio de IBM no pretende afirmar ni implica que sólo se pueda utilizar dicho producto, programa o servicio de IBM. En su lugar, puede utilizarse cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. Sin embargo, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.
IBM puede tener aplicaciones patentadas o pendientes de patente que cubran el tema tratado en este documento. La posesión de este documento no le otorga ninguna licencia sobre estas patentes. Puede enviar consultas de licencias por escrito a la dirección siguiente:
Para consultas de licencias relacionadas con la información de doble byte (DBCS), póngase en contacto con el Departamento de la propiedad intelectual de IBM de su país o envíe las consultas por escrito a la dirección siguiente:
El párrafo siguiente no se aplica al Reino Unido ni a cualquier otro país en el que tales disposiciones sean incoherentes con la legislación nacional:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN "TAL CUAL" SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPLICITA O IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O IDONEIDAD PARA UN PROPÓSITO DETERMINADO. Algunos estados no contemplan la limitación de responsabilidades, ni implícitas ni explícitas, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no sea aplicable en su caso.
Esta información puede contener imprecisiones técnicas o errores tipográficos. Periódicamente se realizarán modificaciones en la información aquí contenida; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras y/o cambios en los productos y/o programas descritos en esta información en cualquier momento y sin previo aviso.
Cualquier referencia hecha en esta información a sitios Web que no son de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno como promoción de dichos sitios Web. Los materiales de estos sitios Web no forman parte de los materiales de IBM para este producto y el uso que se haga de estos sitios Web es de la entera responsabilidad del usuario.
IBM puede utilizar o distribuir la información que facilite de la manera que considere apropiada sin incurrir en obligaciones con el remitente.
Los poseedores de la licencia de este programa que deseen obtener información acerca del mismo con el propósito de permitir (i) el intercambio de información entre programas creados independientemente y otros programas (incluido éste) y (ii) la utilización mutua de la información intercambiada, deben ponerse en contacto con la dirección siguiente:
Esta información estará disponible, sujeta a los términos que correspondan, lo que en algunos casos incluirá el pago de una cuota.
IBM proporciona el programa con licencia descrito en este documento y todo el material con licencia disponible para el mismo bajo los términos del Acuerdo de cliente de IBM, el Acuerdo internacional de licencia de programas IBM o cualquier acuerdo equivalente entre las dos partes.
Cualquier información acerca del rendimiento que contenga el presente documento se ha determinado en un entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos operativos pueden variar significativamente. Es posible que algunas medidas se hayan tomado en sistemas de nivel de desarrollo y no hay garantías de que estas medidas serán iguales en los sistemas habitualmente disponibles. Asimismo, algunas mediciones pueden haber sido estimadas mediante la extrapolación. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables para su entorno específico.
La información relativa a productos que no son de IBM se ha obtenido de los proveedores de estos productos, de los anuncios públicos o de otras fuentes disponibles públicamente. IBM no ha probado esos productos y no puede confirmar la precisión del rendimiento, su compatibilidad o cualquier otra afirmación relacionada con productos que no son de IBM. Las preguntas sobre las posibilidades de los productos que no son de IBM deben dirigirse a los proveedores de dichos productos.
IBM es una marca registrada de International Business Machines Corporation en los Estados Unidos y/o en otros países.
Java y todas las marcas y logotipos basados en Java son marcas comerciales o marcas registradas de Sun Microsystems, Inc. en los Estados Unidos y/o en otros países. Sun Microsystems, Inc. es la empresa propietaria y tiene licencia exclusiva sobre la tecnología Java.
Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros países.
Otros nombres de empresas, productos o servicios pueden ser marcas registradas o de servicio de otros.