Decidir qué Parámetros Soportar
Esta página nos guía a través de las cuatro preguntas que deberíamos responder cuando implementemos parámetros:
Termina con una explicación de los parámetros definidos por una clase de ejemplo llamada AppletButton.
¿Qué debería un Applet permitir que el usuario configurara?
Los parámetros que nuestro applet debería soportar dependen de lo que haga y de cómo queramos que sea de flexible. Los applets que muestran imágenes podrían tener un parámetro para especificar las localizaciones de las imágenes. Deforma similar, los applets que ejecutan sonidos, podrían tener parámetros para especificar los sonidos.
Junto con los parámetros que especifican localizaciones de recursos (como ficheros de imagen y sonido), algunas veces los applets proporcionan parámetros para especificar detalles de la operación o de la apariencia del applet. Por ejemplo, un applet de animación, podría permitir que el usuario especifique el número de imágenes por segundo a mostrar. O un applet podría dejar que el usuario modifique los textos que muestra el applet. Todo es posible.
¿Cómo deberían llamarse los Parámetros?
Una vez que hemos decidido que parámetros va a soportar nuestro applet, necesitamos imaginarnos sus nombres. Aquí tenemos algunos nombres típicos de parámetros:
- SOURCE o SRC
- Para ficheros de datos como un fichero de imagen.
- XXXSOURCE (por ejemplo, IMAGESOURCE)
- Usado en applets que permiten que el usuario especifique más de un tipo de ficheros de datos.
- XXXS
- Para un parámetro que toma una lista de XXXs (donde XXX podría ser IMAGE, por ejemplo).
- NAME
- Usado sólo para el nombre del applet.
Los nombres de los applets se utilizan para comunicarse unos con otros como se describió en Enviar Mensajes a Otros Applets.
La claridad de los nombres es más importante que su longitud. No debemos usar nombres de atributos de la etiqueta <APPLET>, que se documentan en
La Etiqueta <APPLET>.
|
Nota:
Aunque este tutorial se refiere a los nombres de parámetros usando TODO MAYÚSCULAS, éstos no son sensibles a las mayúsculas. Por ejemplo, IMAGESOURCE y imageSource se refieren al mismo parámetro. Por otro lado, los valores de los parámetros si son sensibles a las mayúsculas, a menos que realicemos los pasos necesarios para intepretarlos de otra forma, como usando el método String toLowerCase antes de interpretar el valor del parámetro.
|
¿Qué tipo de Valor debería Aceptar cada Parámetro?
Todos los valores de parámetros son strings. No importa si el usuario pone comillas o no alrededor del valor de parámetro, el valor pasado al applet es un string. Sin embargo, nuestro applet puede interpretar el string de muchas formas:
Normalmente los applets interpretan un valor de parámetro como uno de los siguientes tipos:
- Una URL
- Un integer
- Un número en coma flotante
- Un valor booleano -- normalmente "true"/"false" o "si"/"no"
- Un string -- por ejemplo, el texto usado como título para la ventana.
- Una lista de los de arriba.
¿Qué valor por Defecto Debería Tener cada Parámetro?
Los Applets deberían intentar proporcionar valores útiles por defecto para cada parámetro, para que el applet se pueda ejecutar incluso si el usuario no especifica ningún parámetro o los especifia incorrectamente. Por ejemplo, un applet de animación debería proporcionar una selección razonable para el número de imágenes que debe mostrar por segundo. De esta forma, si el usuario no especifica el parámetro importante, el applet aún funcionará bien.
Un ejemplo: AppletButton
A lo largo de esto tutorial, los applets que necesitan traer ventanas usan la clase AppletButton que es altamente configurable.
|
Nota:
Si estás usando 1.1 o 1.2, deberías mirar la versión Swing de AppletButton.java.
|
La clase AppletButton es tan flexible porque define parámetros que permiten al usuario especificar lo siguiente:
- El tipo de la ventana a mostrar
- El título de la ventana
- La altura de la ventana
- La anchura de la ventana
- La etiqueta para el botón que trae la ventana.
Aquí tenemos una etiqueta <APPLET> para AppletButton. Puedes ver este applet en la página Usar Controladores de Distribución.
<APPLET CODE=AppletButton.class CODEBASE=example
WIDTH=350 HEIGHT=60>
<PARAM NAME=windowClass VALUE=BorderWindow>
<PARAM NAME=windowTitle VALUE="BorderLayout">
<PARAM NAME=buttonText
VALUE="Click here to see a BorderLayout in action">
</APPLET>
Cuando el usuario no especifica un valor para un parámetro, AppletButton usa un valor por defecto razonable. Por ejemplo, si el usuario no especifica el título de la ventana,
AppletButton usa el tipo de la ventana como título.
La página siguiente nos enseña el código que usa AppletButton para obtener lo valores de sus parámetros.
Tutoriales
