com.docomo_um.module.net
クラス USSDServiceManager

java.lang.Object
  com.docomo_um.module.net.USSDServiceManager

public class USSDServiceManager
extends java.lang.Object

USSDサービス操作管理クラスです。

送信したUSSDに対してレスポンスが受信されます。 レスポンスはUSSDServiceListener.onReceived(String)がコールバックされることで受信することが出来ます。

留意事項
USSDを送信してからレスポンスを受信するまでに他のUSSDを送信、もしくは受信した場合、USSDServiceListener.onReceived(String)がコールバックされる順序が入れ替わる可能性があります。

メソッドの概要

static USSDServiceManager	getInstance() USSDサービス操作管理クラスのインスタンスを生成します。
void	send(java.lang.String message) USSDを送信します。
void	setUssdListener(USSDServiceListener listener) リスナを登録します。

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait

メソッドの詳細

getInstance

public static USSDServiceManager getInstance()

USSDサービス操作管理クラスのインスタンスを生成します。

このメソッドを複数回呼び出した場合には、同一インスタンスを返します。

戻り値:

USSDサービス操作管理クラスのインスタンスを返します。

send

public void send(java.lang.String message)
          throws USSDServiceException,
                 RegulationException,
                 ExternalStatusException

USSDを送信します。

送信可能な文字は{0-9、#、* }です。

USSDを送信してからレスポンスを受信するまで、他のUSSDを送信しないでください。 ただし、通信異常などによりレスポンスが返らない場合があります。

留意事項
USSDを送信してからレスポンスを受信するまでに他のUSSDを送信、もしくは受信した場合、USSDServiceListener.onReceived(String)がコールバックされる順序が入れ替わる可能性があります。

パラメータ:

message - 送信する文字列を指定します。

例外:

java.lang.NullPointerException - messageがnullの場合に発生します。

java.lang.IllegalArgumentException - messageがサービスコードのフォーマットと適合しない場合に発生します。

USSDServiceException - 内部エラーにより処理が中断した場合に発生します。

RegulationException - 規制による通信失敗の場合に発生します。

ExternalStatusException - UIMが挿入されていない場合など、USSDの送信に失敗した場合に発生します。

setUssdListener

public void setUssdListener(USSDServiceListener listener)

リスナを登録します。

このメソッドを複数回呼出した場合、最後に登録したリスナだけが有効です。 null を指定すると、リスナの登録を削除します。

パラメータ:

listener - 登録するリスナを指定します。