edu.illinois.ncsa.daffodil.japi

Class WithDiagnostics

java.lang.Object

edu.illinois.ncsa.daffodil.japi.WithDiagnostics

Direct Known Subclasses:

DataProcessor, ParseResult, ProcessorFactory, UnparseResult

public abstract class WithDiagnostics
extends java.lang.Object

Abstract class that adds diagnostic information to classes that extend it.

When a function returns a class that extend this, one should call isError() on that class before performing any further actions. If an error exists, any use of that class, aside from those functions in WithDiagnostics, is invalid and will result in an Exception.

Constructor Summary

Constructors

Constructor and Description
WithDiagnostics(edu.illinois.ncsa.daffodil.api.WithDiagnostics wd)

Method Summary

Modifier and Type	Method and Description
boolean	canProceed() Deprecated. Use !isError() to determine if it is safe to proceed. Since 2.0.0.
java.util.List<Diagnostic>	getDiagnostics() Get the list of Diagnostic's created during the construction of the parent object
boolean	isError() Determine if any errors occurred in the creation of the parent object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WithDiagnostics

public WithDiagnostics(edu.illinois.ncsa.daffodil.api.WithDiagnostics wd)

Method Detail

isError

public boolean isError()

Determine if any errors occurred in the creation of the parent object.

Returns:

true if no errors occurred, false otherwise

canProceed

public boolean canProceed()

Deprecated. Use !isError() to determine if it is safe to proceed. Since 2.0.0.

Determine if this object can be used in any future parse activities

Returns:

true it is safe to proceed, false otherwise

getDiagnostics

public java.util.List<Diagnostic> getDiagnostics()

Get the list of Diagnostic's created during the construction of the parent object

Returns:

list of Diagnostic's. May contain errors or warnings, and so may be non-empty even if isError() is false.