io.spine.change

Class StringMismatch

java.lang.Object

io.spine.change.StringMismatch

public final class StringMismatch
extends java.lang.Object

Utility class for working with string values in ValueMismatches.

Method Summary

Modifier and Type	Method and Description
static io.spine.change.ValueMismatch	expectedEmpty(java.lang.String actual, java.lang.String newValue, int version) Creates ValueMismatch for the case of discovering a non-empty value, when an empty string was expected by a command.
static io.spine.change.ValueMismatch	expectedNotEmpty(java.lang.String expected, int version) Creates a ValueMismatch for a command that wanted to clear a string value, but discovered that the field is already empty.
static io.spine.change.ValueMismatch	unexpectedValue(java.lang.String expected, java.lang.String actual, java.lang.String newValue, int version) Creates ValueMismatch for the case of discovering a value different than expected by a command.
static java.lang.String	unpackActual(io.spine.change.ValueMismatch mismatch) Obtains actual string from the passed mismatch.
static java.lang.String	unpackExpected(io.spine.change.ValueMismatch mismatch) Obtains expected string from the passed mismatch.
static java.lang.String	unpackNewValue(io.spine.change.ValueMismatch mismatch) Obtains new value string from the passed mismatch.

Methods inherited from class java.lang.Object

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

Method Detail

expectedEmpty

public static io.spine.change.ValueMismatch expectedEmpty(java.lang.String actual,
                                                          java.lang.String newValue,
                                                          int version)

Creates ValueMismatch for the case of discovering a non-empty value, when an empty string was expected by a command.

Parameters:

actual - the value discovered instead of the empty string

newValue - the new value requested in the command

version - the version of the entity in which the mismatch is discovered

Returns:

new ValueMismatch instance

expectedNotEmpty

public static io.spine.change.ValueMismatch expectedNotEmpty(java.lang.String expected,
                                                             int version)

Creates a ValueMismatch for a command that wanted to clear a string value, but discovered that the field is already empty.

Parameters:

expected - the value of the field that the command wanted to clear

version - the version of the entity in which the mismatch is discovered

Returns:

new ValueMismatch instance

unexpectedValue

public static io.spine.change.ValueMismatch unexpectedValue(java.lang.String expected,
                                                            java.lang.String actual,
                                                            java.lang.String newValue,
                                                            int version)

Creates ValueMismatch for the case of discovering a value different than expected by a command.

Parameters:

expected - the value expected by the command

actual - the value discovered instead of the expected string

newValue - the new value requested in the command

version - the version of the entity in which the mismatch is discovered

Returns:

new ValueMismatch instance

unpackExpected

public static java.lang.String unpackExpected(io.spine.change.ValueMismatch mismatch)

Obtains expected string from the passed mismatch.

Throws:

java.lang.RuntimeException - if the passed instance represent a mismatch of non-string values

unpackActual

public static java.lang.String unpackActual(io.spine.change.ValueMismatch mismatch)

Obtains actual string from the passed mismatch.

Throws:

java.lang.RuntimeException - if the passed instance represent a mismatch of non-string values

unpackNewValue

public static java.lang.String unpackNewValue(io.spine.change.ValueMismatch mismatch)

Obtains new value string from the passed mismatch.

Throws:

java.lang.RuntimeException - if the passed instance represent a mismatch of non-string values