FAQ SOBRE SOLUCION DE PROBLEMAS

Requisitos de Sistema:

Java está soportado por las versiones 2 y superiores de Netscape, por las versiones 3 y superiores de MS Explorer, HotJava y otros navegadores, en sistemas operativos de 32 bits (Windows 95/NT, Mac OS, Sparc, Linux, etc.). El soporte para Java de los navegadores debe estar activado; en caso contrario, se visualizará un mensaje advirtiendo que el navegador no soporta Java. Los applets de Java no se verán en Windows 3.1 o en navegadores que trabajen en 16 bits (Netscape 4 para Windows 3.1 soporta Java, pero no como lo hace Win 95). El Anfy Java wizard necesita Win 95/98/NT.

Diferencias entre Java y JavaScript

Java es diferente de JavaScript. Java está hecho para crear ficheros .class y es mucho más poderoso que JavaScript, que es sólo un lenguaje para elaborar scripts - pequeños ficheros de instrucciones- que se insertan directamente en los documentos HMTL.
El paquete Anfy Java sólo contiene applets de Java.

Cómo añadir applets de Java a los documentos HTML?

1) Copie el fichero .class en el mismo directorio de los documentos .html , junto con las imágenes GIF y JPG. Con el Anfy Java wizard esto puede realizarse con la función "Copy all files to".

2) Añada la etiqueta <applet> en el documento html. Algunos editores de html no disponen de esta instrucción, o tienen estándares especiales. Si le ocurre esto, no se preocupe. Grabe primero el documento .html, y después edítelo con un editor de texto en modo DOS, como Notepad, o con cualquier procesador de texto en modo ASCII. Entonces, añada manualmente la etiqueta <applet>.
Anfy Java wizard le ayudará a crear la etiqueta <applet> con las imágenes y los parámetros necesarios. Usted deberá copiar y pegar el resultado de esta etiqueta <applet> en su documento html. También puede utilizar la función "Copy all files to" para grabar un documento .html que sólo contiene el applet y volver a abrirlo después con su editor de html preferido y añadirle todo lo que necesite.

3) Coloque el fichero .html junto con los ficheros .class y los demás (imágenes, etc.) en su servidor de páginas web del mismo modo que lo viene haciendo habitualmente.
Por favor, observe que debe colocar los ficheros .class utilizando el FTP en modo BINARY y ¡no en modo ASCII! Si no lo hace de esta manera, los applets no funcionarán (y en la pantalla aparecerán mensajes del tipo: "java.lang.ClassFormat" o "java.lang.MethodVerification" o "Bad Magic Number"). Asegúrese de el nombre y el tamaño de los ficheros no sufren ninguna variación durante el proceso de carga en el servidor. Si los ficheros tiene diferente tamaño o nombre (por ejemplo, si terminaran en cla. en vez de .class) es que alguna cosa ha funcionado mal.

Errores más comunes:

A) NOMBRES LARGOS TRUNCADOS Y CAMBIO DE MAYUSCULAS Y MINUSCULAS: algunos usuarios de MS-DOS todavía utilizan PKUNZIP para descomprimir los archivos zip o programas de 16 bits para copiar y cargar ficheros. Estas aplicaciones no tienen en consideración diferencias entre FiLe.ExE, FILE.EXE y fILe.eXe. Esto no es bueno por varias razones:

La primera de ellas es el uso de nombres largos para documentos: msdos (y los antiguos Win 3.1 de 16 bits) sólo aceptan nombres de ficheros con 8+3 caracteres.
Los nuevos sistemas admiten nombres largos para los ficheros, por ejemplo MyNiceApplet.class, que tiene un sufijo con 5 caracteres. Si se utiliza PKUNZIP para descomprimir los ficheros applet, o se cargan en el servidor ficheros .class con FTP del antiguo Windows 3.1 o similares, lo que sucede es que se TRUNCARA el nombre del fichero, y el resultado será MYNICEAP.CLA.
Si intenta hacer funcionar el applet verá el mensaje de error: "java.lang.ClassNotFound". Compruebe que está usted descomprimiendo sus ficheros con winzip32 o similares en Win95, y utilice programas actuales, que no cortan los nombres de los documentos, para copiar o cargar sus ficheros en el servidor.

Tenga en cuenta de que la mayoría de los servidores de Internet funcionan con sistemas Unix, que distinguen entre mayúsculas y minúsculas.
Por ejemplo, si un applet que se llama "MyNiceApplet.class" se carga en el servidor con el nombre "Myniceapplet.class", no funcionará. Uno de los errores más comunes es cambiar letras mayúsculas por minúsculas en los ficheros de imagen. Y ello sucede porque a Win95 le es indiferente que los nombres de ficheros se escriban de un modo o de otro, de manera que puede cargar un fichero aunque estén cambiadas letras mayúsculas por minúsculas.
Por ejemplo, si graba una imagen como "image1.jpg" usted podrá cargarla en el servidor desde su disco duro local tanto si se refiere a ella como IMAGE1.JPG, image1.JPG o IMAGE1.jpg. Pero, una vez que está colocada en el servidor de su proveedor de servicios Internet sólo funcionará si se refiere a ella con su nombre exacto: image1.jpg.
Asegúrese, por tanto, de que las imágenes que carga en el servidor se escriben de modo idéntico a como lo hacen en el applet.

B) Imagen equivocada o tamaño del applet: lea cuidadosamente las instrucciones del applet porque las imágenes suelen tener un tamaño OBLIGATORIO (por ejemplo, 64*64, 128*128 etc.). No agrande los applets ni las imágenes por encima de 600 pixels, porque, en tal caso, no serán totalmente visibles para aquellos usuarios que utilicen monitores de 640*480 pixels.
En muchos casos, Anfy Java wizard puede detectar un tamaño incorrecto del applet o de la imagen, y le ayudará a prevenir la mayoría de los errores más comunes.

Errores menos habituales:

A) Usando Netscape Gold 3, los applets funcionan off-line, pero dejan de hacerlo cuando están on-line, viéndose el mensaje de error: "java.lang.NullPointerException error".

Se trata de un "bug" (error) de este navegador que aparece aleatoriamente. Si ocurre, intente actualizar o volver a cargar la página, limpiando el caché. En algunos casos es necesario limpiar el caché manualmente en el directorio caché de Netscape. Un error "NullPointer" similar al anterior aparece ocasionalmente en Netscape 4.04.
No obstante, los visitantes no tienen ningún problema para ver el applet.


B) "He actualizado todos mis ficheros class en mi sitio de GEOCITIES y cuando he vuelto a cargar la página recibo un mensaje de error (java.lang.NoClassDefFoundException) en los applets".

Este es un problema temporal producido por Geocities y por algunos otros sitios. Si usted vuelve a cargar las páginas un par de minutos más tarde, los applets funcionarán correctamente.
En otras circunstancias, este error significa que usted olvidó carga algún fichero .class (por ejemplo, anfy.class).


C) "Utilizando Netscape 3, me aparece un mensaje de error (java.awt.image.Memory ImageSource: method newPixels(), o java.lang.NoSuchMethodError: java.awt.image. Memory ImageSource) en los applets.

Este es un problema relacionado con anfy.class. Probablemente esté usted utilizando un fichero anfy.class antiguo o incorrecto, o tiene uno antiguo en el caché.
Compruebe que está utilizando el mismo anfy.class que viene con los applets y limpie la memoria caché.


D) "Estoy utilizando el navegador AOL, y en la página aparece todo menos el applet. Sin embargo, veo el mensaje Loading image aunque la imagen no aparece nunca: sólo el rectángulo gris".

En este caso, debe usted desactivar la compresión de gráficos en las preferencias de su navegador AOL del siguiente modo:
En la Barra de Herramientas de AOL, haga click en Members, click en Preferences, click en el icono WWW Icon (la imagen del globo del mundo) y verá un cuadro de diálogo. Haga click en la lengüeta "Web Graphics" y aparecerá una página con la pregunta: "Do you want Web Graphics to be compressed. This will display pages faster" ("Quiere comprimir los gráficos de la web? Esto hará que sus páginas se vean más rápido"); bajo la pregunta verá un casilla que deberá activar si desea comprimir las imágenes, o dejar en blanco en caso contrario. Si está activada, desactívela.


E) "Estoy utilizando una imagen gif transparente en un applet (lens, water, laket, etc.) como imagen principal y lo que veo es un fondo gris en vez de transparente".

Esto sucede porque Java no soporta los fondos transparentes. Sólo puede usar imágenes transparentes como imágenes superpuestas.


F) Extrañamente, alguna de las imágenes gifs no aparecen completamente en Netscape, mientras que sí ven correctamente en Explorer.

En muchos casos, usted debe volver grabar la imagen GIF en modo entrelazado si estaba grabada en modo normal, o viceversa. Después, se verá correctamente.
Este problema es más frecuente con las imágenes más grandes.


G)"He borrado el parámetro <param name="credits"> y el applet ha dejado de funcionar, aunque está registrado".

Con el registro, usted compra un código de registro que activa los parámetros de vínculos y elimina la ventana de crédito emergente que aparece cuando el mouse hace click sobre el applet. Esto no incluye el parámetro "credits", que es solamente la firma del applet y no resulta visible para los visitantes (excepto para los que miran el código fuente de la página). Este es el motivo por el que no se modifica mediante el registro. Por qué querría borrar esta firma? Como se indica en las instrucciones, la firma del applet no puede eliminarse.

Trucos y consejos:

1) Usted se preguntará: "Qué estarán viendo los visitantes cuyos navegadores no soportan Java?". Usted puede especificar un texto, una imagen o todo un bloque de html para que sea utilizado en lugar del applet:

<applet code="MyApplet.class" width=150 height=150>
<param name=param1 value="1234">
<param name=param2 value="5678">
<IMG ALT="*" ALIGN=center SRC="imagenalternativa.gif" border=0>
</applet>

También puede cargar imágenes para applets desde un directorio cgi-bin, por ejemplo un cgi "selección del día" o similar:

<applet code="MyApplet.class" width=150 height=150>
<param name=image value="/cgi-bin/Image.cgi">
<param name=param2 value="5678">
<IMG ALT="*" ALIGN=center SRC="/cgi-bin/Image.cgi" border=0>
</applet>

Así, puede verse una imagen normal si el navegador del visitante no soporta Java, lo que es preferible a las manipulaciones de la imagen si Java está presente. En Anfy Java wizard puede introducirse también un texto alternativo o html en el campo: "For no java browser".



2) Si necesita leer los ficheros .class desde otro directorio o ruta (path), basta con que use esta etiqueta de código base:

<applet codebase="http://www.app.com/app/" code="MyApplet.class" width=150 height=150>
<param name=param1 value="1234">
<param name=param2 value="5678">
Lo siento, su navegador no soporta Java.
</applet>



3) Cuando intente utilizar una máscara para el applet, aparece un delgado borde (de 1-2 pixels) arriba del applet antes de la imagen que gira.

Para eliminarlo, use las etiquetas HSPACE="0" y VSPACE="0", dentro de la etiqueta <applet>:

<applet code="MyApplet.class" hspace=0 vspace=0 width=150 height=150>

Usuarios de Frontpage:

Aquí encontrará un ejemplo de los pasos para configurar el applet Anfy Water:

1) Si aún no dispone de una imagen, utilice el Image Composer (Herramienta de FrontPage) para crear la imagen y grábela como "water.gif", por ejemplo, en una carpeta nueva y vacía.

2) En la pantalla principal de Anfy Java wizard seleccione WATER, pulse sobre el botón NEXT cuatro veces, y utilice la función para publicar: "Copy all files to" para grabar todos los ficheros necesarios en la nueva carpeta.

3) Abra FrontPage: en el Explorer de FrontPage, importe los applets de Java, incluyendo anwater.html, anfy.class, AnWater.class , Lware.class, y waterscr.txt. En otras palabras, estos ficheros deben estar presentes en la misma carpeta (directorio) como los documentos html que editará más adelante.

4) En el Editor de FrontPage, abra anwater.html, después seleccione el applet y haga click en botón copiar de la barra de herramientas.

5) Abra una nueva página web, o el documento en el que necesite insertar el applet, y haga click en el botón pegar de la barra de herramientas.

Un camino rápido podría ser:

4) Abra FRONTPAGE.
5) Abra la web que desee.
6) Arrastre el fichero sobre la web abierta
7) Haciendo click en la página web dentro del editor se abrirá con el applet ya colocado, y usted puede continuar la edición. Haga click en JBAR del applet para ajustar la configuración.

Así podría configurarse el applet para trabajar. Si necesita cambiar los parámetros, haga doble click en el Applet y abra la caja "Java Applet Properties" (Propiedades del Applet de Java).
Puede que aparezcan problemas con el directorio del servidor debido a que FrontPage requiere al servidor de web y le fuerza a que usted importe la librería .class dentro de la web.
Si copia estos ficheros en los directorios de la web, entonces tiene que colocarlos en el lugar correcto y seleccionar "Recalculate Hyperlinks" (Actualizar vínculos) en el Explorador. Después, debe asegurarse de que los parámetros de los applets apuntan al applet correctamente.

Nota: para cambiar el "scrolltext" (texto que se desplaza) debe modificarse el contenido del fichero waterscr.txt.

Errores documentados:

- No grabe imágenes .JPG desde Adobe Photoshop 4 con la opción "thumbnail" (miniatura) activada porque algunas implementaciones de Java (Netscape 3) no serán capaces de leerlas. Desactive la opción "thumbnail" (miniatura) o use Photoshop 3.

- MS Explorer 3.02 (y algunas de las versiones beta del 4.0) tienen un error que provoca un exception: com.ms.applet.Security.Couldn`t connect cuando Java descarga las imágenes desde el disco duro local.
Los applets funcionará correctamente cuando estén on-line, pero le costará trabajo verificar el applet off-line, a menos que utilice una versión nueva o más antigua (3.01 o 4.0, por ejemplo)
La URL para actualizar el Explorer es http://www.microsoft.com/java/vm/vmdownload.htm.

Parámetros de Compatibilidad:

PRELIMINARES: Alguna gente cree que Java es peligroso, inseguro y que puede dañar muchos navegadores. Esto es cierto para applets mal programados, páginas sobrecargadas con 10 applets y en ordenadores antiguos.
Si usted utiliza los applets Anfy Java con la configuración "Optimize for compatibility", NO INSTALE MAS DE UN APPLET en cada página html, así evitará que los navegadores puedan sufrir daño.

Qué hago si los JAVA APPLET usan el 100% de la capacidad de mi CPU, ralentizan el funcionamiento del navegador o se apoderan de toda mi memoria disponible?

A) Cuando los applets están funcionando, Netscape o Explorer pueden funcionar lentamente y, en ocasiones, el sistema operativo (Win95, WinNT, MacOS etc.) puede "colgarse" o funcionar inadecuadamente.

Si sucede esto, puede usted incrementar el parámetro MinSYNC hasta que el sistema funcione normalmente. Generalmente, este valor está ajustado a 10, pero puede aumentarse a 20, 40, 60, 100 o incluso más para disminuir la velocidad del applet liberando de este modo capacidad de la CPU, del navegador y del sistema operativo. También se puede disminuir el parámetro "priority".

B) Cuando los applets han estado funcionando algunos segundos o minutos la memoria puede acabarse y el disco duro comenzará a girar (esto sucede porque el Sistema Operativo usa el disco duro como fichero de intercambio para simular más memoria)

Cuando pasa esto, es que, probablemente esté usted usando una versión de Netscape 3 / MS Explorer 3 con w/errores. Este problema no aparece en las versiones revisadas 3 y 4, pero puede solucionarse disminuyendo el retraso de acceso a memoria (memdelay) a 10-16:

Anfy Java wizard proporciona 3 configuraciones predefinidas en el "expert mode panel": Las configuraciones estándar establecerán MinSYNC en 10 y la prioridad en 3, lo que resulta adecuado para el 99% de los navegadores.

Si usted quiere estar seguro de que el applet funcionará incluso en versiones de Explorer y Netscape con errores y no le preocupa que los applets funcionen mucho más despacio, seleccione "Optimize for compatibility". De este modo, establecerá la configuración MinSYNC en 30, la prioridad en 1 y el retraso en acceso a memoria en 15.

Si prefiere que los applets funcionen a su máxima potencia, y no le importa el impacto que pueda tener sobre navegadores antiguos o que la CPU reduzca gravemente su rendimiento, seleccione "Optimize for speed". Así establecerá el valor MinSYNC en 2 y la prioridad en 6..

Es posible establecer manualmente MinSYNC en 0 y prioridad en 10 , para aquellos que quieran probar el applet a toda velocidad en un P200MMX o Pentium II.

Recuerda la norma más importante:

NO INSERTE MAS DE UN APPLET EN CADA PAGINA

Si verdaderamente NECESITA colocar más de un applet por página (¡lo hace usted a su propio riesgo!) asegúrese de que establece el parámetro de prioridad en 5 para todos los applets. Si prefiere que alguno funcione a más velocidad que los otros, cambie su prioridad hasta conseguir la velocidad deseada.

Algún otro problema?

Si es usted usuario Anfy Java registrado (en otras palabras, si ha comprado usted por lo menos un código de registro) y está sufriendo un problema técnico que no esté descrito en este documento, puede realizar una consulta gratuita a anjsupp@anfiteatro.it.

Nota:el soporte gratuito (sólo en inglés) está garantizado solamente para usuarios registrados y, por favor, asegúrese de haber leído primero la FAQ SOLUCION DE PROBLEMAS y así evitará preguntar por cuestiones que ya han sido contestadas.