java.rmi
Class MarshalException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.io.IOException
              java.rmi.RemoteException
                  java.rmi.MarshalException

public class MarshalException
extends RemoteException

MarshalException is a subclass of RemoteException. In web services, a remote method in a service endpoint interface is required to throw the standard java.rmi.RemoteException or its subclass. It is used to map to a fault in the corresponding SOAP message.

A SOAP fault includes the faultcode sub-element. The faultcode must be present in a SOAP fault and the faultcode value must be a qualified name. A JAX-RPC implementation must map a java.rmi.RemoteException or its subclass to a standard faultcode. This enables JAX-RPC implementations to interoperate in terms of handling of the remote exception.

SOAP faultcode Value	Error Description	Remote Exception Mapping
soap-env:DataEncodingUnknown	Parameters are encoded in a data encoding unknown to the server	java.rmi.MarshalException

See http://java.sun.com/j2se/1.3/docs/api/java/rmi/RemoteException.html for a general description of RemoteException.

See http://java.sun.com/j2se/1.3/docs/api/java/rmi/MarshalException.html for a general description of MarshalException.

Since:

BlackBerry API 4.3.0

Field Summary

Fields inherited from class java.rmi.RemoteException

detail

Constructor Summary

MarshalException(String message)
Constructs a MarshalException with the specified detail message.

MarshalException(String message, Exception exception)
Constructs a MarshalException with the specified detail message and nested exception.

Method Summary

Methods inherited from class java.rmi.RemoteException

getMessage

Methods inherited from class java.lang.Throwable

printStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MarshalException

public MarshalException(String message)

Constructs a MarshalException with the specified detail message.

Parameters:

message - the detail message.

Since:

BlackBerry API 4.3.0

MarshalException

public MarshalException(String message,
                        Exception exception)

Constructs a MarshalException with the specified detail message and nested exception.

Parameters:

message - the detail message.

exception - the nested exception.

Since:

BlackBerry API 4.3.0