WEB开发网
开发学院软件开发Java 介绍J2ME可选包WMA(JSR120) 阅读

介绍J2ME可选包WMA(JSR120)

 2007-12-23 12:33:05 来源:WEB开发网   
核心提示: 本文将详细讲解Wireless Messaging API(WMA,JSR120),WMA提供给应用开发者一个通用的API用于开发基于无线消息服务的应用程序,介绍J2ME可选包WMA(JSR120),比如短消息服务,目前支持的发送类型为文本和二进制两种,调用setMessageListener(null), 本文没

   本文将详细讲解Wireless Messaging API(WMA,JSR120),WMA提供给应用开发者一个通用的API用于开发基于无线消息服务的应用程序,比如短消息服务。目前支持的发送类型为文本和二进制两种。

   在讲解WMA的结构和使用方法前,我们先来从感性上熟悉一下WMA。在SUN Wireless Toolkit 20中包括了一个短消息的范例。在运行Demo程序以前我们先看一下jad文件的内容,这可以帮助我们迅速了解应用程序的信息:

CBS-Message-Identifier: 50001

MIDlet-1: SMS Send, /icons/App.png, example.sms.SMSSend

MIDlet-2: SMS Receive, /icons/App.png, example.sms.SMSReceive

MIDlet-3: CBS Receive, /icons/App.png, example.cbs.CBSReceive

MIDlet-Data-Size: 0

MIDlet-Description: This midlet demonstrates SMS and CBS messaging

MIDlet-Jar-Size: 8569

MIDlet-Jar-URL: SMSDemo.jar

MIDlet-Name: SMS Demo

MIDlet-Permissions: javax.microedition.io.PushRegistry, javax.microedition.io.Connector.sms, javax.wireless.messaging.sms.receive,javax.wireless.messaging.sms.send,javax.microedition.io.Connector.cbs,javax.wireless.messaging.cbs.receive

MIDlet-Push-1: sms://:50000, example.sms.SMSReceive, *

MIDlet-Push-2: cbs://:50001, example.cbs.CBSReceive, *

MIDlet-Vendor: Sun Microsystems, Inc.

MIDlet-Version: 2.0

MicroEdition-Configuration: CLDC-1.0

MicroEdition-PRofile: MIDP-2.0

SMS-Port: 50000

   从上述信息中我们可以看出,MIDlet套件中共包括三个MIDlet,分别是SMSSend,SMSReceive和CBSReceive。我们最应该关注的是两个MIDlet-Push实体,他们可以使得应用程序监听SMS和CBS消息,当收到消息后AMS将激活相关的MIDlet来进行处理,套件需要使用MIDP2.0的新特性——Push。因此如果想正确运行这个应用程序,必须通过OTA定购的模式进行安装。具体Push实体的属性含义这里不过多进行解释。

    WTK提供了WMA Console工具,可以和模拟器配合使用来调试基于无线短消息服务的应用程序。首先我们打开Ktoolbar选择SMSDemo项目,编译并打包后,从Project—>Run via OTA开始安装应用程序,按照提示一步一步进行安装。安装后运行应用程序,系统为它分配手机号码为5550000。
介绍J2ME可选包WMA(JSR120)(图一)

然后我们从WTK中选择Utilities—WMA Console,打开的时候系统会分配一个号码,比如5550001。选择SMS Send在用户界面中输入号码5550001(WMA Console的号码),在消息内容中输入Hello选择发送。这时候我们可以在WMA Console中看到从模拟器中发送过来的消息,如下图所示:
介绍J2ME可选包WMA(JSR120)(图二)

同样,我们也可以使用WMA Console来发送短消息给模拟器,选择Send SMS然后在客户端的电话号码中选择5550000(模拟器的电话号码),端口为50000,在消息中输入How are you?并点击发送按钮。

介绍J2ME可选包WMA(JSR120)(图三)


    我们的SMSDemo中使用了Push特性,因此在WMA Console在向模拟器发送短消息数据的时候,AMS会自动激活example.sms.SMSReceive,接收短消息内容。
介绍J2ME可选包WMA(JSR120)(图四)

WMA Console也提供了发送CBS消息的功能,与SMS类似这里略去不讲。

下面的部分详细讲解WMA的结构和使用方法。WMA是基于通用连接框架(Generic Connection Framework,GCF)的可选包,这又一次说明了GCF出色的扩展特性。所有的WMA组件都包括在javax.wireless.messaging包内。在这个包内定义了所有用于发送、接受短消息的接口,短消息的类型支持文本和二进制两种。下图是WMA组件结构图:
介绍J2ME可选包WMA(JSR120)(图五)

WMA的主要组件包括:Message、TextMessage、BinaryMessage、MessageConnection和MessageListener。其中Message接口定义了不同类型短消息的基础部分,它的两个子类BinaryMessage和TextMessage分别代表了文本类型和二进制类型的消息,通过调用BinaryMessage的setPayloadData()和TextMessage的setPayloadText()方法可以把有效负载数据添加到数据容器中,然后进行发送。MessageConnection接口是扩展了GCF中定义的Connection接口,MessageConnection接口提供了newMessage(),send()和receive()方法来创建、发送和接受消息对象。MessageListener实现了监听器设计模式用于异步接受消息,当等待消息到来的时候系统不用堵塞。每次有消息到来的时候,平台会调用MessageListener中定义的notifyIncomingMessage()方法。

    使用WMA非常简单,下面我们进行简单的讲述:

1.     创建MessageConnection
创建MessageConnection通常有两种方式,一种是按照客户端方式创建,客户端方式创建的MessageConnection只能用于发送短消息。我们需要在URL中提供电话号码和端口,如下:
(MessageConnection)Connector.open("sms://+5121234567:5000");
另一种创建方式是服务器连接,这种连接方式可以用于发送和接收短消息。
(MessageConnection)Connector.open("sms://:5000");

2.     发送短消息
通过MessageConnection提供的newMessage()方法,我们可以创建Message对象,通过指定短消息类型为BINARY_MESSAGE或者TEXT_MESSAGE可分别得到二进制和文本类型的消息对象。如果我们是使用客户端连接,那么在我们创建MessageConnection的时候,传入的URL将作为Message对象的目标地址。如果我们是使用服务器连接,那么我需要使用setAddress()方法设置目标地址。下面的代码说明了如何发送短消息。
  String address = destinationAddress + ":" + smsPort;

  MessageConnection smsconn = null;

     try {

       /** Open the message connection. */

       smsconn = (MessageConnection)Connector.open(address);

 

       TextMessage txtmessage = (TextMessage)smsconn.newMessage(


         MessageConnection.TEXT_MESSAGE);

       txtmessage.setAddress(address);

       txtmessage.setPayloadText(messageBox.getString());

       smsconn.send(txtmessage);

     } catch (Throwable t) {

System.out.println("Send caught: ");

t.printStackTrace();

     }

   if (smsconn != null) {

      try {

         smsconn.close();

       } catch (IOException ioe) {

System.out.println("Closing connection caught: ");

ioe.printStackTrace();

 

       }        

     }

   }

发送二进制短消息和发送文本消息非常类似,我们只是需要把byte[]来代替String作为发送的数据。范例代码如下:

public void sendBinaryMessage(MessageConnection mc, byte[]

  msg, String url) {

   try {

     BinaryMessage bmsg =

       (BinaryMessage)mc.newMessage

         (MessageConnection.BINARY_MESSAGE);

     if (url!= null)

       bmsg.setAddress(url);

     bmsg.setPayloadData(msg);

     mc.send(bmsg);

   }

   catch(Exception e) {


     //  Handle the exception...

     System.out.println("sendBinaryMessage " + e);

   }

}

3.  接收短消息

只有作为服务器连接的时候才可以接受短消息,接收短消息的时候我们需要单独启动一个线程来处理。调用receive()方法后,我们需要首先判断Message的类型是二进制还是文本,只有这样才可以调用正确的方法来接收数据。
public void processMessage() {

     Message msg = null;

     //  Try reading (maybe block for) a message

     try {

       msg = mc.receive();

     }

     catch (Exception e) {

       // Handle reading errors

       System.out.println("processMessage.receive " + e);

     }

     // Process the received message

     if (msg instanceof TextMessage) {

       TextMessage tmsg = (TextMessage)msg;

       //  Handle the text message...

       ticker.setString(tmsg.getPayloadText());

     }

     else {

       // process received message

       if (msg instanceof BinaryMessage) {

         BinaryMessage bmsg = (BinaryMessage)msg;

         byte[] data = bmsg.getPayloadData();

         //  Handle the binary message...

       }


       else {

         //  Ignore

       }

     }

   }

 

}

4.  使用MessageListener

   如果我们的MIDlet注册了一个MessageListener,那么当收到短消息的时候平台就会调用notifyIncomingMessage()方法来进行处理。其实这和MIDP图形用户界面中的回调机制是一样的。通常使用MessageListener按照如下的步骤,首先定义MIDlet实现MessageListener接口,当然你也可以选择不使用MIDlet来实现MessageListener。接下来我们需要实现MessageListener的方法notifyIncomingMessage()。最后MessageConnection需要注册MessageListener,在应用程序结束的时候你最好注销它,调用setMessageListener(null)。

  本文没有提供完整的范例,读者可以参考WTK中提供的SMSDemo。

(出处:http://www.cncms.com)


Tags:介绍 JME WMA

编辑录入:爽爽 [复制链接] [打 印]
赞助商链接