org.opendaylight.yangtools.yang.parser.spi.source

Class SourceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.opendaylight.yangtools.yang.parser.spi.source.SourceException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

InferenceException, InvalidSubstatementException, MissingSubstatementException

public class SourceException
extends RuntimeException

Thrown to indicate error in YANG model source.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SourceException(StatementSourceReference source, String format, Object... args) Create a new instance with the specified source and a formatted message.
SourceException(StatementSourceReference source, Throwable cause, String format, Object... args) Create a new instance with the specified source and a formatted message.
SourceException(String message, StatementSourceReference source) Create a new instance with the specified message and source.
SourceException(String message, StatementSourceReference source, Throwable cause) Create a new instance with the specified message and source.

Method Summary

Modifier and Type	Method and Description
StatementSourceReference	getSourceReference() Return the reference to the source which caused this exception.
static void	throwIf(boolean expression, StatementSourceReference source, String format, Object... args) Throw an instance of this exception if an expression evaluates to true.
static <T> T	throwIfNull(T obj, StatementSourceReference source, String format, Object... args) Throw an instance of this exception if an object is null.
static <T> T	unwrap(Optional<T> opt, StatementSourceReference source, String format, Object... args) Throw an instance of this exception if an optional is not present.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

SourceException

public SourceException(@Nonnull
                       String message,
                       @Nonnull
                       StatementSourceReference source)

Create a new instance with the specified message and source. The message will be appended with the source reference.

Parameters:

message - Context message

source - Statement source

SourceException

public SourceException(@Nonnull
                       String message,
                       @Nonnull
                       StatementSourceReference source,
                       Throwable cause)

Create a new instance with the specified message and source. The message will be appended with the source reference.

Parameters:

message - Context message

source - Statement source

cause - Underlying cause of this exception

SourceException

public SourceException(@Nonnull
                       StatementSourceReference source,
                       @Nonnull
                       String format,
                       Object... args)

Create a new instance with the specified source and a formatted message. The message will be appended with the source reference.

Parameters:

source - Statement source

format - Format string, according to String.format(String, Object...).

args - Format string arguments, according to String.format(String, Object...)

SourceException

public SourceException(@Nonnull
                       StatementSourceReference source,
                       Throwable cause,
                       @Nonnull
                       String format,
                       Object... args)

Create a new instance with the specified source and a formatted message. The message will be appended with the source reference.

Parameters:

source - Statement source

cause - Underlying cause of this exception

format - Format string, according to String.format(String, Object...).

args - Format string arguments, according to String.format(String, Object...)

Method Detail

getSourceReference

@Nonnull
public StatementSourceReference getSourceReference()

Return the reference to the source which caused this exception.

Returns:

Source reference

throwIf

public static void throwIf(boolean expression,
                           @Nonnull
                           StatementSourceReference source,
                           @Nonnull
                           String format,
                           Object... args)

Throw an instance of this exception if an expression evaluates to true. If the expression evaluates to false, this method does nothing.

Parameters:

expression - Expression to be evaluated

source - Statement source reference

format - Format string, according to String.format(String, Object...).

args - Format string arguments, according to String.format(String, Object...)

Throws:

SourceException - if the expression evaluates to true.

throwIfNull

@Nonnull
public static <T> T throwIfNull(@Nullable
                                         T obj,
                                         @Nonnull
                                         StatementSourceReference source,
                                         @Nonnull
                                         String format,
                                         Object... args)

Throw an instance of this exception if an object is null. If the object is non-null, it will be returned as the result of this method.

Parameters:

obj - Object reference to be checked

source - Statement source reference

format - Format string, according to String.format(String, Object...).

args - Format string arguments, according to String.format(String, Object...)

Returns:

Object if it is not null

Throws:

SourceException - if object is null

unwrap

@Nonnull
public static <T> T unwrap(Optional<T> opt,
                                    @Nonnull
                                    StatementSourceReference source,
                                    @Nonnull
                                    String format,
                                    Object... args)

Throw an instance of this exception if an optional is not present. If it is present, this method will return the unwrapped value.

Parameters:

opt - Optional to be checked

source - Statement source reference

format - Format string, according to String.format(String, Object...).

args - Format string arguments, according to String.format(String, Object...)

Returns:

Object unwrapped from the opt optional

Throws:

SourceException - if the optional is not present