org.enginehub.piston.converter

Class FailedConversion<T>

java.lang.Object

org.enginehub.piston.converter.ConversionResult<T>

org.enginehub.piston.converter.FailedConversion<T>

public final class FailedConversion<T>
extends ConversionResult<T>

Constructor Summary

Constructors

Constructor and Description
FailedConversion(java.lang.Throwable error, java.util.Collection<FailedConversion<T>> otherFailures)

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
<U> ConversionResult<U>	failureAsAny() If this result is a failure, recast as a different result type.
static <T> FailedConversion<T>	from(java.lang.Throwable error)
static <T> FailedConversion<T>	from(java.lang.Throwable error, java.util.Collection<FailedConversion<T>> otherFailures)
java.util.Collection<T>	get() Get the result, or throw an exception with all collected errors.
java.lang.Throwable	getError()
com.google.common.collect.ImmutableSet<FailedConversion<T>>	getOtherFailures()
int	hashCode()
boolean	isSuccessful()
<U> ConversionResult<U>	map(java.util.function.Function<? super java.util.Collection<T>,? extends java.util.Collection<U>> mapper) If successful, map the result using the given mapper.
ConversionResult<T>	orElse(ConversionResult<T> result) Pick the successful result, or merge the errors of the two unsuccessful results.

Methods inherited from class org.enginehub.piston.converter.ConversionResult

mapSingle, orElse

Methods inherited from class java.lang.Object

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

Constructor Detail

FailedConversion

public FailedConversion(java.lang.Throwable error,
                        java.util.Collection<FailedConversion<T>> otherFailures)

Method Detail

from

public static <T> FailedConversion<T> from(java.lang.Throwable error)

from

public static <T> FailedConversion<T> from(java.lang.Throwable error,
                                           java.util.Collection<FailedConversion<T>> otherFailures)

isSuccessful

public boolean isSuccessful()

Specified by:

isSuccessful in class ConversionResult<T>

failureAsAny

public <U> ConversionResult<U> failureAsAny()

Description copied from class: ConversionResult

If this result is a failure, recast as a different result type.

This is useful for result collectors, where the result is a different type than the inputs.

Specified by:

failureAsAny in class ConversionResult<T>

orElse

public ConversionResult<T> orElse(ConversionResult<T> result)

Description copied from class: ConversionResult

Pick the successful result, or merge the errors of the two unsuccessful results.

Specified by:

orElse in class ConversionResult<T>

map

public <U> ConversionResult<U> map(java.util.function.Function<? super java.util.Collection<T>,? extends java.util.Collection<U>> mapper)

Description copied from class: ConversionResult

If successful, map the result using the given mapper. Otherwise, return ConversionResult.failureAsAny().

If mapper returns null, this becomes a failure, with a NullPointerException as the reason.

If mapper throws, this becomes a failure, with the exception as the reason.

Specified by:

map in class ConversionResult<T>

Type Parameters:

U - the new type

Parameters:

mapper - the function to call if successful

Returns:

the new result

getError

public java.lang.Throwable getError()

getOtherFailures

public com.google.common.collect.ImmutableSet<FailedConversion<T>> getOtherFailures()

get

public java.util.Collection<T> get()

Description copied from class: ConversionResult

Get the result, or throw an exception with all collected errors.

Specified by:

get in class ConversionResult<T>

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object