j2me的最新版增加了对短信的支持,以后将陆续将javax.wireless.messaging下的文档
按我的理解翻译过来,由于水平有限,错误再所难免,望大家指正。
我的E-mail:flyhelleryuanwei@yahoo.com.cn
javax.wireless.messaging
Interface MessageConnection
接口MessageConnection为发送和接收短信定义了一些基本的机制。如:接受和发送短信的发法,建立一个新短信的工厂方法(factory method),计算底层协议发送信息时需要将其分成的段数。
一个MessageConnection可由Connector.open()得到,并且程序应当用close()关闭打开的连接。如果MessageConnection的任何声明抛出IOException的方法在它被关闭后被调用,则抛出IOException.
消息可由一个连接发送。一个连接可别定义为服务器(server)模式或客户端(client)模式。
在客户端模式下,连接只可以发送信息。客户端模式的连接可在调用Connector.open()时传入目的地址得到。这个方法将返回一个MessageConnection对象。
在服务器模式下,一个连接既可以发送也可以接受信息。服务器模式的连接可在调用Connector.open()时传入一个此连接的标识(与协议相关,比如:端口号)。若所指定的标识已被别的系统程序或Java程序占用,则Connector.open()将抛出IOException。Java程序可以用任何未被占用的end point标识打开MessageConnection,但是某些安全协议将有可能不允许它在那个end point上发送或接受信息。
这个接口并不假设任何协议相关的细节,所以适用于所有的无线消息协议。
一个程序可以同时打开不止一个MessageConnection,并且这些连接即可以是服务器模式,也可以是客户端模式。
程序可以建立一个实现了MessageListener接口的实例,并将它通setMessageListener(
MessageListener l)注册给MessageConnection,以使MessageConnection在有信息到来是获得通报。这样就不必为了等待接收信息而使一个线程挂起了。
—————————————————————————————————————
Field Detail
TEXT_MESSAGE
public static final java.lang.String TEXT_MESSAGE
表示文本信息的常量(值为"text")。如果这个常量被用做newMessage()的参数,则将返回一个实现了TextMessage接口的实例。
BINARY_MESSAGE
public static final java.lang.String BINARY_MESSAGE
表示二进制信息的常量(值为"binary")。如果这个常量被用做newMessage()的参数,则将返回一个实现了BinaryMessage接口的实例。
————————————————————————————
Method Detail
newMessage
public Message newMessage(java.lang.String type)
依指定参数创建一个message的实例。当TEXT_MESSAGE被传入将返回一个实现了TextMessage接口的实例。当BINARY_MESSAGE被传入将返回一个实现了BinaryMessage接口的实例。实现者也可以定义其他的常量,及相应的Message的子接口。被当做参数传入的type是大小写敏感的,它将由String.equals()比较,所以只需要传入参数的值与所定义的常量的值相等既可。
当此方法由处于客户端模式的MessageConnection调用,则新建立的的Message对象将含有此连接的目的地址。
当此方法由处于服务器模式的MessageConnection调用,则新建立的的Message对象将不含有目的地址。你必须在发送消息前设定目的地址。
如果连接关闭了,此方法返回一个Message实例。
Parameters:
type:建立什么样的Message.在本接口中定义了基本的消息类型。
Returns:
依所传入的参数建立的Message实例。
Throws:
java.lang.IllegalArgumentException:当参数不TEXT_MESSAGE,BINARY_MESSAGE,或其它实现者依其特殊的协议定义的常量时将抛出。
—————————————————————————————————————
newMessage
public Message newMessage(java.lang.String type,
java.lang.String address)
依指定参数创建一个以address为目的地址的message实例。type的意义同上。
如果连接关闭了,此方法返回一个Message实例。
Parameters:
type:建立什么样的Message.在本接口中定义了基本的消息类型。
address:目的地址。
Returns:
依所传入的参数建立的Message实例。
Throws:
java.lang.IllegalArgumentException:当参数不TEXT_MESSAGE,BINARY_MESSAGE,或其它实现者依其特殊的协议定义的常量时将抛出。
—————————————————————————————————————
send
public void send(Message msg)
throws java.io.IOException
java.io.InterruptedIOException
发送信息。
Paramenters:
msg:被发送的的信息。
Throws:
java.io.IOException: 当信息不能被送出,网络故障,或连接以关闭是抛出。
java.lang.IllegalArgumentException: 当信息不完整,包含非法信息,或当信息的长度超过了协议所要求的最大长度是抛出。一个特殊信息包含非法信息的例子是,MessageConncetion试图发送它不支持类型的信息。所以信息应总是用创建它的MessageConncetion发送。
java.io.InterruptedIOException:如果timeout在试图发送信息时发生,或在调用此方法时连接已关闭。
java.lang.NullPointerException:如果msg是null。
java.lang.SecurityException:如果程序没有发送信息的权限。
—————————————————————————————————————
receive
public Message receive()
throws java.io.IOException
java.io.InterruptedIOException
接收信息。
如果没有信息,此方法挂起直到有信息到来,或MessageConnection被关闭。
Returns:
一个代表接受到的信息的Message对象。
Throws:
java.io.IOException:当如下事件发生时抛出:
1。在接受信息是发生错误。
2。在连接关闭是调用此方法。
3。在客户端模式下调用此方法。
java.io.InterruptedIOException:在此方法执行时关闭连接时抛出。
java.lang.SecurityException:如果程序没有在指定端口接收信息的权限。
—————————————————————————————————————
setMessageListener
public void setMessageListener(MessageListener l)
throws java.io.IOException
注册MessageListener到这个MessageConnection使得当消息到来时能得到通知。
如果在调用此方法前消息队列非空,则新注册的listener将会被立即被通知到(每条消息通知一次)。
在任意时刻只能有唯一一个listener注册到MessageConnection上,新设定的listener将会自动取代老的listener。以null为此方法的参数将注销前的listener。
Parameters:
1:被注册的MessageListener.若值为null则将注销当前的listener,从而接收不到任何通知。
Throws:
java.lang.SecurityException:如果程序没有在指定端口接收信息的权限。
java.lang.IOException:如果此连接以关闭,或试图在客户端模式下调用此方法。
—————————————————————————————————————
numberOfSegments
public int numberOfSegments(Message msg)
返回底层协议发送信息时需要将其分成的段数。此方法并不发鹅送信息,只是计算需要的协议段。
此方法将计算由相应协议的方式分割信息所产生的段数,它并不关心具体协议实现时所规定的段数的上限。那些限制是协议相关的,将在实现者的文挡中指出。
当连接以被关闭是,此方法将返回计算所得的段数。
Paramenters:
msg:被用来计算的信息。
Returns:
发送信息所需的协议段。如果上0则说明此信息不能用现在的底层协议发送。