icono_twiter icono Facebook
Carlos García Pérez

Técnico especialista en informática de empresa (CEU).

Ingeniero Técnico en Informática de Sistemas (UPM)

Creador de MobileTest, Haaala!, Girillo, toi18n.

Charla sobre desarrollo de aplicaciones en Android.

Ver todos los tutoriales del autor

Fecha de publicación del tutorial: 2007-05-21

Tutorial visitado 19.332 veces Descargar en PDF
J2ME Push Registry. Activación automática de MIDlets

J2ME Push Registry. Activación automática de MIDlets

En este tutorial vamos a tratar una interesante característica que tenemos disponible a partir de MIDP 2.0 para iniciar MIDlets sin la intervención del usuario. Se presupone que el lector ya posee conocimientos básicos de programación (J2ME, MIDP, CLDC), compilación e instalación de MIDLets.

Índice de contenidos

  1. Introducción.
  2. El API Push Registry
  3. Registros estáticos a través del archivo JAD
  4. Un ejemplo del uso de alarmas con Push Registry
  5. Conclusiones y reflexiones.

Introducción

Normalmente los MIDlets son iniciados (ejecutados) por intervención del usuario a través del interfaz de usuario del terminal.

Existen algunas situaciones en donde este modelo se queda cojo y es necesaria una ejecución sin necesidad de la intervención del usuario. Por ejemplo, una aplicación "Agenda" nos podría notificar automáticamente que tenemos una tarea de cumplir.

A está característica se la conoce con el nombre Push Registry.

EL API Push Registry

Push Registry forma parte del AMS (Responsable del ciclo de vida de los MIDlets) exponiendo un API para la gestión de estás activaciones.

Básicamente un MIDlet puede ser iniciado de dos formas:

  1. A través de una alarma o temporizador. (Sólo se puede registrar una por MIDLet)
  2. A través de una conexión entrante.

    Las conexiones que pueden activar MIDLets pueden ser una conexión TCP, un datagrama UDP o un SMS. La norma no especifica cuales deben ser soportadas. Es decisión de los fabricantes. (Normalmente la activación SMS si está soportada)

    A mi personalmente, las conexiónes TCP y UDP no son muy atractivas pues requieren q el terminal esté previamente conectado a Internet para tener una dirección IP, que además es dinámica.

Esta API tiene como corazón la clase javax.microedition.io.PushRegistry.

Métodos de la clase:

public static String getFilter(String connnectionString)

Devuelve el filtro <Allowed-Sender> para una determinada conexión registrada para el MIDLet.

Por ejemplo, un MIDLet podría ser activado cuando llegara un SMS a un determinado puerto. Pues bien, además puede especificarse un filtro para que sólo sea activado cuando esos SMS provengan de un determinado número de teléfono.

public static String getMIDlet(String connnectionString)

Devuelve el nombre de la clase del MIDlet responsable de tratar la conexión especificada como parámetro.

public static String[] listConnections(boolean available)

Devuelve una lista con todas las cadenas de conexión registradas por el MIDletSuite del que forma parte el MIDlet.

Si se especifica available a true, sólo se devolverán aquellas cadenas de conexión cuyo javax.microedition.io.Connection asociado tengan datos pendientes de ser tratados.

public static long registerAlarm(String midlet, long time)

Registra una alarma que activará el MIDlet.

El parámetro midlet especifica el MIDlet que debe ser activado. (Normalmente es redundante si sólo hay un MIDlet por MIDletsuite, pero bueno son lentejas.)

El parámetro time especifica el milisegundo contando a partir del 1/1/1970 en el que debe ser activado el MIDlet. (No se ni en el día que vivo como para saber de milisegundos) Usando la clase va.util.Date para facilitarte calcular el instante deseado.

Si se pasa el valor 0 en parámetro time, desregistrará la alarma.

public static void registerConnection(String connection, String midlet, String filter)

Registrar de manera dinámica una conexión.

  1. connection: Cadena de conexión en la que se registra el MIDlet.

    Ejemplos:

    sms://:6000 Cadena de conexión válida para que el MIDlet tratará los SMS dirigidos al puerto 6000 del terminal.

    datagram://:6000 Cadena de conexión válida para que el MIDlet tratará los datagramas dirigidos al puerto 6000 del terminal.

    socket://:6000 Cadena de conexión válida para que el MIDlet tratará las conexiones TCP que deseen establecerse en el puerto 6000 del terminal.

  2. midlet: Nombre de la clase del MIDlet que será activado.

    Por ejemplo, si especificamos this.getClass().getName()el estariamos registrando el MIDlet que está en ejecución.

  3. filter: Los filtros que deben cumplir los emisores de la información que activa el MIDlet.

    Por ejemplo, si especificamos *, cualquier emisor podría activar el MIDlet.

Normalmente las conexiones se registran estáticamente a través del fichero JAD o de manifest del JAR del MIDlet, es decir cuando el MIDlet es instalado en el terminal.

Las alarmas siempre deben ser registradas dinámicamente. No se puede hacer de forma estática.

public static boolean unregisterConnection(String connection)

Desregistra dinámicamente una conexión registrada para el MIDlet que lo invoca.

Devuelve true en caso de que la operación se haya realizado correctamente false en caso contrario.

El AMS desregistrará automáticamente todas los registros creados de forma estática o dinámica cuando el MIDlet sea eliminado del terminal.

¿Cómo sabemos si un MIDlet ha sido iniciado por el usuario o por un evento externo?

Pues muy fácil, debemos escribir las siguientes líneas de código en el método startApp() del MIDlet.

El código anterior NO es válido para las alarmas. De hecho no hay forma de saber mediante el API si un MIDlet ha sido iniciado mediante una alarma o mediante el interfaz de usuario.

Yo, personalmente cuando necesito saberlo, lo que hago es guardar el instante en el que debe ser activado el MIDlet en la memoria permanente del dispositivo para luego comparar en el startApp() entre con el instante actual... si son más o menos iguales (con un margen de milisegundos) es que el MIDlet fue activado con la alarma.

Registros estáticos a través del archivo JAD

Todos los MIDlets tienen asociado un descriptor (Archivo JAD, Java Archive Descriptor) en donde se definen una gran variedad de información relacionada con la aplicación útil para el terminal durante el proceso de instalación del MIDlet.
De esta manera el terminal puede, por ejemplo, rechazar la instalación del MIDlet si no posee las características mínimas necesarias para ejecutarlo.

En estos descriptores también se definen los permisos que debe de tener la aplicación para ejecutarse (MIDlet-Permissions) y también las conexiones que pueden activar el MIDlet (MIDlet-Push-n)

(El siguiente fichero JAD no representa al JAD del ejemplo.)

MIDlet-1: PushRegistryDemo,,autentia.tutoriales.pushregistry.SMSPushRegistryDemo
MIDlet-Jar-Size: 1682
MIDlet-Jar-URL: PushRegistry.jar
MIDlet-Name: PushRegistry
MIDlet-Permissions: javax.microedition.io.PushRegistry, javax.wireless.messaging.sms.send, javax.wireless.messaging.sms.receive
MIDlet-Push-1: sms://:6000,autentia.tutoriales.pushregistry.SMSPushRegistryDemo,*

MIDlet-Vendor: Carlos García. Autentia
MIDlet-Version: 1.0
MicroEdition-Configuration: CLDC-1.1
MicroEdition-Profile: MIDP-2.0

El atributo MIDlet-Push tiene el formato:    MIDlet-Push-<n>: <ConnectionURL>, <MIDletClassName>,<AllowedSender>

Algunas consideraciones:

  • Hay una relación directa entre MIDlet-n con MIDlet-Push-n. Por ejemplo MIDlet-1 está asociado con MIDlet-Push-1 y no con MIDlet-Push-2.
  • Se pueden especificar varios MIDlet-Push, incluso para el mismo MIDlet
  • <ConnectionURL>  Conexión que activará el MIDlet.
  • <MIDletClassName>  Nombre completo de la clase principal del MIDlet que tratará la petición.
  • <AllowedSender>  Especifica quienes puede activar el MIDlet. Los carácteres * y ? son válidos. Por ejemplo: 192.100.?3.*

En el ejemplo anterior el MIDlet será activado por la clase autentia.tutoriales.pushregistry.SMSPushRegistryDemo, cuando se reciban SMS en el puerto 600 sms://:6000 por parte de cualquier emisor.

Un ejemplo del uso de alarmas con Push Registry

En el siguiente ejemplo, vamos a registrar una alarma para que active el MIDlet cuando pasen 30 segundos desde que se estableció la alarma.

La siguiente clase no necesita ningún comentario especial, simplemente es la clase principal del MIDlet del ejemplo que muestra la ventana principal de la aplicación.

La siguiente clase representa la ventana principal de la aplicación, básicamente se compone de tres botones para activar y desactivar la alarma y otro para finalizar la aplicacion.

Para probar el ejemplo, establezca la alarma y rápidamente cierre la aplicación para ver que se activa automáticamente cuando transcurren 30 segundos.

Importante: Si el terminal está desconectado o el MIDlet iniciado LA ALARMA NO SALTA. Si deseas realizar tareas periódicas cuando el MIDlet este activo, puede utilizar la clase java.util.TimerTask.

Conclusiones y reflexiones.

Personalmente le veo un potencial amplísimo a esta característica, con un gran abanico de posibilidades para crear software útil, así como para ampliar los servicios que proporcionamos a nuestros clientes. Uniendo está junto con otras tecnologías como las que os presentamos desinteresadamente desde Autentia a través de tutoriales se pueden crear sistemas verdaderamente interesantes.

Aunque pueda parecer sencillo a primera vista, os animo a que practiquen y se pegen con el tema, pues desarrollar software para móviles y que este funcione correctamente tanto en un terminal de hace varios años como en uno actual no es tarea fácil. Yo, en mi formación personal en el tema, me he llevado muchas sorpresas desagradables que me han costado mucho tiempo entender y solventar.

Espero que os haya parecido interesante este tutorial.
Hasta otra.

Carlos García Pérez. Creador de MobileTest, un complemento educativo para los profesores y sus alumnos.
cgpcosmad@gmail.com

A continuación puedes evaluarlo:

Regístrate para evaluarlo

Por favor, vota +1 o compártelo si te pareció interesante

Share |
Anímate y coméntanos lo que pienses sobre este TUTORIAL:

Fecha publicación: 2010-11-01-22:38:00

Autor: cris_22

Hola, sabes que me sirvió mucho el tutorial, pero me quedan una que otra duda, quería saber si es posible comunicarte o en caso contrario te mando mi correo. gracias

Fecha publicación: 2010-10-01-19:21:20

Autor: joset

esta muy bueno el turotial nada mas una dudad como agrego los permisos dinamicament al JAD de est ejemplo para activar la alarma¿?

Fecha publicación: 2009-07-23-12:56:51

Autor:

[blanca] hola quiero mas cosa acerca de este tutorial me gusta mucho