Class UniqueKeyHelper

java.lang.Object

com.kingsrook.qqq.backend.core.actions.tables.helpers.UniqueKeyHelper

public class UniqueKeyHelper
extends Object

Methods to help with unique key checks.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	UniqueKeyHelper.NullUniqueKeyValue	To make a list of unique key values here behave like they do in an RDBMS (which is what we're trying to mimic - which is - 2 null values in a field aren't considered the same, so they don't violate a unique key) (at least, that's how some RDBMS's work, right??)

Constructor Summary

Constructors

Constructor	Description
UniqueKeyHelper()

Method Summary

Modifier and Type	Method	Description
static Map<QRecord,Serializable>	findMatches(QTableMetaData table, List<QRecord> records, UniqueKey key, boolean allowNullKeyValuesToEqual, InputSource inputSource, QBackendTransaction transaction)	Match a complete Replace request against native READ-visible values.
static Map<List<Serializable>,Serializable>	getExistingKeys(QBackendTransaction transaction, QTableMetaData table, List<QRecord> recordList, UniqueKey uniqueKey)
static Map<List<Serializable>,Serializable>	getExistingKeys(QBackendTransaction transaction, QTableMetaData table, List<QRecord> recordList, UniqueKey uniqueKey, boolean allowNullKeyValuesToEqual)
static Optional<List<Serializable>>	getKeyValues(QTableMetaData table, UniqueKey uniqueKey, QRecord record)
static Optional<List<Serializable>>	getKeyValues(QTableMetaData table, UniqueKey uniqueKey, QRecord record, boolean allowNullKeyValuesToEqual)
static Integer	getPageSize()	Getter for pageSize
static void	setPageSize(Integer pageSize)	Setter for pageSize
static void	validateInsertBatchKeys(InsertInput input)	Reserve in-request keys only after required-field and security validation.
static void	validateInsertStoredKeys(InsertInput input)	Persisted conflicts remain checked at the existing INSERT unique-key phase.
static void	validateUpdateUniqueKeys(UpdateInput input)	Validate final sparse candidates without hydrating caller patches or replacing the ordinary access-checked old records.

Methods inherited from class java.lang.Object

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

Constructor Details

UniqueKeyHelper

public UniqueKeyHelper()

Method Details

validateUpdateUniqueKeys

public static void validateUpdateUniqueKeys(UpdateInput input)
                                     throws QException

Validate final sparse candidates without hydrating caller patches or replacing the ordinary access-checked old records. Existing other owners remain occupied.

Throws:

QException

validateInsertStoredKeys

public static void validateInsertStoredKeys(InsertInput input)
                                     throws QException

Persisted conflicts remain checked at the existing INSERT unique-key phase.

Throws:

QException

validateInsertBatchKeys

public static void validateInsertBatchKeys(InsertInput input)
                                    throws QException

Reserve in-request keys only after required-field and security validation. Customizer phase order is retained; AFTER_ALL_VALIDATIONS remains trusted.

Throws:

QException

findMatches

public static Map<QRecord,Serializable> findMatches(QTableMetaData table,
 List<QRecord> records,
 UniqueKey key,
 boolean allowNullKeyValuesToEqual,
 InputSource inputSource,
 QBackendTransaction transaction)
                                             throws QException

Match a complete Replace request against native READ-visible values. The returned identity map never hydrates private matching fields into callers. Legacy bulk-insert helpers retain their existing tuple and Query contracts.

Throws:

QException

getExistingKeys

public static Map<List<Serializable>,Serializable> getExistingKeys(QBackendTransaction transaction,
 QTableMetaData table,
 List<QRecord> recordList,
 UniqueKey uniqueKey,
 boolean allowNullKeyValuesToEqual)
                                                            throws QException

Throws:

QException

getExistingKeys

public static Map<List<Serializable>,Serializable> getExistingKeys(QBackendTransaction transaction,
 QTableMetaData table,
 List<QRecord> recordList,
 UniqueKey uniqueKey)
                                                            throws QException

Throws:

QException

getKeyValues

public static Optional<List<Serializable>> getKeyValues(QTableMetaData table,
 UniqueKey uniqueKey,
 QRecord record,
 boolean allowNullKeyValuesToEqual)

getKeyValues

public static Optional<List<Serializable>> getKeyValues(QTableMetaData table,
 UniqueKey uniqueKey,
 QRecord record)

getPageSize

public static Integer getPageSize()

Getter for pageSize

setPageSize

public static void setPageSize(Integer pageSize)

Setter for pageSize