Class TraceInformation

  • All Implemented Interfaces:
    Serializable

    public final class TraceInformation
    extends Throwable
    A facility available to marshalling implementations which allows for detailed stack traces which trace the position in the object graph where a marshalling or unmarshalling problem has occurred.
    See Also:
    Serialized Form
    • Method Detail

      • addUserInformation

        public static void addUserInformation​(Throwable t,
                                              Serializable data)
        Add user information about problem with marshalling or unmarshalling.
        Parameters:
        t - the throwable to update
        data - the user data
      • addFieldInformation

        public static void addFieldInformation​(Throwable t,
                                               String fieldName)
        Add information about a field which was being marshalled.
        Parameters:
        t - the throwable to update
        fieldName - the field name being (un-)marshalled
      • addFieldInformation

        public static void addFieldInformation​(Throwable t,
                                               SerializableClass owner,
                                               SerializableField field)
        Add information about a field which was being marshalled.
        Parameters:
        t - the throwable to update
        owner - Reference to the class that owns the field.
        field - The field being (un-)marshalled.
      • addObjectInformation

        public static void addObjectInformation​(Throwable t,
                                                Object targetObject)
        Add information about an object which was being (un-)marshalled.
        Parameters:
        t - the throwable to update
        targetObject - the target object which was being (un-)marshalled
      • addIncompleteObjectInformation

        public static void addIncompleteObjectInformation​(Throwable t,
                                                          Class<?> targetClass)
        Add information about an incomplete object which was being unmarshalled.
        Parameters:
        t - the throwable to update
        targetClass - the class of the target object being unmarshalled
      • addIncompleteObjectInformation

        public static void addIncompleteObjectInformation​(Throwable t,
                                                          String targetClassName)
        Add information about an incomplete object which was being unmarshalled.
        Parameters:
        t - the throwable to update
        targetClassName - the class of the target object being unmarshalled
      • addIndexInformation

        public static void addIndexInformation​(Throwable t,
                                               int index,
                                               int size,
                                               TraceInformation.IndexType kind)
        Add information about an index into a collection which was being (un-)marshalled.
        Parameters:
        t - the throwable to update
        index - the index of the element in question
        size - the size of the collection in question
        kind - the type of element being processed