java.rmi
Class MarshalException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.io.IOException
              extended by java.rmi.RemoteException
                  extended by 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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.