Record Class Try.Partition<V>

java.lang.Object

java.lang.Record

dmx.fun.Try.Partition<V>

Type Parameters:

V - the value type of the Success elements

Record Components:

successes - an unmodifiable list of values from Success elements, in encounter order

failures - an unmodifiable list of causes from Failure elements, in encounter order

Enclosing interface:

Try<Value>

public static record Try.Partition<V>(List<V> successes, List<Throwable> failures)
extends Record

A typed container holding the two partitions produced by Try.partitioningBy().

The successes list uses Collections.unmodifiableList(List) over a new ArrayList (not List.copyOf(Collection)) so that null values produced by Try.run(...) are preserved. The same strategy applies in Try.sequence(Iterable), Try.traverse(Iterable, java.util.function.Function), and Try.toList(). The rationale is documented in ADR-009 — unmodifiableList instead of List.copyOf in Try.

Constructor Summary

Constructors

Constructor	Description
Partition(List<V> successes, List<Throwable> failures)	Defensively copies both lists and null-checks them.

Method Summary

Modifier and Type	Method	Description
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
List<Throwable>	failures()	Returns the value of the failures record component.
final int	hashCode()	Returns a hash code value for this object.
List<V>	successes()	Returns the value of the successes record component.
final String	toString()	Returns a string representation of this record class.

Methods inherited from class Object

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

Constructor Details

Partition

public Partition(List<V> successes,
 List<Throwable> failures)

Defensively copies both lists and null-checks them. Uses Collections.unmodifiableList(List) over a new ArrayList rather than List.copyOf(Collection) so that null success values produced by Try.run(...) are preserved.

Method Details

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

successes

public List<V> successes()

Returns the value of the successes record component.

Returns:

the value of the successes record component

failures

public List<Throwable> failures()

Returns the value of the failures record component.

Returns:

the value of the failures record component