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 提供了永久存储并随后重新得到数据的机制。