io.asyncer.r2dbc.mysql.internal.util

Class StringUtils

java.lang.Object

io.asyncer.r2dbc.mysql.internal.util.StringUtils

public final class StringUtils
extends Object

A utility for processing String and simple statements in MySQL/MariaDB.

Method Summary

Modifier and Type	Method and Description
static String	extendReturning(String sql, String returning) Extends a SQL statement with RETURNING clause.
static String	lockWaitTimeoutStatement(Duration timeout) Generates a statement to set the lock wait timeout for the current session.
static ZoneId	parseZoneId(String zoneId) Parses a normalized ZoneId from a time zone string of MySQL.
static String	quoteIdentifier(String identifier) Quotes identifier with backticks, it will escape backticks in the identifier.
static String	statementTimeoutVariable(Duration timeout, boolean isMariaDb) Generates a String indicating the statement timeout variable.

Methods inherited from class java.lang.Object

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

Method Detail

quoteIdentifier

public static String quoteIdentifier(String identifier)

Quotes identifier with backticks, it will escape backticks in the identifier.

Parameters:

identifier - the identifier

Returns:

quoted identifier

extendReturning

public static String extendReturning(String sql,
                                     String returning)

Extends a SQL statement with RETURNING clause.

Parameters:

sql - the original SQL statement.

returning - quoted column identifiers.

Returns:

the SQL statement with RETURNING clause.

statementTimeoutVariable

public static String statementTimeoutVariable(Duration timeout,
                                              boolean isMariaDb)

Generates a String indicating the statement timeout variable. e.g. "max_statement_time=1.5" for MariaDB or "max_execution_time=1500" for MySQL.

Parameters:

timeout - the statement timeout

isMariaDb - whether the current server is MariaDB

Returns:

the statement timeout variable

lockWaitTimeoutStatement

public static String lockWaitTimeoutStatement(Duration timeout)

Generates a statement to set the lock wait timeout for the current session. It is using InnoDB-specific session variable innodb_lock_wait_timeout.

Parameters:

timeout - the lock wait timeout

Returns:

the lock wait timeout statement

parseZoneId

public static ZoneId parseZoneId(String zoneId)

Parses a normalized ZoneId from a time zone string of MySQL.

Note: since java 14.0.2, 11.0.8, 8u261 and 7u271, America/Nuuk is already renamed from America/Godthab. See also tzdata2020a

Parameters:

zoneId - the time zone string

Returns:

the normalized ZoneId

Throws:

IllegalArgumentException - if the time zone string is null or empty

DateTimeException - if the time zone string has an invalid format

ZoneRulesException - if the time zone string cannot be found