Geek & Roll

Ver primera parte: Intro

En la introducción se vió un poco sobre lo que es programar una aplicación para la BlackBerry haciendo un pequeño “Hola Mundo” muy sencillo. Ahora toca explicar las bases de la aplicación que se menciona en aquel post llamada “Everlasting Flame”. El nombre es el título de una canción del grupo de Thrash Aleman Kreator. Tengo la mala costumbre de nombrar a todos mis proyectos con titulos de canciones metaleras.

Primero un poco de teoría. Las aplicaciones de BlackBerry pueden ser de dos tipos: sin GUI o con GUI. Típicamente el punto de entrada de las que tienen GUI es cuando el usuario selecciona el ícono correspondiente en la pantalla. Las que no tienen GUI generalmente cuentan con otro punto de entrada, como al momento de hacer una llamada telefónica, enviar un SMS, solicitar datos, etc. En nuestro caso nuestra aplicación es sin GUI y su punto de entrada es al momento de realizar una llamada telefónica.

En el API de RIM hay dos clases que nos interesan actualmente: Applicationy UiApplication para aplicaciones sin UI o con UI, respectivamente. También nos interesa el PhoneListener que nos sirve para registrar una clase que consume los eventos generados por la aplicación de teléfono en la BlackBerry. También nos interesa la clase Phone que nos permite interactuar con la aplicación que se encarga de marcar el teléfono en la BlackBerry.

Como se mencionó en el post de introducción, el funcionamiento es el siguiente: marco un número e inicia un contador. Si llego a un determinado número de segundos (soft limit) el teléfono me avisa inyectando un tono DTMF a la llamada. Si llego a otro límite mayor (hard limit) la llamada se termina automáticamente. Para esto vamos a usar las clases antes mencionadas.

Nuestro programa consta básicamente de 2 clases: la clase principal que extiende a Application, y una clase que implementa la interfaz PhoneListener, o más específicamente extiende a AbstractPhoneListener, misma que implementa a PhoneListener y nos evita el tener que implementar todos los métodos abstractos de PhoneListener, enfocándonos solo a aquellos que necesitamos.

El contenido de la clase principal, EverlastingFlame.java:


package com.divinesoft.blackberry.everlastingflame;

public static void main(String[] args) {
System.out.println("On Endless main");
EverlastingFlame ef = new EverlastingFlame();
ef.enterEventDispatcher();
}
}


Esta clase extiende a Application y tan solo declara su constructor y el punto de entrada de la aplicación. En el punto de entrada crea una nueva instancia de la aplicación y entra al ciclo de despacho de eventos ejecutando el método enterEventDispatcher. Esto es necesario para que se ejecute el código que se encarga de responder a eventos. El constructor crea un nuevo objeto CustomPhoneListener (del cual veremos el código a continuación) y lo registra mediante un método estático ante la clase Phone para recibir eventos del teléfono.

La clase CustomPhoneListener:


package com.divinesoft.blackberry.everlastingflame;

}


Esta clase extiende a AbstractPhoneListener y lo que hace es definir qué sucede cuando se ejecutan ciertos eventos del teléfono. Su constructor recibe ambos límites como parámetros y los inicializa. Al conectarse una llamada (callConnected) se inicializa un objeto Timer. A este objeto Timer se le registra un objeto TimerTask, que es el que nos sirve para ejecutar una tarea recurrente. En este caso TimerTask es un objeto que en su método run lo que hace es incrementar un contador y comprar su actual valor con el softlimit o el hardlimit, llamando al método necesario para tomar la acción adecuada.

Como podemos observar, nos interesa contar segundos, y es por esto que registramos el TimerTask que suceda sin delay (primer argumento) y cada 1000 milisegundos (segundo argumento). Cada segundo se ejecuta el método run del TimerTask registrado. Al desconectarse la llamada se ejecuta callDisconnected, se detiene el objeto Timer y se pone a 0 el contador para iniciar de nuevo cuando se vuelva a realizar otra llamada. Los métodos injectDTMFTone e injectEndCall hacen exactamente lo que su nombre indica.

Como ven, es bastante sencillo agregar esta funcionalidad a la BlackBerry. En este caso falta explicar cómo se guardan las opciones del usuario y una GUI para configurar la aplicación.