xyz.zhouxy.plusone.commons.exception.system

Class JdbcUpdateAffectedIncorrectNumberOfRowsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

xyz.zhouxy.plusone.commons.exception.system.SysException

xyz.zhouxy.plusone.commons.exception.system.JdbcUpdateAffectedIncorrectNumberOfRowsException

All Implemented Interfaces:

Serializable

public final class JdbcUpdateAffectedIncorrectNumberOfRowsException
extends SysException

JdbcUpdateAffectedIncorrectNumberOfRowsException

当数据操作的结果不符合预期时抛出。

比如当一个 insert 或 update 操作时，预计影响数据库中的一行数据，但结果却影响了零条数据或多条数据， 当出现这种始料未及的诡异情况时，抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException 并回滚事务。 后续需要排查原因。

Since:

1.0.0

Author:

ZhouXY108

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JdbcUpdateAffectedIncorrectNumberOfRowsException(long expected, long actual) 创建一个 JdbcUpdateAffectedIncorrectNumberOfRowsException 对象
JdbcUpdateAffectedIncorrectNumberOfRowsException(long expected, long actual, String message) 创建一个 JdbcUpdateAffectedIncorrectNumberOfRowsException 对象

Method Summary

Modifier and Type	Method and Description
static void	checkAffectedOneRow(int actualRowCount) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(int actualRowCount, String errorMessage) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(int actualRowCount, String errorMessageTemplate, Object... errorMessageArgs) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(int actualRowCount, Supplier<String> errorMessageSupplier) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(long result) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(long actualRowCount, String errorMessage) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(long actualRowCount, String errorMessageTemplate, Object... errorMessageArgs) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedOneRow(long actualRowCount, Supplier<String> errorMessageSupplier) 当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(int expected, int actualRowCount) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(int expected, int actualRowCount, String errorMessage) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(int expected, int actualRowCount, String errorMessageTemplate, Object... errorMessageArgs) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(int expected, int actualRowCount, Supplier<String> errorMessageSupplier) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(long expected, long actualRowCount) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(long expected, long actualRowCount, String errorMessage) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(long expected, long actualRowCount, String errorMessageTemplate, Object... errorMessageArgs) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
static void	checkAffectedRows(long expected, long actualRowCount, Supplier<String> errorMessageSupplier) 当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。
long	getActual() 实际影响的行数
long	getExpected() 预期影响的行数

Methods inherited from class xyz.zhouxy.plusone.commons.exception.system.SysException

of, of, of, of, of

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

JdbcUpdateAffectedIncorrectNumberOfRowsException

public JdbcUpdateAffectedIncorrectNumberOfRowsException(long expected,
                                                        long actual)

创建一个 JdbcUpdateAffectedIncorrectNumberOfRowsException 对象

Parameters:

expected - 预期影响的行数

actual - 实际影响的行数

JdbcUpdateAffectedIncorrectNumberOfRowsException

public JdbcUpdateAffectedIncorrectNumberOfRowsException(long expected,
                                                        long actual,
                                                        String message)

创建一个 JdbcUpdateAffectedIncorrectNumberOfRowsException 对象

Parameters:

expected - 预期影响的行数

actual - 实际影响的行数

message - 错误信息

Method Detail

getExpected

public long getExpected()

预期影响的行数

Returns:

the expected

getActual

public long getActual()

实际影响的行数

Returns:

the actual

checkAffectedRows

public static void checkAffectedRows(int expected,
                                     int actualRowCount)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

checkAffectedRows

public static void checkAffectedRows(int expected,
                                     int actualRowCount,
                                     @Nullable
                                     String errorMessage)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessage - 异常信息

checkAffectedRows

public static void checkAffectedRows(int expected,
                                     int actualRowCount,
                                     Supplier<String> errorMessageSupplier)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessageSupplier - 异常信息

checkAffectedRows

public static void checkAffectedRows(int expected,
                                     int actualRowCount,
                                     String errorMessageTemplate,
                                     Object... errorMessageArgs)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessageTemplate - 异常信息模板

errorMessageArgs - 异常信息参数

checkAffectedRows

public static void checkAffectedRows(long expected,
                                     long actualRowCount)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

checkAffectedRows

public static void checkAffectedRows(long expected,
                                     long actualRowCount,
                                     @Nullable
                                     String errorMessage)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessage - 异常信息

checkAffectedRows

public static void checkAffectedRows(long expected,
                                     long actualRowCount,
                                     Supplier<String> errorMessageSupplier)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessageSupplier - 异常信息

checkAffectedRows

public static void checkAffectedRows(long expected,
                                     long actualRowCount,
                                     String errorMessageTemplate,
                                     Object... errorMessageArgs)

当影响的数据量与预计不同时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

expected - 预期影响的行数

actualRowCount - 实际影响的行数

errorMessageTemplate - 异常信息模板

errorMessageArgs - 异常信息参数

checkAffectedOneRow

public static void checkAffectedOneRow(int actualRowCount)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

checkAffectedOneRow

public static void checkAffectedOneRow(int actualRowCount,
                                       String errorMessage)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessage - 异常信息

checkAffectedOneRow

public static void checkAffectedOneRow(int actualRowCount,
                                       Supplier<String> errorMessageSupplier)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessageSupplier - 异常信息

checkAffectedOneRow

public static void checkAffectedOneRow(int actualRowCount,
                                       String errorMessageTemplate,
                                       Object... errorMessageArgs)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessageTemplate - 异常信息模板

errorMessageArgs - 异常信息参数

checkAffectedOneRow

public static void checkAffectedOneRow(long result)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

result - 实际影响的数据量

checkAffectedOneRow

public static void checkAffectedOneRow(long actualRowCount,
                                       String errorMessage)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessage - 异常信息

checkAffectedOneRow

public static void checkAffectedOneRow(long actualRowCount,
                                       Supplier<String> errorMessageSupplier)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessageSupplier - 异常信息

checkAffectedOneRow

public static void checkAffectedOneRow(long actualRowCount,
                                       String errorMessageTemplate,
                                       Object... errorMessageArgs)

当影响的数据量不为 1 时抛出 JdbcUpdateAffectedIncorrectNumberOfRowsException。

Parameters:

actualRowCount - 实际影响的行数

errorMessageTemplate - 异常信息模板

errorMessageArgs - 异常信息参数