6.4.1 serializeメソッド
中断再開プラグインで,中断情報を直列化するためのメソッドです。パラメタに指定された中断情報(suspendInfo)をXML形式に直列化し,結果を出力ストリームoutに書き込みます。このメソッドでは,出力ストリームoutのクローズ処理はしません。呼び出し側でクローズ処理を実施してください。
中断情報の直列化,およびストリームへの出力に失敗した場合は,UCNPPluginException例外をスローします。このメソッドがスローするUCNPPluginException例外の詳細メッセージには,ナビゲーション プラットフォームのメッセージIDが付きます。スローされた例外をハンドリングして,ダイアログに表示するメッセージを設定したUCNPPluginException例外をスローしてください。
(1) 形式
public static void serialize(ISuspendInfo suspendInfo, OutputStream out) throws UCNPPluginException;
(2) 引数
(a) suspendInfo
中断情報が格納されます。
(b) out
直列化した中断情報を書き込む出力ストリームが格納されます。
(3) 戻り値
なし
(4) 例外
UCNPPluginException - 中断情報の直列化,および出力に失敗した場合
このメソッドでエラーが発生した場合,直列化処理は中断され,UCNPPluginException例外がスローされます。エラーの一覧を次に示します。
エラー |
メッセージID |
---|---|
suspendInfoパラメタにnullを指定した場合 |
KDCZ10083-E |
outパラメタにnullを指定した場合 |
KDCZ10083-E |
suspendInfoパラメタに不正なオブジェクト(ナビゲーション プラットフォームで生成していないオブジェクト)を指定した場合 |
KDCZ10084-E |
アクセス権,ディスク容量などの問題でパラメタに指定された出力ストリームに書き込みができなかった場合 |
KDCZ10085-E |