wireless messaging api属于j2me体系的一个optional package,通常简称为wma,使用它可以通过无线连接发送和接受短文本信息或者是二进制信息。wma基于generic connectionframework(gcf),gcf在connected limited device configuration (cldc)中定义,gcf提供了一个抽象的框架用于履行输入和输出操作,gcf也是connected device configuration (cdc)的一部分,因此何j2me-enabled设备上使用wma。

应用wma,意味着你可以使用cellular telephones(蜂窝电话)或者是相似的设备通过各种无线网络发送和接收短信息,而不管这个无线网络是基于gsm还是cdma。值得一提的是,wma还支持shortmessage service (sms,短信息服务)和 cell broadcast short message service (cbs).尽管wma消息和数据报(datagrams)十分相似,但是wma并没有使用gcf框架中定义的数据报接口(datagraminterfaces),因为这种接口是为udp connections而设计的。wma在javax.wireless.messaging包中定义了一套全新的接口,用于接收和发送短消息。

在wma中,为了接收或者是发送短消息,你必须首先获得一个messageconnection接口的实例,调用javax.microedition.io.connector的open()方法可以返回messageconnection接口的实例,参数是字

符串型的url,该url和http协议中的url十分相似,它必须指定所使用的协议(sms或者是cbs),目标电话的号码,端口号等等,例如下面的url都是合法的url:

1. sms://+417034967891

2. sms://+417034967891:5678

3. sms://:5678

4. cbs://:5678

在上述url串中,第一个和第二个url串指定了目标设备(移动电话)的号码,第二个url串还指定了端口号,如果端口号没有被指定,那么wma将会使用目标设备上缺省的文本信息端口(text messaging port),上述两种情况主要用于发送短信息的情况。第三个url串表明指定的是本机的端口,这种情况主要用于接收短信息。第四个url串也是指定本机的端口,这种情况主要适用于监听网络中广播信息。第三个url串和第四个url串的主要区别在于所哦使用的协议不一样。

下面我们来看一段简单的创建sms客户端的代码:

import javax.microedition.io.*;

import javax.wireless.messaging.*;

.....

messageconnection conn = null;

string url = "sms://+417034967891";

try

{

conn = (messageconnection) connector.open( url );

// do something with the connection

}

catch( exception e )

{

// handle errors

}

finally

{

if( conn != null )

{

}}

现在sms客户端是创建起来了,也就是说你手上的设备已经和服务器建立了连接,那么如何发送短信息呢？首先,你应该使用messageconnection接口的newmessage()方法创建一个空(empty)的消息,然后再设置该消息的payloadtext(也就是需要发送的文本或者是二进制数据),最后调用messageconnection的send()方法将短信息发送到目标设备中去。请看下面的代码:

public void sendtext( messageconnection conn, string text)

throws ioexception, interruptedioexception {

textmessage msg = conn.newmessage( conn.text_message );

msg.setpayloadtext( text );

conn.send( msg );

}

如果是发送二进制格式的数据,那么代码略有不同:

public void sendbinary( messageconnection conn, byte[] data)

throws ioexception, interruptedioexception {

binarymessage msg=conn.newmessage( conn.binary_message);

当然了,你所能发送的数据量是有限的,一般来说,sms文本信息可以包含160或者是70个字符,

这依赖于你使用何种字符编码,如果是二进制数据,那么容量是140字节(note:the wma requires support for message concatenation, however, which means that these limits are actually at least three times higher.)。同时,你可以使用messageconnection接口的numbero fsegments()

方法决定某一个特别的短信息能否被发送,并且需要把这条信息拆分为多少个信息段(message segments)。

上面介绍了如何应用wma发送短信息,应用wma接收短信息更加简单,当打开一个server connection后(此时建立connection时,不需指定电话号码,只需要指定协议以及监听端口号),直接调用messageconnection接口的receive()方法,该方法返回在当前设备的指定端口收到的下一个短信息。如果没有短信息到达,那么该方法将会阻塞,并等待下一个短信息的到达,或者由另一个不同的线程关闭此连接。请看下面的示例代码:

import java.io.*;

import javax.microedition.io.*;

import javax.wireless.messaging.*;

messageconnection conn = null;

string url = "sms://:5678"; // no phone number!

try {

conn = (messageconnection) connector.open( url );

while( true ){

message msg = conn.receive(); // blocks

if( msg instanceof binarymessage ){

byte[] data =

((binarymessage) msg).getpayloaddata();

// do something here

} else {

string text =

((textmessage) msg).getpayloadtext();

// do something here

}}

}

catch( exception e ){

// handle it

}

finally {if( conn != null ){

try { conn.close(); } catch( exception e ){}

}

}

wma的任务只是接收和发送短信息,并不去解释它们。通常来说,应用程序之间会来回发送二进制数据类型的信息,java.io包的datainputstream,dataoutputstream,bytearrayinputstream

和bytearrayoutputstream 类在对这些二进制数据解码和编码时十分有用。

访问下面两个网址可以获得更多关于wma的信息:

[1]http://java.sun.com/products/wma/

[2]http://jcp.org/aboutjava/communityprocess/final/jsr120/index.html.

注：本文主要根据eric giguere写的wireless messaging api basics翻译而成,原文可以参见

wireless developer newsletter(october 15, 2002),具体网址为:http://wireless.java.sun.com/midp/ttips/wma/

本文并非字字照译,而只是译其大意而已,文中代码均没有经过验证,仅供参考而已。如果有问题,请和翻译联系:javalover.bbs@bbs.pku.edu.cn。