PropertyComputationFailedException

package saker.build.exception

public class PropertyComputationFailedException extends RuntimeException

saker.build.exception.PropertyComputationFailedException

java.lang.RuntimeException

Exception type thrown when a property in the build system is failed to compute properly.

When the current value is being computed, it is possible that the operation throws an exception. In that case that exception is forwarded to the caller by wrapping it into an instance of PropertyComputationFailedException.

This is in order to be able to cache the results of a computation, and always provide a consistent interface for the computations.

The originally thrown exception can be retrieved by calling getCause().

EnvironmentProperty

ExecutionProperty

SakerEnvironment.getEnvironmentPropertyCurrentValue(EnvironmentProperty<T>)

ExecutionContext.getExecutionPropertyCurrentValue(ExecutionProperty<T>)

Constructors

public	PropertyComputationFailedException(String message, Throwable cause) Constructs a new runtime exception with the specified detail message and cause.
protected	PropertyComputationFailedException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) Constructs a new runtime exception with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled.
public	PropertyComputationFailedException(Throwable cause) Constructs a new runtime exception with the specified cause and a detail message of `(cause==null ? null : cause.toString())` (which typically contains the class and detail message of `cause`).

Methods

public Throwable	getCause() Gets the exception that caused the failure of the property value computation.

Inherited methods
From: Throwable addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
From: Object clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

public PropertyComputationFailedException(String message, Throwable cause)

Documentation included from: RuntimeException

Constructs a new runtime exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail message.

messagethe detail message (which is saved for later retrieval by the Throwable.getMessage() method).

causethe cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

1.4

protected PropertyComputationFailedException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace)

Documentation included from: RuntimeException

Constructs a new runtime exception with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled.

messagethe detail message.

causethe cause. (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

enableSuppressionwhether or not suppression is enabled or disabled

writableStackTracewhether or not the stack trace should be writable

1.7

public PropertyComputationFailedException(Throwable cause)

Documentation included from: RuntimeException

Constructs a new runtime exception with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for runtime exceptions that are little more than wrappers for other throwables.

causethe cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

1.4

public Throwable getCause()

Gets the exception that caused the failure of the property value computation.

Returns the cause of this throwable or null if the cause is nonexistent or unknown.(The cause is the throwable that caused this throwable to get thrown.)

This implementation returns the cause that was supplied via one of the constructors requiring a Throwable, or that was set after creation with the initCause(Throwable) method. While it is typically unnecessary to override this method, a subclass can override it to return a cause set by some other means. This is appropriate for a "legacy chained throwable" that predates the addition of chained exceptions to Throwable. Note that it is not necessary to override any of the PrintStackTrace methods, all of which invoke the getCause method to determine the cause of a throwable.

the cause of this throwable or null if the cause is nonexistent or unknown.