Hitachi

JP1 Version 12 JP1/Navigation Platform ナビゲーション プラットフォーム 開発ガイド


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例外がスローされます。エラーの一覧を次に示します。

表6‒3 serializeメソッドで発生するエラー一覧

エラー

メッセージID

suspendInfoパラメタにnullを指定した場合

KDCZ10083-E

outパラメタにnullを指定した場合

KDCZ10083-E

suspendInfoパラメタに不正なオブジェクト(ナビゲーション プラットフォームで生成していないオブジェクト)を指定した場合

KDCZ10084-E

アクセス権,ディスク容量などの問題でパラメタに指定された出力ストリームに書き込みができなかった場合

KDCZ10085-E