MIDP API简要介绍

    * 介绍

      移动信息设备简表 (MIDP) 适合类似于蜂窝电话和寻呼机这样的设备。MIDP,就象 KJava 一样,同样也建立在 CLDC 之上。MID 简表提供一种标准的运行时环境,允许在终端用户设备上动态地配置新的应用程序和服务。

      在本章中,我们将详细地讨论 MID 定义的七个软件包。我们还将建立一个 MIDP 应用程序示例。

 
    * UI 设计注意事项

      MIDP 包括一个低级的 UI API 和一个高级的 UI API。低级的 API 允许您完全访问一个设备的显示屏,也允许访问原始键和指针事件。然而,使用低级 API 时, 没有可用的用户界面控件。应用程序必须精确地绘制出按钮和其它所有的控件。

      相反,高级 API 提供简单的用户界面控件但不能直接访问原始的输入事件或显示屏。由于显示屏的尺寸和 MIDP 设备输入方法的差异,控件显得很抽象。MIDP 的实现确定了绘制控件的方法,也确定了如何管理用户输入。

      让我们在后面的章节里更进一步了解 MIDP 的软件包和类。

    * MIDP API

      MIDP 包含四个核心 CLDC 软件包 (java.lang、java.io、java.util 和 javax.microedition.io),另加下面的三个特定于 MIDP 的软件包:

      · javax.microedition.lcdui

      · javax.microedition.midlet

      · javax.microedition.rms

      我们将在本章的后面部分详细介绍特定于 MIDP 软件包。除了上面新的软件包之外,MIDP 还向核心 CLDC 软件包添加了四个新类,如下所示。

      · java.util.Timer — 用于为后台线程中将来要执行的任务确定时间。

      · java.util.TimerTask — 被 java.util.Timer 类使用,用来为后台线程中稍后的执行定义任务。

      · javax.microedition.io.HttpConnection — 一个接口,为 HTTP 连接定义必要的方法和常量。

      · java.lang.IllegalStateException — 一个 RuntimeException, 指出在不合法或不合适的时间已经调用的一个方法。

    * MIDlet 介绍

      MIDlet 是一个 Java 类,它扩展了 javax.microedition.midlet.MIDlet 抽象类。实现 startApp()、pauseApp()和 destroyApp()方法,这些方法类似于 J2SE 的 java.applet.Applet 类中的 start()、stop()和 destroy()方法。

      除了扩充 javax.microedition.midlet.MIDlet 的主 MIDlet 类之外,一个 MIDP 应用程序通常还包括其它一些类,这些类能随它们的资源一起被打包成为 jar 文件 — 称之为 MIDlet 套件。一个 MIDlet 套件中的不同 MIDlet 能共享 jar 文件的资源,尽管不同套件中的 MIDlets 不能直接相互作用。

      MIDlet 在应用程序生命周期中有三种可能的存在状态 — 运行状态、暂停状态、销毁状态。运行状态,正如其名称所暗示的,意味着 MIDlet 正在运行中。这种状态始于 startApp 方法被调用时。在暂停状态中,MIDlet 持有的所有资源将被释放,但是它准备着再次被运行。调用 notifyPaused 方法时,MIDlet 处于暂停状态。在销毁状态中,MIDlet 已经永久地将其自身关闭,释放所有的资源,等待着废物清理程序的处理。它是通过 notifyDestroyed 方法来调用的。

      在接下来的两页中,我们来看一个简单的 HelloWorld MIDlet。

    * HelloWorld MIDlet

      与使用 KJava HelloWorld 应用程序一样,这个 MIDlet 也会在 MIDP 设备的显示屏上显示 "Hello World!" 和 Exit 按钮,按下该按钮会终止应用程序。

      HelloWorld.java 文件以下面的代码行开始,这些代码行导入稍后会在 HelloWorld 类中使用的类:

      import javax.microedition.midlet.MIDlet;

      import javax.microedition.lcdui.Command;

      import javax.microedition.lcdui.CommandListener;

      import javax.microedition.lcdui.Display;

      import javax.microedition.lcdui.Displayable;

      import javax.microedition.lcdui.Form;

      由于 HelloWorld 类是一个 MIDP 应用程序,它扩展了 MIDlet。它也实现 CommandListener 接口来处理事件:

      public class HelloWorld extends MIDlet implements CommandListener

      下面的方法是一个缺省构造程序,它创建一个新表单,在上面初始化控件,然后显示出来: 

private Form form;
public HelloWorld() {
   // Create a new form on which to display our text
   form = new Form("Test App");
   // Add the text "Hello World!" to the form
   form.append("Hello World!");
   // Add a command button labeled "Exit"
   form.addCommand(new Command("Exit", Command.EXIT, 1));
   // Register this object as a commandListener
   form.setCommandListener(this);
}

      调用 startApp() 方法启动应用程序与小应用程序的启动方法很象。在 MIDle 的一次执行中它可能会被调用多次。如果 MIDlet 暂停,pauseApp() 将会被调用。要重新启动 MIDlet,需调用 startApp()。仅须执行一次的主初始化代码应该放置在构造程序中: 

public void startApp() {
   // Get a reference to the display, and show the form
   Display display = Display.getDisplay(this);
   display.setCurrent(form);
}

      pauseApp() 被调用使得 MIDlet 处于暂停状态。在此应用程序中,当进入暂停状态时,我们没执行任何操作;但是我们仍然需要在 MIDlet 中实现 pauseApp 方法,因为它是父 MIDlet 类中的抽象方法。

      public void pauseApp() { }

      destroyApp() 被调用,破坏了 MIDlet 并使其处于销毁状态。在此应用程序中,我们通过将引用设为 null,释放了对表单的引用。 

public void destroyApp(boolean unconditional) {
   form = null;
}

      commandAction() 方法是事件处理程序,被请求实现 CommandListener 接口。目前,它破坏了应用程序并通知应用程序管理软件 MIDlet 已经完成。 

public void commandAction(Command c, Displayable d) {
   // Destroy this MIDlet
   destroyApp(true);
   // Notify the application management software that this MIDlet
   // has entered the destroyed state
   notifyDestroyed();
}

    * MIDP 软件包

      除标准 CLDC 软件包之外,MIDP 还包含三个附加的软件包:

      · javax.microedition.lcdui — 定义用来控制 UI 的类。这个软件包既包含高级 UI 类(例如 Form、Command、DateField 和 TextField 等),又包含低级 UI 类(允许用低级方式控制 UI)。

      · javax.microedition.midlet — 包含 MIDP 主类中的一个,MIDlet 类,为 MIDP 应用程序提供访问关于其运行所在环境信息的权限。

      javax.microedition.rms — 定义一个类的集合,这些类为 MIDlet 提供了永久存储并随后重新得到数据的机制。