Interface INodeThrewExceptionBuilder

All Superinterfaces:

org.apache.commons.lang3.builder.Builder<NodeThrewException>, IAbruptCompletionExceptionBuilder<INodeThrewExceptionBuilder, NodeThrewException>, ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

public interface INodeThrewExceptionBuilder
extends ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>, IAbruptCompletionExceptionBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Builder for the exception thrown by a node when it encounters an error upon execution.

Since:

7.0.0

Author:

XIMA MEDIA GmbH

Method Summary

Modifier and Type	Method	Description
INodeThrewExceptionBuilder	always(IValueCreator alwaysValue)	Sets (replaces) the value made available by the node regardless of whether it was executed successfully (or threw an exception).
default INodeThrewExceptionBuilder	always(Object alwaysValue)	Sets (replaces) the value made available by the node regardless of whether it was executed successfully (or threw an exception).
INodeThrewExceptionBuilder	cause(Throwable cause)
INodeThrewExceptionBuilder	error(String errorCode, IValueCreator valueCreator)	Sets (replaces) the error type and value describing the exception in more detail.
default INodeThrewExceptionBuilder	error(String errorCode, Class<?> ignoredMemberClass, IValueCreator valueCreator)	Deprecated. Use error(String, IValueCreator).
default <T> INodeThrewExceptionBuilder	error(String errorCode, T value)	Sets (replaces) the error type and value describing the exception in more detail.
INodeThrewExceptionBuilder	error(Consumer<IUnionValueBuilder> errorValue)	Deprecated. Use error(String, IValueCreator).
default INodeThrewExceptionBuilder	file(IWorkflowFileValue fileValue)	Sets (replaces) the files made available by the node when it was executed.
default INodeThrewExceptionBuilder	file(File... files)	Sets (replaces) the files made available by the node when it was executed, using the default file key.
default INodeThrewExceptionBuilder	file(Iterable<File> files)	Sets (replaces) the files made available by the node when it was executed, using the default file key.
INodeThrewExceptionBuilder	message(String message)

Methods inherited from interface org.apache.commons.lang3.builder.Builder

build

Methods inherited from interface ICompletionResultBuilder

attachment, attachment, attachment, file, file, file

Method Details

always

INodeThrewExceptionBuilder always(IValueCreator alwaysValue)

Description copied from interface: ICompletionResultBuilder

Sets (replaces) the value made available by the node regardless of whether it was executed successfully (or threw an exception). When this method is not called, the default value from the IExecutionResultDescriptor.getAlwaysValueDescriptor(IValueDescriptorFactory) is used. When this method is called multiple times, only the value supplied by the last invocation is used.

For example, when you wish to return a record with two properties:

// Corresponds to the JSON object {"foo": "bar", "baz": 42}
builder.success(b -> b.asRecord().property("foo", "bar").property("baz", 42);

Specified by:

always in interface ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

alwaysValue - Function that takes a value builder to create the value.

Returns:

This builder for chaining methods calls.

always

default INodeThrewExceptionBuilder always(Object alwaysValue)

Description copied from interface: ICompletionResultBuilder

Sets (replaces) the value made available by the node regardless of whether it was executed successfully (or threw an exception). When this method is not called, the default value from the IExecutionResultDescriptor.getAlwaysValueDescriptor(IValueDescriptorFactory) is used. When this method is called multiple times, only the value supplied by the last invocation is used.

Specified by:

always in interface ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

alwaysValue - Value made available by the node when it was executed.

Returns:

This builder for chaining methods calls.

cause

INodeThrewExceptionBuilder cause(Throwable cause)

Specified by:

cause in interface IAbruptCompletionExceptionBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

cause - The cause that resulted in the returning exception. Since a return is usually intended, you should not have to call this method in most cases.

Returns:

this for chaining.

error

@Deprecated
INodeThrewExceptionBuilder error(Consumer<IUnionValueBuilder> errorValue)

Deprecated.

Use error(String, IValueCreator).

Sets (replaces) the error type and value describing the exception in more detail. Each node may specify multiple error types. For each error type, it may specify which value are made available when that error occurs (Note that this corresponds to Java exceptions with additional fields containing details about the exception.)

Parameters:

errorValue - Function that takes a value builder to create the error value.

Returns:

This builder for chaining methods calls.

error

@Deprecated
default INodeThrewExceptionBuilder error(String errorCode,
 Class<?> ignoredMemberClass,
 IValueCreator valueCreator)

Deprecated.

Use error(String, IValueCreator). The member class is not required anymore.

Sets (replaces) the error type and value describing the exception in more detail. Each node may specify multiple error types. For each error type, it may specify which value are made available when that error occurs (Note that this corresponds to Java exceptions with additional fields containing details about the exception.)

Parameters:

errorCode - String with the error type.

ignoredMemberClass - Unused.

valueCreator - Function that takes a value builder to create the error value.

Returns:

This builder for chaining methods calls.

error

INodeThrewExceptionBuilder error(String errorCode,
 IValueCreator valueCreator)

Sets (replaces) the error type and value describing the exception in more detail. Each node may specify multiple error types. For each error type, it may specify which value are made available when that error occurs (Note that this corresponds to Java exceptions with additional fields containing details about the exception.)

Parameters:

errorCode - String with the error type.

valueCreator - Function that takes a value builder to create the error value.

Returns:

This builder for chaining methods calls.

error

default <T> INodeThrewExceptionBuilder error(String errorCode,
 T value)

Sets (replaces) the error type and value describing the exception in more detail. Each node may specify multiple error types. For each error type, it may specify which value are made available when that error occurs (Note that this corresponds to Java exceptions with additional fields containing details about the exception.)

Type Parameters:

T - Type of the value for the error type.

Parameters:

errorCode - String with the error type.

value - Value with details about the error.

Returns:

This builder for chaining methods calls.

file

default INodeThrewExceptionBuilder file(File... files)

Description copied from interface: ICompletionResultBuilder

Sets (replaces) the files made available by the node when it was executed, using the default file key. The contents of the files are guessed.

When this method is not called, the default value from the IExecutionResultDescriptor.getFileValueDescriptor() is used. When this method is called multiple times, only the value supplied by the last invocation is used.

Specified by:

file in interface ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

files - File or files supplied by the node.

Returns:

This builder for chaining methods calls.

file

default INodeThrewExceptionBuilder file(Iterable<File> files)

Description copied from interface: ICompletionResultBuilder

Sets (replaces) the files made available by the node when it was executed, using the default file key. The contents of the files are guessed.

When this method is not called, the default value from the IExecutionResultDescriptor.getFileValueDescriptor() is used. When this method is called multiple times, only the value supplied by the last invocation is used.

Specified by:

file in interface ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

files - File or files supplied by the node.

Returns:

This builder for chaining methods calls.

file

default INodeThrewExceptionBuilder file(IWorkflowFileValue fileValue)

Description copied from interface: ICompletionResultBuilder

Sets (replaces) the files made available by the node when it was executed.

When this method is not called, the default value from the IExecutionResultDescriptor.getFileValueDescriptor() is used. When this method is called multiple times, only the value supplied by the last invocation is used.

Specified by:

file in interface ICompletionResultBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

fileValue - File or files supplied by the node.

Returns:

This builder for chaining methods calls.

message

INodeThrewExceptionBuilder message(String message)

Specified by:

message in interface IAbruptCompletionExceptionBuilder<INodeThrewExceptionBuilder, NodeThrewException>

Parameters:

message - The cause that resulted in the returning exception. Since a return is usually intended, you should not have to call this method in most cases.

Returns:

this for chaining.