Si el applet no se ejecuta:

• Si el applet está vinculado a una sede Web, compruebe que su servidor proxy de Web se está ejecutando. Obtenga el nombre de su servidor proxy de Web del documento de ubicación. Si está utilizando Windows, cambie al indicador de DOS y use el comando Ping seguido del nombre del servidor proxy para determinar si su conexión es correcta. Si el comando Ping devuelve un error en lugar de una respuesta, póngase en contacto con el administrador del sistema y solicítele ayuda para restaurar el servidor proxy de Web.
• Compruebe si ha incluido todos los archivos de applet necesarios. Seleccione Applet de Java - Actualizar para agregar archivos adicionales al applet. Para estar seguro de incluir todos los archivos, seleccione Todos en Mostrar archivos y haga clic en Agregar/Reemplazar todos.
• Compruebe si ha introducido los nombres correctos para los archivos de applet. Java(TM) tiene en cuenta las mayúsculas y minúsculas, de manera que los nombres de archivo deben coincidir exactamente.
• Asegúrese de que especifica correctamente los parámetros requeridos por el applet. Seleccione Archivo - Herramientas - Mostrar consola de Java y vea los mensajes presentados por el applet de Java(TM). Compruebe si existen parámetros erróneos y agregue los parámetros que sean necesarios.
• Asegúrese de que los applets que utilicen los Objetos de IBM® Lotus® Domino(TM) (clases que se ejecutan en el servidor) se están ejecutando bajo la misma versión de JVM que la utilizada para crear la biblioteca de clases que se ejecutan en el servidor (lsxbe). Por ejemplo, si un applet de Java(TM) autónomo utiliza lsxbe.so de la Versión 6 de Domino, que utiliza JVM 1.3.1, dicho applet también se debe ejecutar utilizando JVM(TM) 1.3.1. No se puede utilizar ninguna otra combinación.

Los applets de Java(TM) frecuentemente utilizan archivos de recursos, como, por ejemplo, archivos de imagen y sonido. Los applets acceden a estos archivos de tres maneras diferentes:

• Especificando una URL completa para el archivo; por ejemplo, http://www.micasa.com/imagen.gif.
• Utilizando el método de clase de applet getDocumentBase para diseñar una URL relativa a la ubicación del documento en el que se encuentra el applet.
• Utilizando el método de clase de applet getCodeBase para diseñar una URL relativa a la ubicación desde la que se han cargado los archivos del applet.

Especificación de una URL completa

Si el applet especifica una URL completa para localizar un archivo de recursos, por ejemplo, getImage("http://www.micasa.com/imágenes", "imagen.gif"), el applet intentará encontrar el archivo en dicha URL. Este método generalmente da resultado cuando se ejecutan applets con el cliente IBM® Lotus® Notes® en un documento suministrado por un servidor Domino, siempre que se configure correctamente el cliente Notes para acceder a los archivos existentes en Internet.

De forma similar, es posible acceder a imágenes anexadas a documentos de Notes incluyendo un calificador "$FILE" en la URL de Domino; por ejemplo, getImage("http://www.micasa.com/bdatos.nsf/Vistaprincipal/862..12E/$FILE", "imagen.gif"). Al igual que en el ejemplo anterior, el cliente Notes debe ser capaz de acceder al servidor Domino; de lo contrario, el applet que dicho cliente esté ejecutando no podrá acceder al archivo.

Una de las desventajas de especificar una URL completa para un archivo de recursos de un applet es la lentitud de acceso a este archivo a través de Internet y que no todos los clientes Notes están configurados para acceder directamente a Internet. Además, se da por supuesto que la ubicación de dicho archivo no va a cambiar. Si estos aspectos no constituyen un problema, la especificación de una URL completa es un método fiable para acceder a los archivos de recursos.

Uso de getDocumentBase

El método getDocumentBase es el menos fiable para especificar archivos de recursos. Este método devuelve la URL de base del documento en el que está ubicado el applet, es decir, la URL completa menos el nombre de archivo del documento. Por ejemplo, si un applet se está ejecutando en un documento ubicado en:

http://www.micasa.com/pruebas/ejemplo.html

el método getDocumentBase da como resultado una URL especificando:

http://www.micasa.com/pruebas

Algunos applets emplean este método para especificar una URL para los archivos de recursos; por ejemplo, getImage(getDocumentBase(), "imagen.gif"). De acuerdo con el ejemplo anterior, el applet buscaría el archivo de imagen en la URL

http://www.micasa.com/pruebas/imagen.gif

Tenga en cuenta, sin embargo, que la URL de Domino para un documento no hace referencia simplemente a un archivo; es un comando dirigido al servidor Domino para que éste genere el código HTML que representa a un documento. Si se utiliza el método getDocumentBase como una URL de Domino, se obtendrán resultados inesperados. Por ejemplo, suponga que ha vinculado un applet con la siguiente URL de Domino:

http://www.micasa.com/bdatos.nsf/Vistaprincipal/862..12E?OpenDocument

En este caso, si se usa el método getDocumentBase junto con la llamada a getImage se obtendrá:

http://www.micasa.com/bdatos.nsf/Vistaprincipal/imagen.gif

El applet no puede encontrar el archivo debido a que el ID del documento ya no existe y la imagen es un anexo a un documento, requiriendo por lo tanto un calificador $File como parte de su nombre.

Debido a que el ID del documento ha sido eliminado (y la imagen es un anexo en el documento y, por lo tanto, necesita un calificador "$FILE" para calificar el nombre de archivo), el applet no encontrará la imagen solicitada.

Uso de getCodeBase

El método getCodeBase es el más fiable para especificar un archivo de recursos. Este método devuelve la URL de base desde la que se ha cargado el applet. Dicha URL puede especificarse en el atributo CODEBASE de la etiqueta APPLET. Cuando Domino genera el código HTML para un applet que se ha insertado en un documento de Notes, también genera una URL completa para el atributo CODEBASE. De acuerdo con el ejemplo anterior, el método getCodeBase da como resultado:

http://www.micasa.com/bdatos.nsf/Vistaprincipal/862..12E/$FILE

Si se usa junto con las llamadas a recursos, como, por ejemplo, las llamadas a getImage, getCodeBase especifica correctamente el archivo de recursos. Por ejemplo:

getImage(getCodeBase(), "imagen.gif")

devuelve la siguiente URL cuando Domino suministra el applet:

http://www.micasa.com/bdatos.nsf/Vista principal/862..12E/$FILE/imagen.gif

Esto da como resultado una URL que permite al applet localizar correctamente el archivo.

Modificación de los valores de los parámetros para localizar los archivos de recursos

Algunos applets incluyen parámetros que hace referencia al archivo de recursos o a directorios que contienen este tipo de archivos. Por ejemplo, un applet podría incluir un parámetro que especificase un archivo para utilizarlo como imagen de fondo o el directorio en el que se encuentran los archivos de sonido requeridos por el applet. Es posible que necesite editar el applet para que dichos parámetros sean relativos a la URL de base desde la que se ha cargado el applet en lugar de a la URL de base del documento en el que está ubicado el applet.

Si no está desarrollando el applet y ha creado un vínculo a un applet existente en Internet, o ha conseguido un conjunto de archivos CLASS sin el código fuente, probablemente necesitará editar el valor de un parámetro después de insertar el applet en un formulario o documento. En este caso, anteponga la cadena "$notes_codebase" al valor de dicho parámetro.

Por ejemplo, en lugar de usar "imágenes/imagen.gif", use "$notes_codebase/imágenes/imagen.gif" como el valor del parámetro. Domino sustituirá todas las cadenas $notes_codebase incluidas en un parámetro por la URL de base desde la que se ha cargado el applet. En este caso concreto, Domino convertirá el valor del parámetro "$notes_codebase/imágenes/imagen.gif" en:

http://www.micasa.com/bdatos.nsf/Vistaprincipal/862..12E/$FILE/imágenes/imagen.gif

Debido a que se está suministrando una URL completa al especificar el valor del parámetro, se reemplazará el método getDocumentBase del applet y éste podrá encontrar el archivo de recursos.

Véase también

Inclusión de applets de Java en las aplicaciones

Glosario