MIDlet生命周期
1．MIDlet生命周期方法
AMS使用如下生命周期方法来控制MIDlet的状态：
Ø 默认构造器。AMS调用默认构造来执行基本的初始化工作，如设置实例变量。此时MIDlet还处在暂停（Paused）的状态，它并没有获得任何所需的资源。
Ø startApp()方法。AMS调用startApp()方法来获取MIDlet所需的资源，然后MIDlet将会处于活动（Active）状态。
Ø pauseApp()方法。AMS调用pauseApp()方法来释放MIDlet持有的任何资源。如果MIDlet创建了对象，则将对象状态存储到持久性存储器中并把对象设置为Null。如果MIDlet启动了任何线程，则停止或者暂停这些线程。
Ø destroyApp()方法。AMS调用destroyApp()方法来保存MIDlet的状态并释放MIDlet持有的任何资源。通常，一个设计良好的MIDlet应该在被关闭前进入此状态。
下面的代码框架包含了基本的生命周期方法，可以将其作为程序的模版。出色的开发工具在新建MIDlet的时候都会自动生成类似下面的框架，如Netbeans IDE。
import javax.microedition.midlet.*;
public class MyMIDlet extends MIDlet{
public MyMIDlet(){
//默认构造器
}
public void startApp(){
//进入活动状态
}
public void pauseApp(){
//进入暂停状态
}
public void destroyApp(Boolean unconditional){
//进入销毁状态
}
}
2．MIDlet的状态
用户启动MIDlet之后，被启动的MIDlet将处于应用程序生命周期中的三个状态之一。可能的状态是暂停（Paused）、活动（Active）和销毁（Destroyed）。
Ø 活动状态。当一个MIDlet进入活动状态时，它将获得用于执行任务的所有资源。转移到活动状态之后，所需的线程应该被启动。
Ø 暂停状态。当一个MIDlet进入暂停状态时，它应该释放所有持有的资源并停止活动的线程。如果有需要，则应该把数据保存到持久性存储器中，这样在程序重新进入活动状态的时候可以重用。
Ø 销毁状态。当一个MIDlet进入销毁状态时，它应该释放所有资源、停止正在执行的线程并保存持久性的数据。
MIDlet的状态如图2-17所示。
AMS控制着MIDlet在上述三种状态中的迁移，通过调用MIDlet的生命周期方法来通知应用程序。读者需要仔细参考MIDP Java doc来熟悉MIDlet的状态迁移。这里总结如下：
Ø 默认构造器。当用户启动一个MIDlet的时候，AMS创建一个新的MIDlet实例，通过调用默认构造器来执行初始化工作。当构造器返回后，MIDlet被置于暂停状态。如果在构造器执行期间抛出异常，那么MIDlet立即进入销毁状态。
Ø public void startApp()方法。在MIDlet处于暂停状态的时候，AMS调用startApp()方法指示MIDlet应该进入活动状态。startApp()方法可能会抛出MIDletState ChangeException，这个异常说明MIDlet现在不能启动，但是可能稍后会启动。如果阻止MIDlet启动的错误是短暂性的，那么你可以捕获这个异常并从错误中恢复。如果这个错误是非短暂性的，那么应该调用notifyDestroyed()方法，MIDlet进入销毁状态。
Ø public void pauseApp()方法。当MIDlet在活动状态的时候，AMS调用这个方法指示MIDlet将从活动状态进入暂停状态。
Ø public void destroyApp(boolean unconditional)方法。AMS可以在MIDlet处于活动或者暂停的时候调用这个方法，指示MIDlet将进入销毁状态。参数unconditional代表了终止请求的类型，如果unconditional为true，那么终止请求是强制执行的。如果unconditional为false，那么终止请求是可自由决定的，MIDlet可以抛出MIDletStateChangedException而持续运行。
3．控制MIDlet的状态改变
AMS控制MIDlet的状态改变，在代码执行到某一点你可能需要状态的改变。MIDlet类提供了如下三个方法来允许一个MIDlet来控制它自己的状态。
Ø resumeRequest()方法。MIDlet调用这个方法表明它本身已经准备好进入活动状态了。resumeRequest()方法调用的结果是，AMS会在何时调用MIDlet的startApp()方法。
Ø notifyPaused()方法。该方法允许MIDlet主动暂停自己。当MIDlet处于活动状态的时候，它可以调用notifyPause()方法通知AMS MIDlet已经主动进入暂停状态。在必要的时候，AMS可以调用startApp()方法重新启动MIDlet，也可以调用destroyApp()方法来终止MIDlet。
Ø notifyDestroyed()方法。该方法允许MIDlet主动销毁自己。当MIDlet处于活动状态的时候，它可以调用notifyDestroyed()方法通知AMS MIDlet已经主动进入了销毁状态。
必须注意的是，如果上述的三个通知方法被调用，那么AMS就不会再调用相应的生命周期方法。例如，如果已经调用了notifyPaused()方法，那么pauseApp()方法就不会主动被调用。也就是相关的生命周期方法应该先于通知方法之前调用。因此，我们经常在退出应用程序的代码中看到如下的方法：
public void exitMIDlet(){
try{
destroyApp(false);
notifyDestroyed();
}catch(MIDletStateChangeException ex){
ex.printStackTrace();
}
}
如果exitMIDlet()方法中只是调用notifyDestroyed()方法，那么destroyApp()方法就不会被AMS方法自动调用，这样本来由destroyApp()方法完成的销毁和状态保存工作都没有被完成。图2-18说明了MIDlet的状态控制。
2.3.3 MIDlet套件
把一组MIDlet打包到一个jar文件然后发布，这个文件称做MIDlet套件。在MIDlet套件的内部有个Manifest.mf文件用于描述MIDlet套件的内容信息，其中就包含定义MIDlet套件中的MIDlet的属性。在同一个MIDlet套件中的MIDlet可以访问同样的资源，如类和数据，他们之间共享运行环境。
从物理组织上说，MIDlet套件包含如下的内容：
Ø 一个或者多个MIDlet，它们必须是javax.microedition.MIDlet的子类；
Ø MIDlet的支持类，这些类是在CLDC和MIDP中都没有定义的，需要开发者自己创建，比如功能类等；
Ø 资源文件，如图片、文本和多媒体文件；
Ø Manifest.mf文件用于描述MIDlet套件的信息。
MIDlet类是MIDlet套件中必须包含的，因为它定义了应用程序的生命周期。多个MIDlet可以打包在一个MIDlet套件中发布，这样开发者可以一次创建多个MIDlet。
MIDP规范中要求Manifest.mf文件，这是一个文本文件。它由名称和值组成，中间由“：”分隔。下面是一个典型的Manifest.mf文件的内容。
01Manifest-Version: 1.0
Ant-Version: Apache Ant 1.6.2
Created-By: 1.4.2_03-b02 (Sun Microsystems Inc.)
MIDlet-1: Mboker,/icon.png,com.mboker.blog.midp.MBokerMIDlet
MIDlet-Vendor: Vendor
MIDlet-Version: 1.0
MIDlet-Name: mboker
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-2.0
每个MIDlet套件有个可选的JAD文件来描述MIDlet套件的信息，与Manifest.mf文件不同的是，JAD文件位于MIDlet套件的外部。虽然是可选的，但是JAD文件的作用非常重要。在MIDlet套件安装到移动设备之前，AMS首先会读取JAD文件的内容，分析MIDlet套件是否与设备实现兼容，比如配置和简表的版本是否匹配。如果不兼容，那么系统会拒绝安装这个套件。当用户从网络上下载MIDlet套件的时候，如果不进行这一步检查，就可能出现用户安装应用程序后不能够运行的问题，给用户造成不必要的浪费。JAD文件的格式与Manifest.mf的文件格式非常相似，都是以“：”来分隔名称和值的。
表2-2描述了在MIDlet套件中定义的属性。
表2-2 MIDlet套件中定义的属性
属 性
描 述
Manifest.mf
JAD文件
MIDlet-Name
标记MIDlet套件的名称
必需
必需
MIDlet-Version
标记MIDlet套件的当前版本号
必需
必需
MIDlet-Vendor
创建此套件的组织
必需
必需
MIDlet-n
标记MIDlet类的文件名称、图标和包含包结构的类名
必需
必需
属 性
描 述
Manifest.mf
JAD文件
MicroEdition-Profile
标记套件能够成功地运行所需的简表版本
必需
必需
MicroEdition-Configuration
标记套件能够成功地运行所需的配置版本
必需
必需
MIDlet-Jar-URL
指示AMS下载套件的地址
必需
MIDlet-Jar-Size
说明jar文件的大小，以字节为单位
必需
MIDlet-Description
描述套件
可选
可选
MIDlet-Icon
在设备上代表套件的图标
可选
可选
MIDlet-Info-URL
提供MIDlet套件的信息
可选
可选
MIDlet-Data-Size
指定套件用于持久性存储所需的最小字节数
可选
可选
MIDlet-Permission(MIDP2.0)
定义套件成功运行需要访问的受限API的许可
可选
可选
MIDlet-Permissions-Opt（MIDP2.0）
定义那些访问受限API非关键的许可
可选
可选
MIDlet-Push（MIDP2.0）
Push注册
可选
可选
MIDlet-Install-Notify（MIDP2.0）
定义接收套件安装状态的URL
可选
可选
MIDlet-Delete-Notify（MIDP2.0）
定义接收套件删除报告的URL
可选
可选
MIDlet-Delete-Confirm（MIDP2.0）
提示用户确认删除了套件
可选
可选
注：MIDlet-n，MicroEdition-Profile和MicroEdition-Configuration不必同时出现在JAD文件和Manifest.mf文件中，可以只出现在其中之一。
Manifest.mf文件和JAD文件都必须包含的三个属性MIDlet-Name，MIDlet-Version和MIDlet-Vendor必须一致，否则AMS会拒绝安装MIDlet套件。当用户安装MIDlet套件的时候，AMS会鉴别正在安装的套件是信任的（Trusted）还是非信任的（Untrusted）。根据套件类型的不同，AMS处理在两个文件中重复定义的属性时采取了如下方法。
Ø 信任套件。如果定义的属性在Manifest.mf和JAD文件中都出现，那么它们必须要一致。
Ø 非信任套件。如果定义的属性在Manifest.mf和JAD文件中都出现，那么JAD文件中的定义的属性值占先。
MIDP 2.0规范中定义了几个新属性，如MIDlet-Permission和MIDlet-Push。在第7章介绍MIDP 2.0的安全模型和PUSH注册机制时将详细讲解上述新属性。
2.3.4 MIDP应用程序的属性
MIDlet可以访问两种运行时的属性值：系统属性和应用程序属性。
1．系统属性
系统属性是在CLDC（Connected Limited Device Configuration）中定义的，属性值被写入底层的系统，我们可以读取它们，但是不能修改这些属性值。如果想读取一个系统属性值，那么可以使用System类的静态方法System.getProperty()来读取。有时候我们可能想读取特定手机的系统信息，比如IMEI号。解决办法就是去参考这款手机的开发指南和规范，比如，从SonyEricsson系列手机读取IMEI号，调用方法：System.getProperty ("com. onyericsson.imei")，这时将返回手机的IMEI号码，如IMEI 123456-00-123456-1-00。需要说明的一点是，在SonyEricsson P910上查询IMEI号码时，传递的字符串参数应该是com.sonyericsson.IMEI（IMEI须大写）。如果在不支持此项功能的手机上查询IMEI号时，将什么都不返回，例如，在T610上调用。
表2-3列举了系统属性。
表2-3 MIDP应用程序系统属性
JSR
属性名称
默 认 值
30
microedition.platform
null
microedition.encoding
ISO8859_1
microedition.configuration
CLDC-1.0
microedition.profiles
null
37
microedition.locale
null
microedition.profiles
MIDP-1.0
75
microedition.io.file.FileConnection.version
1.0
file.separator
依赖于底层实现
microedition.pim.version
1.0
118
microedition.locale
null
microedition.profiles
MIDP-2.0
microedition.commports
依赖于底层实现
microedition.hostname
依赖于底层实现
120
wireless.messaging.sms.smsc
依赖于底层实现
139
microedition.platform
依赖于底层实现
microedition.encoding
ISO8859-1
microedition.configuration
CLDC-1.1
microedition.profiles
依赖于底层实现
177
microedition.smartcardslots
依赖于底层实现
179
microedition.location.version
1.0
180
microedition.sip.version
1.0
184
microedition.m3g.version
1.0
185
microedition.jtwi.version
1.0
195
microedition.locale
依赖于底层实现
microedition.profiles
IMP-1.0
205
wireless.messaging.sms.smsc
依赖于底层实现
205
wireless.messaging.mms.mmsc
依赖于底层实现
2．应用程序属性
应用程序属性值是在应用程序描述符文件或者MANIFEST文件中定义的，当我们部署应用程序的时候可以定义应用程序属性。比如下面是一个典型的JAD文件内容。
MIDlet-1: HttpWrapperMidlet,httpwrapper.HttpWrapperMIDlet
MIDlet-Jar-Size: 16315
MIDlet-Jar-URL: HttpWrapper.jar
MIDlet-Name: HttpWrapper
MIDlet-Vendor: Vendor
MIDlet-Version: 1.0
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-1.0
Which-Locale: en
其中Which-Locale就是应用程序属性值，我们可以通过MIDlet的成员方法getAppProperty()来得到它，代码片断如下：
import javax.microedition.midlet.*;
public class MyMIDlet extends MIDlet {
private String suiteName;
private String which_locale;
public MyMIDlet(){
suiteName = getAppProperty( "MIDlet-Name" );
which_locale = getAppProperty("Which-Locale");
}
//这里省略了其他代码
}
属性值对大小写是敏感的，如果属性值在底层系统、JAD文件和Manifest文件中都没有定义的话，那么将返回Null。
熟悉MIDP应用程序的系统属性对我们开发灵活、强大的MIDlet至关重要。可以根据系统属性返回值来动态地生成应用程序的菜单。例如，通过判断底层系统是否支持MMAPI来决定应用程序中是否要添加摄像功能。下面的例子演示了如何在MIDlet中读取系统属性。
package com.j2medev.ch3.property;
import javax.microedition.lcdui.*;
import javax.microedition.midlet.*;
public class DetectMIDlet extends MIDlet {
private static DetectMIDlet instance = null;
private Display display = null;
private Displayable form = null;
public DetectMIDlet() {
instance = this;
}
protected void startApp() {
if(display==null) {
//首次启动应用程序
display = Display.getDisplay(this);
form = new TestForm();
display.setCurrent(form);
} else{
display.setCurrent(form);
}
}
protected void pauseApp() {}
protected void destroyApp(boolean unconditional) {}
public static void quitApp() {
instance.destroyApp(true);
instance.notifyDestroyed();
instance = null;
}
}
class TestForm extends Form implements CommandListener {
private Command exit = new Command("退出", Command.EXIT, 0);
public TestForm() {
super("J2ME平台测试");
String s;
//CLDC版本属性
s = System.getProperty("microedition.configuration");
append(getValue("CLDC版本", s));
//MIPD版本属性
s = System.getProperty("microedition.profiles");
append(getValue("MIDP版本",s));
s = System.getProperty("microedition.platform");
append(getValue("软件平台", s));
s = System.getProperty("microedition.encoding");
append(getValue("系统编码", s));
s = System.getProperty("microedition.locale");
append(getValue("区域设置", s));
s = System.getProperty("microedition.jtwi.version");
append(getValue("JTWI", s));
//判断是否支持MMAPI
s = System.getProperty("microedition.media.version");
append(getValue("MMAPI", s));
//判断是否支持WMA
s = System.getProperty("wireless.messaging.sms.smsc");
if(s!=null) {
append(getValue("WMA", "支持"));
append(getValue("SMS", s));
s = System.getProperty("wireless.messaging.mms.mmsc");
append(getValue("MMS", s));
} else
append(getValue("WMA", null));
//判断是否支持蓝牙
s = System.getProperty("bluetooth.api.version");
append(getValue("蓝牙", s));
//判断是否支持个人信息管理
s = System.getProperty("microedition.pim.version");
append(getValue("PIM", s));
//判断是否支持文件系统
s=System.getProperty("microedition.io.file.FileConnection. version");
append(getValue("FileConnection", s));
//判断是否支持SIP
s = System.getProperty("microedition.sip.version");
append(getValue("SIP", s));
//判断是否支持M3G JSR 184
s = System.getProperty("microedition.m3g.version");
append(getValue("M3G", s));
addCommand(exit);
setCommandListener(this);
}
private String getValue(String prompt, String s) {
return prompt + "：" + (s==null ? "不支持" : s) + "\n";
}
public void commandAction(Command c, Displayable d) {
if(c==exit){
DetectMIDlet.quitApp();
}
}
}
DetectMIDlet的运行界面如图2-19所示。
图2-19 DetectMIDlet的运行界面
2.3.5 发布MIDP应用程序
MIDlet开发完成后，需要进行一系列的测试。测试通过后我们就可以发布MIDlet套件了。本节讲述如何搭建OTA（Over The Air）下载服务器来发布MIDP应用程序。
OTA是指通过无线网络下载和安装J2ME应用程序的方案。搭建OTA服务器是比较简单的，但是做一个完整的OTA解决方案却非常复杂，因为这要设计到软件的管理、下载计费和安全认证等多个问题。
当手机通过无线网络发出请求要求下载相关软件的时候，通常是访问特定的页面，页面可以使用WML语言编写。客户端（手机）首先发送获得JAD文件的请求，服务器接收到请求后把JAD文件发送给客户端，客户端根据MIDlet-Jar-URL的信息请求下载jar文件，服务器响应请求并把jar包传输给客户端，客户端接收数据并开始安装软件。原理如图2-20所示。
我们采用Tomcat 5.0作为OTA下载服务器，请参考附录B来正确安装并运行Tomcat 5.0。假设安装目录为C:\Tomcat 5.0，使用文本编辑器打开C:\Tomcat 5.0\conf\web.xml文件，查看服务器是否支持jad和jar两种MIME类型，内容如下：
<mime-mapping>
<extension>jad</extension>
<mime-type>text/vnd.sun.j2me.app-descriptor</mime-type>
</mime-mapping>
<mime-mapping>
<extension>jar</extension>
<mime-type>application/java-archive</mime-type>
</mime-mapping>
如果采用的Tomcat服务器版本比较早，可能不支持上述两种MIME类型，需要手动把上述XML格式的内容添加到web.xml文件中。接下来编写一个WML文件down.wml作为下载页面，内容如下：
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card title="Welcome" id="main">
<p>Software center:</p>
<p align="left">
<a href="UIDemo.jad">
UIDemo</a></p>
</card>
</wml>
将down.wml放置到C:\Tomcat 5.0\webapps\ROOT，这样我们可以使用手机语句http://yourserver:port/down.wml下载页面。我们使用WTK2.2自带的UIDemo作为下载文件，将UIDemo.jar和UIDemo.jad文件复制到C:\Tomcat 5.0\webapps\ROOT目录下。
WTK2.2提供了通过OTA的方式运行MIDP应用程序的功能。单击【开始】→【所有程序】→【J2ME Wireless Toolkit 2.2】→【OTA预配置】，启动AMS的安装管理器。单击【应用程序】按钮进入已安装软件列表中，选择“安装应用程序”进入URL输入界面。输入http://localhost:8080/down.wml（读者根据自己服务器的IP地址和端口号填写），然后单击【转到】命令，如图2-21所示。
图2-21 安装UIDemo套件
AMS安装器首先解析down.wml文件，把其中含有的UIDemo显示在列表中。单击【安装】按钮后AMS安装器就会读取UIDemo.jad文件并解析文件内容，然后显示在安装界面内，提示用户是否要安装UIDemo。这时，单击【安装】按钮即可开始安装MIDlet套件。安装完成后UIDemo会出现在已安装的应用程序列表中。安装过程如图2-22所示。
图2-22 安装UIDemo套件
AMS使用如下生命周期方法来控制MIDlet的状态：
Ø 默认构造器。AMS调用默认构造来执行基本的初始化工作，如设置实例变量。此时MIDlet还处在暂停（Paused）的状态，它并没有获得任何所需的资源。
Ø startApp()方法。AMS调用startApp()方法来获取MIDlet所需的资源，然后MIDlet将会处于活动（Active）状态。
Ø pauseApp()方法。AMS调用pauseApp()方法来释放MIDlet持有的任何资源。如果MIDlet创建了对象，则将对象状态存储到持久性存储器中并把对象设置为Null。如果MIDlet启动了任何线程，则停止或者暂停这些线程。
Ø destroyApp()方法。AMS调用destroyApp()方法来保存MIDlet的状态并释放MIDlet持有的任何资源。通常，一个设计良好的MIDlet应该在被关闭前进入此状态。
下面的代码框架包含了基本的生命周期方法，可以将其作为程序的模版。出色的开发工具在新建MIDlet的时候都会自动生成类似下面的框架，如Netbeans IDE。
import javax.microedition.midlet.*;
public class MyMIDlet extends MIDlet{
public MyMIDlet(){
//默认构造器
}
public void startApp(){
//进入活动状态
}
public void pauseApp(){
//进入暂停状态
}
public void destroyApp(Boolean unconditional){
//进入销毁状态
}
}
2．MIDlet的状态
用户启动MIDlet之后，被启动的MIDlet将处于应用程序生命周期中的三个状态之一。可能的状态是暂停（Paused）、活动（Active）和销毁（Destroyed）。
Ø 活动状态。当一个MIDlet进入活动状态时，它将获得用于执行任务的所有资源。转移到活动状态之后，所需的线程应该被启动。
Ø 暂停状态。当一个MIDlet进入暂停状态时，它应该释放所有持有的资源并停止活动的线程。如果有需要，则应该把数据保存到持久性存储器中，这样在程序重新进入活动状态的时候可以重用。
Ø 销毁状态。当一个MIDlet进入销毁状态时，它应该释放所有资源、停止正在执行的线程并保存持久性的数据。
MIDlet的状态如图2-17所示。
AMS控制着MIDlet在上述三种状态中的迁移，通过调用MIDlet的生命周期方法来通知应用程序。读者需要仔细参考MIDP Java doc来熟悉MIDlet的状态迁移。这里总结如下：
Ø 默认构造器。当用户启动一个MIDlet的时候，AMS创建一个新的MIDlet实例，通过调用默认构造器来执行初始化工作。当构造器返回后，MIDlet被置于暂停状态。如果在构造器执行期间抛出异常，那么MIDlet立即进入销毁状态。
Ø public void startApp()方法。在MIDlet处于暂停状态的时候，AMS调用startApp()方法指示MIDlet应该进入活动状态。startApp()方法可能会抛出MIDletState ChangeException，这个异常说明MIDlet现在不能启动，但是可能稍后会启动。如果阻止MIDlet启动的错误是短暂性的，那么你可以捕获这个异常并从错误中恢复。如果这个错误是非短暂性的，那么应该调用notifyDestroyed()方法，MIDlet进入销毁状态。
Ø public void pauseApp()方法。当MIDlet在活动状态的时候，AMS调用这个方法指示MIDlet将从活动状态进入暂停状态。
Ø public void destroyApp(boolean unconditional)方法。AMS可以在MIDlet处于活动或者暂停的时候调用这个方法，指示MIDlet将进入销毁状态。参数unconditional代表了终止请求的类型，如果unconditional为true，那么终止请求是强制执行的。如果unconditional为false，那么终止请求是可自由决定的，MIDlet可以抛出MIDletStateChangedException而持续运行。
3．控制MIDlet的状态改变
AMS控制MIDlet的状态改变，在代码执行到某一点你可能需要状态的改变。MIDlet类提供了如下三个方法来允许一个MIDlet来控制它自己的状态。
Ø resumeRequest()方法。MIDlet调用这个方法表明它本身已经准备好进入活动状态了。resumeRequest()方法调用的结果是，AMS会在何时调用MIDlet的startApp()方法。
Ø notifyPaused()方法。该方法允许MIDlet主动暂停自己。当MIDlet处于活动状态的时候，它可以调用notifyPause()方法通知AMS MIDlet已经主动进入暂停状态。在必要的时候，AMS可以调用startApp()方法重新启动MIDlet，也可以调用destroyApp()方法来终止MIDlet。
Ø notifyDestroyed()方法。该方法允许MIDlet主动销毁自己。当MIDlet处于活动状态的时候，它可以调用notifyDestroyed()方法通知AMS MIDlet已经主动进入了销毁状态。
必须注意的是，如果上述的三个通知方法被调用，那么AMS就不会再调用相应的生命周期方法。例如，如果已经调用了notifyPaused()方法，那么pauseApp()方法就不会主动被调用。也就是相关的生命周期方法应该先于通知方法之前调用。因此，我们经常在退出应用程序的代码中看到如下的方法：
public void exitMIDlet(){
try{
destroyApp(false);
notifyDestroyed();
}catch(MIDletStateChangeException ex){
ex.printStackTrace();
}
}
如果exitMIDlet()方法中只是调用notifyDestroyed()方法，那么destroyApp()方法就不会被AMS方法自动调用，这样本来由destroyApp()方法完成的销毁和状态保存工作都没有被完成。图2-18说明了MIDlet的状态控制。
2.3.3 MIDlet套件
把一组MIDlet打包到一个jar文件然后发布，这个文件称做MIDlet套件。在MIDlet套件的内部有个Manifest.mf文件用于描述MIDlet套件的内容信息，其中就包含定义MIDlet套件中的MIDlet的属性。在同一个MIDlet套件中的MIDlet可以访问同样的资源，如类和数据，他们之间共享运行环境。
从物理组织上说，MIDlet套件包含如下的内容：
Ø 一个或者多个MIDlet，它们必须是javax.microedition.MIDlet的子类；
Ø MIDlet的支持类，这些类是在CLDC和MIDP中都没有定义的，需要开发者自己创建，比如功能类等；
Ø 资源文件，如图片、文本和多媒体文件；
Ø Manifest.mf文件用于描述MIDlet套件的信息。
MIDlet类是MIDlet套件中必须包含的，因为它定义了应用程序的生命周期。多个MIDlet可以打包在一个MIDlet套件中发布，这样开发者可以一次创建多个MIDlet。
MIDP规范中要求Manifest.mf文件，这是一个文本文件。它由名称和值组成，中间由“：”分隔。下面是一个典型的Manifest.mf文件的内容。
01Manifest-Version: 1.0
Ant-Version: Apache Ant 1.6.2
Created-By: 1.4.2_03-b02 (Sun Microsystems Inc.)
MIDlet-1: Mboker,/icon.png,com.mboker.blog.midp.MBokerMIDlet
MIDlet-Vendor: Vendor
MIDlet-Version: 1.0
MIDlet-Name: mboker
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-2.0
每个MIDlet套件有个可选的JAD文件来描述MIDlet套件的信息，与Manifest.mf文件不同的是，JAD文件位于MIDlet套件的外部。虽然是可选的，但是JAD文件的作用非常重要。在MIDlet套件安装到移动设备之前，AMS首先会读取JAD文件的内容，分析MIDlet套件是否与设备实现兼容，比如配置和简表的版本是否匹配。如果不兼容，那么系统会拒绝安装这个套件。当用户从网络上下载MIDlet套件的时候，如果不进行这一步检查，就可能出现用户安装应用程序后不能够运行的问题，给用户造成不必要的浪费。JAD文件的格式与Manifest.mf的文件格式非常相似，都是以“：”来分隔名称和值的。
表2-2描述了在MIDlet套件中定义的属性。
表2-2 MIDlet套件中定义的属性
属 性
描 述
Manifest.mf
JAD文件
MIDlet-Name
标记MIDlet套件的名称
必需
必需
MIDlet-Version
标记MIDlet套件的当前版本号
必需
必需
MIDlet-Vendor
创建此套件的组织
必需
必需
MIDlet-n
标记MIDlet类的文件名称、图标和包含包结构的类名
必需
必需
属 性
描 述
Manifest.mf
JAD文件
MicroEdition-Profile
标记套件能够成功地运行所需的简表版本
必需
必需
MicroEdition-Configuration
标记套件能够成功地运行所需的配置版本
必需
必需
MIDlet-Jar-URL
指示AMS下载套件的地址
必需
MIDlet-Jar-Size
说明jar文件的大小，以字节为单位
必需
MIDlet-Description
描述套件
可选
可选
MIDlet-Icon
在设备上代表套件的图标
可选
可选
MIDlet-Info-URL
提供MIDlet套件的信息
可选
可选
MIDlet-Data-Size
指定套件用于持久性存储所需的最小字节数
可选
可选
MIDlet-Permission(MIDP2.0)
定义套件成功运行需要访问的受限API的许可
可选
可选
MIDlet-Permissions-Opt（MIDP2.0）
定义那些访问受限API非关键的许可
可选
可选
MIDlet-Push（MIDP2.0）
Push注册
可选
可选
MIDlet-Install-Notify（MIDP2.0）
定义接收套件安装状态的URL
可选
可选
MIDlet-Delete-Notify（MIDP2.0）
定义接收套件删除报告的URL
可选
可选
MIDlet-Delete-Confirm（MIDP2.0）
提示用户确认删除了套件
可选
可选
注：MIDlet-n，MicroEdition-Profile和MicroEdition-Configuration不必同时出现在JAD文件和Manifest.mf文件中，可以只出现在其中之一。
Manifest.mf文件和JAD文件都必须包含的三个属性MIDlet-Name，MIDlet-Version和MIDlet-Vendor必须一致，否则AMS会拒绝安装MIDlet套件。当用户安装MIDlet套件的时候，AMS会鉴别正在安装的套件是信任的（Trusted）还是非信任的（Untrusted）。根据套件类型的不同，AMS处理在两个文件中重复定义的属性时采取了如下方法。
Ø 信任套件。如果定义的属性在Manifest.mf和JAD文件中都出现，那么它们必须要一致。
Ø 非信任套件。如果定义的属性在Manifest.mf和JAD文件中都出现，那么JAD文件中的定义的属性值占先。
MIDP 2.0规范中定义了几个新属性，如MIDlet-Permission和MIDlet-Push。在第7章介绍MIDP 2.0的安全模型和PUSH注册机制时将详细讲解上述新属性。
2.3.4 MIDP应用程序的属性
MIDlet可以访问两种运行时的属性值：系统属性和应用程序属性。
1．系统属性
系统属性是在CLDC（Connected Limited Device Configuration）中定义的，属性值被写入底层的系统，我们可以读取它们，但是不能修改这些属性值。如果想读取一个系统属性值，那么可以使用System类的静态方法System.getProperty()来读取。有时候我们可能想读取特定手机的系统信息，比如IMEI号。解决办法就是去参考这款手机的开发指南和规范，比如，从SonyEricsson系列手机读取IMEI号，调用方法：System.getProperty ("com. onyericsson.imei")，这时将返回手机的IMEI号码，如IMEI 123456-00-123456-1-00。需要说明的一点是，在SonyEricsson P910上查询IMEI号码时，传递的字符串参数应该是com.sonyericsson.IMEI（IMEI须大写）。如果在不支持此项功能的手机上查询IMEI号时，将什么都不返回，例如，在T610上调用。
表2-3列举了系统属性。
表2-3 MIDP应用程序系统属性
JSR
属性名称
默 认 值
30
microedition.platform
null
microedition.encoding
ISO8859_1
microedition.configuration
CLDC-1.0
microedition.profiles
null
37
microedition.locale
null
microedition.profiles
MIDP-1.0
75
microedition.io.file.FileConnection.version
1.0
file.separator
依赖于底层实现
microedition.pim.version
1.0
118
microedition.locale
null
microedition.profiles
MIDP-2.0
microedition.commports
依赖于底层实现
microedition.hostname
依赖于底层实现
120
wireless.messaging.sms.smsc
依赖于底层实现
139
microedition.platform
依赖于底层实现
microedition.encoding
ISO8859-1
microedition.configuration
CLDC-1.1
microedition.profiles
依赖于底层实现
177
microedition.smartcardslots
依赖于底层实现
179
microedition.location.version
1.0
180
microedition.sip.version
1.0
184
microedition.m3g.version
1.0
185
microedition.jtwi.version
1.0
195
microedition.locale
依赖于底层实现
microedition.profiles
IMP-1.0
205
wireless.messaging.sms.smsc
依赖于底层实现
205
wireless.messaging.mms.mmsc
依赖于底层实现
2．应用程序属性
应用程序属性值是在应用程序描述符文件或者MANIFEST文件中定义的，当我们部署应用程序的时候可以定义应用程序属性。比如下面是一个典型的JAD文件内容。
MIDlet-1: HttpWrapperMidlet,httpwrapper.HttpWrapperMIDlet
MIDlet-Jar-Size: 16315
MIDlet-Jar-URL: HttpWrapper.jar
MIDlet-Name: HttpWrapper
MIDlet-Vendor: Vendor
MIDlet-Version: 1.0
MicroEdition-Configuration: CLDC-1.0
MicroEdition-Profile: MIDP-1.0
Which-Locale: en
其中Which-Locale就是应用程序属性值，我们可以通过MIDlet的成员方法getAppProperty()来得到它，代码片断如下：
import javax.microedition.midlet.*;
public class MyMIDlet extends MIDlet {
private String suiteName;
private String which_locale;
public MyMIDlet(){
suiteName = getAppProperty( "MIDlet-Name" );
which_locale = getAppProperty("Which-Locale");
}
//这里省略了其他代码
}
属性值对大小写是敏感的，如果属性值在底层系统、JAD文件和Manifest文件中都没有定义的话，那么将返回Null。
熟悉MIDP应用程序的系统属性对我们开发灵活、强大的MIDlet至关重要。可以根据系统属性返回值来动态地生成应用程序的菜单。例如，通过判断底层系统是否支持MMAPI来决定应用程序中是否要添加摄像功能。下面的例子演示了如何在MIDlet中读取系统属性。
package com.j2medev.ch3.property;
import javax.microedition.lcdui.*;
import javax.microedition.midlet.*;
public class DetectMIDlet extends MIDlet {
private static DetectMIDlet instance = null;
private Display display = null;
private Displayable form = null;
public DetectMIDlet() {
instance = this;
}
protected void startApp() {
if(display==null) {
//首次启动应用程序
display = Display.getDisplay(this);
form = new TestForm();
display.setCurrent(form);
} else{
display.setCurrent(form);
}
}
protected void pauseApp() {}
protected void destroyApp(boolean unconditional) {}
public static void quitApp() {
instance.destroyApp(true);
instance.notifyDestroyed();
instance = null;
}
}
class TestForm extends Form implements CommandListener {
private Command exit = new Command("退出", Command.EXIT, 0);
public TestForm() {
super("J2ME平台测试");
String s;
//CLDC版本属性
s = System.getProperty("microedition.configuration");
append(getValue("CLDC版本", s));
//MIPD版本属性
s = System.getProperty("microedition.profiles");
append(getValue("MIDP版本",s));
s = System.getProperty("microedition.platform");
append(getValue("软件平台", s));
s = System.getProperty("microedition.encoding");
append(getValue("系统编码", s));
s = System.getProperty("microedition.locale");
append(getValue("区域设置", s));
s = System.getProperty("microedition.jtwi.version");
append(getValue("JTWI", s));
//判断是否支持MMAPI
s = System.getProperty("microedition.media.version");
append(getValue("MMAPI", s));
//判断是否支持WMA
s = System.getProperty("wireless.messaging.sms.smsc");
if(s!=null) {
append(getValue("WMA", "支持"));
append(getValue("SMS", s));
s = System.getProperty("wireless.messaging.mms.mmsc");
append(getValue("MMS", s));
} else
append(getValue("WMA", null));
//判断是否支持蓝牙
s = System.getProperty("bluetooth.api.version");
append(getValue("蓝牙", s));
//判断是否支持个人信息管理
s = System.getProperty("microedition.pim.version");
append(getValue("PIM", s));
//判断是否支持文件系统
s=System.getProperty("microedition.io.file.FileConnection. version");
append(getValue("FileConnection", s));
//判断是否支持SIP
s = System.getProperty("microedition.sip.version");
append(getValue("SIP", s));
//判断是否支持M3G JSR 184
s = System.getProperty("microedition.m3g.version");
append(getValue("M3G", s));
addCommand(exit);
setCommandListener(this);
}
private String getValue(String prompt, String s) {
return prompt + "：" + (s==null ? "不支持" : s) + "\n";
}
public void commandAction(Command c, Displayable d) {
if(c==exit){
DetectMIDlet.quitApp();
}
}
}
DetectMIDlet的运行界面如图2-19所示。
图2-19 DetectMIDlet的运行界面
2.3.5 发布MIDP应用程序
MIDlet开发完成后，需要进行一系列的测试。测试通过后我们就可以发布MIDlet套件了。本节讲述如何搭建OTA（Over The Air）下载服务器来发布MIDP应用程序。
OTA是指通过无线网络下载和安装J2ME应用程序的方案。搭建OTA服务器是比较简单的，但是做一个完整的OTA解决方案却非常复杂，因为这要设计到软件的管理、下载计费和安全认证等多个问题。
当手机通过无线网络发出请求要求下载相关软件的时候，通常是访问特定的页面，页面可以使用WML语言编写。客户端（手机）首先发送获得JAD文件的请求，服务器接收到请求后把JAD文件发送给客户端，客户端根据MIDlet-Jar-URL的信息请求下载jar文件，服务器响应请求并把jar包传输给客户端，客户端接收数据并开始安装软件。原理如图2-20所示。
我们采用Tomcat 5.0作为OTA下载服务器，请参考附录B来正确安装并运行Tomcat 5.0。假设安装目录为C:\Tomcat 5.0，使用文本编辑器打开C:\Tomcat 5.0\conf\web.xml文件，查看服务器是否支持jad和jar两种MIME类型，内容如下：
<mime-mapping>
<extension>jad</extension>
<mime-type>text/vnd.sun.j2me.app-descriptor</mime-type>
</mime-mapping>
<mime-mapping>
<extension>jar</extension>
<mime-type>application/java-archive</mime-type>
</mime-mapping>
如果采用的Tomcat服务器版本比较早，可能不支持上述两种MIME类型，需要手动把上述XML格式的内容添加到web.xml文件中。接下来编写一个WML文件down.wml作为下载页面，内容如下：
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.wapforum.org/DTD/wml_1.1.xml">
<wml>
<card title="Welcome" id="main">
<p>Software center:</p>
<p align="left">
<a href="UIDemo.jad">
UIDemo</a></p>
</card>
</wml>
将down.wml放置到C:\Tomcat 5.0\webapps\ROOT，这样我们可以使用手机语句http://yourserver:port/down.wml下载页面。我们使用WTK2.2自带的UIDemo作为下载文件，将UIDemo.jar和UIDemo.jad文件复制到C:\Tomcat 5.0\webapps\ROOT目录下。
WTK2.2提供了通过OTA的方式运行MIDP应用程序的功能。单击【开始】→【所有程序】→【J2ME Wireless Toolkit 2.2】→【OTA预配置】，启动AMS的安装管理器。单击【应用程序】按钮进入已安装软件列表中，选择“安装应用程序”进入URL输入界面。输入http://localhost:8080/down.wml（读者根据自己服务器的IP地址和端口号填写），然后单击【转到】命令，如图2-21所示。
图2-21 安装UIDemo套件
AMS安装器首先解析down.wml文件，把其中含有的UIDemo显示在列表中。单击【安装】按钮后AMS安装器就会读取UIDemo.jad文件并解析文件内容，然后显示在安装界面内，提示用户是否要安装UIDemo。这时，单击【安装】按钮即可开始安装MIDlet套件。安装完成后UIDemo会出现在已安装的应用程序列表中。安装过程如图2-22所示。
图2-22 安装UIDemo套件