org.openuat.apps.j2me
Class BedaMIDlet

java.lang.Object
  javax.microedition.midlet.MIDlet
      org.openuat.apps.j2me.BedaMIDlet

All Implemented Interfaces:

AuthenticationProgressHandler

public class BedaMIDlet
extends javax.microedition.midlet.MIDlet
implements AuthenticationProgressHandler

This MIDlet demonstrates the different button channels within the OpenUAT toolkit on the J2ME platform. Most of the channels are described in 'BEDA: Button-Enabled Device Association' by C. Soriente and G. Tsudik. However, there are possibly additional channels implemented here.

Version:

1.0

Author:

Lukas Huser

Constructor Summary

BedaMIDlet()
Creates a new MIDlet.

Method Summary

void	AuthenticationFailure(java.lang.Object sender, java.lang.Object remote, java.lang.Exception e, java.lang.String msg) Upon authentication failure, an exception might have been thrown and a message might have been created.
void	AuthenticationProgress(java.lang.Object sender, java.lang.Object remote, int cur, int max, java.lang.String msg) This event is raised during the authentication protocol to indicate progress.
boolean	AuthenticationStarted(java.lang.Object sender, java.lang.Object remote) This event is raised when the authentication protocol is started, to indicate that further events might follow.
void	AuthenticationSuccess(java.lang.Object sender, java.lang.Object remote, java.lang.Object result) Upon successful authentication, the established shared key can be used with the remote host.
protected void	destroyApp(boolean unconditional) Destroys this MIDlet.
protected void	pauseApp() Pauses this MIDlet.
protected void	startApp() Starts this MIDlet.

Methods inherited from class javax.microedition.midlet.MIDlet

checkPermission, getAppProperty, notifyDestroyed, notifyPaused, platformRequest, resumeRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BedaMIDlet

public BedaMIDlet()

Creates a new MIDlet. Used for one-time initializations.

Method Detail

destroyApp

protected void destroyApp(boolean unconditional)
                   throws javax.microedition.midlet.MIDletStateChangeException

Destroys this MIDlet. Frees resources first.

Specified by:

destroyApp in class javax.microedition.midlet.MIDlet

Parameters:

unconditional -

Throws:

javax.microedition.midlet.MIDletStateChangeException

pauseApp

protected void pauseApp()

Pauses this MIDlet. Frees resources first.

Specified by:

pauseApp in class javax.microedition.midlet.MIDlet

startApp

protected void startApp()
                 throws javax.microedition.midlet.MIDletStateChangeException

Starts this MIDlet. MIDlet initialization is done here.

Specified by:

startApp in class javax.microedition.midlet.MIDlet

Throws:

javax.microedition.midlet.MIDletStateChangeException

AuthenticationFailure

public void AuthenticationFailure(java.lang.Object sender,
                                  java.lang.Object remote,
                                  java.lang.Exception e,
                                  java.lang.String msg)

Description copied from interface: AuthenticationProgressHandler

Upon authentication failure, an exception might have been thrown and a message might have been created.

Specified by:

AuthenticationFailure in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

e - Reason for the failue, can be null.

msg - Reaseon for the failue, can be null

AuthenticationProgress

public void AuthenticationProgress(java.lang.Object sender,
                                   java.lang.Object remote,
                                   int cur,
                                   int max,
                                   java.lang.String msg)

Description copied from interface: AuthenticationProgressHandler

This event is raised during the authentication protocol to indicate progress.

Specified by:

AuthenticationProgress in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed.

cur - The current stage in the authentication.

max - The maximum number of stages.

msg - If not null, a message describing the last successful stage.

AuthenticationStarted

public boolean AuthenticationStarted(java.lang.Object sender,
                                     java.lang.Object remote)

Description copied from interface: AuthenticationProgressHandler

This event is raised when the authentication protocol is started, to indicate that further events might follow.

Specified by:

AuthenticationStarted in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed. Depends on the sender of the event.

Returns:

true if the handler accepts this authentication to be started, false to "veto" it. If any of the registered handlers (which are called in the order in which they were registered) returns false, the (incoming or outgoing) authentication is aborted.

AuthenticationSuccess

public void AuthenticationSuccess(java.lang.Object sender,
                                  java.lang.Object remote,
                                  java.lang.Object result)

Description copied from interface: AuthenticationProgressHandler

Upon successful authentication, the established shared key can be used with the remote host. The type of the remoteHost object depends on the sender of the event, e.g. an InetAddress object for HostProtocolHandler generated events, but an Integer for DongleProtocolHandler generated events (encapsulating the remote relate id).

Specified by:

AuthenticationSuccess in interface AuthenticationProgressHandler

Parameters:

sender - The object which sent this event.

remote - The remote end with which the authentication is performed. Depends on the sender of the event.

result - The result, if any, of the successful authentication. This can e.g. be a shared key or a set of keys or can even be null if the authentication event is enough to signal successful authentication.