Hitachi

JP1 Version 12 JP1/Navigation Platform Development Guide


6.4.2 deserialize method

This method is used to recover the serialized suspend information in Suspend/Resume Plugins. It loads the serialized suspend information from the input stream in specified by the parameter, and then recovers the suspend information. This method does not close the input stream in. The invocation side is responsible for performing the close processing.

If an attempt to recover the serialized suspend information or input the information from the stream fails, the method throws the UCNPPluginException exception. A system message ID is added to the message for the exception thrown by this method. You need to handle the thrown exception and then throw the UCNPPluginException exception for which the message to be displayed in the dialog box is set.

Organization of this subsection

(1) Format

public static ISuspendInfo deserialize(InputStream in)throws  UCNPPluginException;

(2) Arguments

(a) in

This argument stores the input stream from which the deserialized suspend information is loaded.

(3) Return values

Serialized suspend information recovered from the input stream

(4) Exception

UCNPPluginException - An attempt to recover and input suspend information fails.

If an error occurs with this method, deserialization processing is interrupted and the UCNPPluginException exception is thrown. The following shows a list of errors.

Table 6‒4: List of errors that occur in the deserialize method

Error

Message ID

Null is specified for the in parameter.

KDCZ10083-E

The input stream specified for the in parameter cannot be used to recover suspend information (ISuspendInfo).

KDCZ10086-E

It was not possible to load information from the input stream specified by the parameter due to a problem with access permissions.

KDCZ10093-E