• Los dispositivos que trabajan en conmutación de circuitos necesitan conexiones basadas en flujo de bits, como por ejemplo el protocolo TCP.


• Los dispositivos que trabajan en conmutación de paquetes necesitan conexiones basadas en datagramas así que requerirán conexiones como las que ofrece el protocolo UDP.


• Habrá dispositivos con mecanismos específicos de conexión.

Figura 1: Jeraquía de Intefaces del CLDC Generic Connection Framework

• El interfaz Connection es el tipo básico de conexión. Esta conexión sólo puede abrirse y cerrarse.



• El interfaz InputConnection representa un dispositivo desde el que se pueden leer datos. Proporciona el método openInputStream que devuelve un stream de entrada para la conexión.



• El interfaz OuputConnection representa un dispositivo en el que se pueden escribir datos. Proporciona el método openOutputStream que devuelve un stream de salida para la conexión.



• El interfaz StreamConnection que combina la conexiones de entrada y de salida anteriores.



• El interfaz ContentConnection que es una subinterfaz de StreamConnection. Proporciona acceso a información de algunos meta datos proporcionados en una conexión HTTP.



• El interfaz StreamConnectionNotified que espera a que se establezca una conexión. Devuelve un StreamConnection a través del cual puede establecerse un enlace de comunicación bidireccional.



• El interfaz DatagramConnection que representa el destino de un datagrama.



• El interfaz HttpConnection



• El interfaz HttpsConnection (http seguro)



• El interfaz CommConnection, conexiones por puerto serie.



• El interfaz SocketConnection



• El interfaz SecureConnection (sockets seguros)



• El interfaz ServerSocketConnection



• El interfaz UDPDatagramConnection

• open(String name): crea y abre una conexión con la URL especificada.



• open(String name,int mode): crea y abre una conexión con la URL especificada con un determinado modo de acceso.



• open(String name,int mode,boolean timeouts): crea y abre una conexión con la URL especificada con un determinado modo de acceso y especificando si el usuario desea que se produzcan excepciones de timeout.



• openDataInputStream(String name)/ openDataOutputStream(String name): crea y abre una conexión para un flujo de datos de entrada / salida.



• openInputStream(String name)/ openOutputStream(String name): crea y abre una conexión para un flujo de datos de entrada / salida.



El parámtero String name que aparece en la definición de los métodos tiene el formato "protocol:address;parameters".

Algunos ejemplos de utilización de estos métodos:


• Conexión HTTP:

  Connector.open("http://www.it.uc3m.es/pervasive");
  

• Conexión por datagramas:

  Connector.open("datagram://address:port#");
  

• Conexión por Sockets:

  Connector.open("socket://address:port#");
  

• Conmunicación con puerto serie:

  Connector.open("comm:0;baudrate=9600");
  

• Acceso a ficheros:

  Connector.open("file:/miFichero.txt");
  

• "Setup": No se ha establecido todavía la conexión.



• "Connected": Se ha establecido la conexión, la petición se ha enviado y se está esperando por una respuesta.



• "Closed": La conexión se ha cerrado.

• setRequestMethod(String method) que establece el método de la petición, que puede ser POST, GET o HEAD. El método por defecto es GET y si el método no es HTTP o la implementación de HTTP está recortada y no lo soporta, se produce una IOException.



• setRequestProperty(String key, String value) que permite indicar el valor de algunas propiedades HTTP antes de enviar la petición, la propiedad que se quiere establecer se indica en el parámetro key y su valor se establece en el parámetro value.

HttpConnection c = (HttpConnection)Connector.open("http://www.it.uc3m.es/pervasive");
c.setRequestMethod(HttpConnection.POST);
c.setRequestProperty("User-Agent", "Profile/MIDP-2.0 Configuration/CLDC-1.0");

• openInputStream ()



• openOutputStream()



• openDataInputStream()



• openDataOutputStream()



• getLength()



• getType()



• getDate()



• getExpiration()

• getURL()



• getProtocol()



• getHost()



• getPort()



• close()

import java.io.*;
import javax.microedition.midlet.*;
import javax.microedition.io.*;
import javax.microedition.lcdui.*;

/**
 * Un ejemplo de MIDlet para visualizar el contenido de una URL
 * utilizando la implementación del interfaz HttpConnection.
 */

public class MIDletHTTPExample extends MIDlet {

  private Display display;
  private String url = "http://www.it.uc3m.es/celeste/docencia/cr/hola.txt";

  public MIDletHTTPExample() {
    display = Display.getDisplay(this);
  }

  /**
   * Método startApp()
   */
  public void startApp() {
    // Llama al método download para descargar el contenido de la URL
    try {
      download(url);
    } catch(IOException e) {
      System.out.println("IOException: " + e);
    }
  }

  private void download (String url) throws IOException {
    StringBuffer b = new StringBuffer();
    InputStream is = null;
    HttpConnection c = null;
    TextBox t = null;
	
    try {
      long len = 0 ;
      int ch = 0;

      // Abre una conexión del tipo HttpConnection
      c = (HttpConnection)Connector.open(url);
      
      // Obtiene un stream de entrada, para leer el contenido de la url
      // con la que establece la conexión
      is = c.openInputStream();
      
      // Lee hasta que se cierra la conexión
      while ((ch = is.read()) != -1) {
        b.append((char)ch);
      }
      
      // Se contruye un TextBox con el contenido de la URL
      t = new TextBox("Hola...", b.toString(), 1024, 0);

    } finally {
      // Se cierra tanto el stream de entrada
      if (is != null)
        is.close();
      // Se cierra la conexión
      if (c != null) 
        c.close();
    }  
    
    // Se visualiza el TextBox en el Display
    display.setCurrent(t);
  }
  
   /**
    * pauseApp
    */
   public void pauseApp() {
   }

   /**
    * destroyApp
    */
   public void destroyApp(boolean unconditional) {
   }
}

• getCipherSuite(): devuelve un String con el nombre del sistema de cifrado que se está utilizando.



• getProtocolName(): devuelve el protocolo seguro al que pertenece la conexión.



• getProtocolVersion(): devuelve la versión utilizada del protocolo seguro.



• getServerCertificate(): devuelve el certificado (objeto Certificate) utilizado para establecer la conexión segura.

Ejemplo:
	

  // obtener el objeto SecurityInfo asociado a una conexion segura

  SecurityInfo secInfo = conexionSegura.getSecurityInfo();

  // Extraer informacion de seguridad

  String cipherSuite = secInfo.getCipherSuite();
  String protocol = secInfo.getProtocolName();
  String version = secInfo.getProtocolVersion();
  Certificate certificado =  secInfo.getServerCertificate();	
	

comm:< identificador del puerto >[< parámetros opcionales >]

Parametro	Valor por defecto	Descripción
baudrate	depende de la plataforma	Define la velocidad de transferencia de bits.
bitsperchar	8	Numero de bits por caracter (7 ó 8).
stopbits	1	Numero de bits de parada por caracter (1 ó 2)
parity	ninguna	Control de errores por paridad. Puede ser par(even), impar(odd), o ninguna(none)
blocking	on	Se espera (on) o no (off) a tener el fuffer de entrada lleno para leer
autocts	on	Se espera (on) o no (off) a que la línea CTS esté activada antes de escribir
autorts	on	Con on actviva la línea RTS cuando el buffer de entrada no está lleno. Con off la línea RTS está siempre activada.

Tanto para establecer la conexión como para especificar los parámetros opcionales que se deseen utilizaremos el método open() de la clase Connector. Para ello el String que pasaremos como argumento debe tener el formato adecuado o de lo contrario se producirá una IllegalArgumentException.

Para trabajar con conexiones por puerto serie se implementan, además de los métodos heredados de las interfaces Connection, InputConnection y OutputConnection, dos métodos adicionales:

• getBaudRate(): devuelve la tasa de transferencia de la conexión.
• setBaudRate(int baud_rate): permite fijar la tasa de transferencia de la conexión. Si el valor especificado no es válido el sistema fijará un valor.

Ejemplo:
			
  SocketConnection socket = (SocketConnection)Connector.open("socket://< host >:< port >"); 

• getAddress(): devuelve la dirección remota con la que se ha establecido la conexión.
• getLocalAddress(): devuelve la dirección local en la que se ha establecido la conexión.
• getLocalPort(): devuelve el puerto local dónde se encuentra establecido el socket.
• getPort(): devuelve el puerto remoto en el que se estableció el socket.
• getSocketOption(byte option): devuelve el valor de la opción especificada.
• setSocketOption(byte option, int value): fija el valor de la opción especificada.

Ejemplo:
			
  SecureConnection secureSocket = 
    (SecureConnection)Connector.open("ssl://< host >:< port >"); 

• getSecurityInfo(): devuelve un objeto SecurityInfo con la información relativa a la seguridad asociada a una conexión segura.

  Ejemplo:

    SocketConnection socket = (SocketConnection)serverSocket.acceptAndOpen();

  ServerSocketConnection serverSocket = (ServerSocketConnection)Connector.open("socket://:< port number >");

  ServerSocketConnection serverSocket = (ServerSocketConnection)Connector.open("socket://");

• getLocalAddress(): devuelve la dirección local en la que se ha establecido el socket.
  Esta es la dirección IP a la que otros terminales deben solicitar el establecimiento de un socket tal y como se explicó anteriormente. Dado que las direcciones IP pueden ser asignadas dinámicamente habrá que prestar atención en este aspecto e implementar aplicaciones robustas frente a cambios de la dirección IP del socket servidor.
  
  ATENCIÓN: Para acceder a la dirección IP de la máquina local se puede utilizar System.getProperty("microedition.hostname").



• getLocalPort(): devuelve el número de puerto local en el que se ha establecido el socket.

Ejemplo:

  UDPDatagramConnection UDPDat = (UDPDatagramConnection)Connector.open("datagram://< host >:< port >");

• getLocalAddress(): devuelve la dirección local en la que se ha establecido la conexión por datagramas.
• getLocalPort(): devuelve el puerto local sobre el que se ha establecido la conexión por datagramas.

• Activación causada por conexiones de red entrantes (gracias a que MIDP 2.0 implementa nuevos interfaces de conexión como TCP, datagramas UDP e incluso SMS).
• Activación causada por temporizadores.

Figura 2: Modelo de ciclo de vida de un MIDlet

Figura 3: Elementos típicos del Push Registry

• Registros estáticos - Registrar conexiones estáticas, es decir, las que sabemos con toda seguridad que se producirán y que son imprescindibles para el buen funcionamiento del MIDlet.
• Registros dinámicos - Registrar conexiones dinámicas (las que pueden establecerse, o no, a lo largo de la ejecución del MIDlet) y alarmas. Ésta es la única manera de registrar los temporizadores asociados a un MIDlet.


Cada uno de estas dos maneras de registrar "eventos activadores" del MIDlet son tratadas con más detalle a continuación.

  MIDlet-Push-< n >: < ConnectionURL >, < MIDletClassName >, < AllowedSender >

  Ejemplo: 

    MIDlet-Push-1: socket://:79, com.sun.example.SampleChat, * 
    MIDlet-Push-2: datagram://:50000, com.sun.example.SampleChat, *