de.ipcon.db.core

Class CollidingBPQueryClauseBuilder

java.lang.Object

de.ipcon.db.core.CollidingBPQueryClauseBuilder

public class CollidingBPQueryClauseBuilder
extends java.lang.Object

Efficiently constructs queries to identify `BOProcs` that conflict with existing `BPs`.

Instances sharing the same BO and attribute generate identical queries, enabling safe storage in maps using keys from getKey().

Important: The key is dynamic and might change if the BO's Id is modified, for example, after the BO is saved. This could impact the behavior of hash-based collections that rely on key immutability.

Constructor Summary

Constructors

Constructor and Description
CollidingBPQueryClauseBuilder(BOProcI _proc, SchemaI _schema) Constructs a new `CollidingBPQueryClauseBuilder` for the given `BOProcI` and `SchemaI`.
CollidingBPQueryClauseBuilder(BP bp) Constructs a new `CollidingBPQueryClauseBuilder` for the given `BP` and `SchemaI`.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBOTIdsClause(EntityI ent) Generates a clause for retrieving BOT (Business Object Type) Ids associated with the given `EntityI` or any of its sub-entities.
java.lang.String	getClause() Generates an OQL query clause to identify BPs colliding with the wrapped `BOProcI`.
java.lang.String	getKey() Generates a unique key for this `CollidingBPQueryClauseBuilder`.

Methods inherited from class java.lang.Object

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

Constructor Detail

CollidingBPQueryClauseBuilder

public CollidingBPQueryClauseBuilder(BP bp)

Constructs a new `CollidingBPQueryClauseBuilder` for the given `BP` and `SchemaI`.

Parameters:

bp - The `BP` representing the modification to check for conflicts.

_schema - The `SchemaI` providing schema-related meta-information for query building

Throws:

java.lang.IllegalArgumentException - If the `_proc` is a creation operation, as this builder doesn't handle those

CollidingBPQueryClauseBuilder

public CollidingBPQueryClauseBuilder(BOProcI _proc,
                                     SchemaI _schema)

Constructs a new `CollidingBPQueryClauseBuilder` for the given `BOProcI` and `SchemaI`.

Parameters:

_proc - The `BOProcI` representing the modification to check for conflicts.

_schema - The `SchemaI` providing schema-related meta-information for query building

Throws:

java.lang.IllegalArgumentException - If the `_proc` is a creation operation, as this builder doesn't handle those

Method Detail

getKey

public java.lang.String getKey()

Generates a unique key for this `CollidingBPQueryClauseBuilder`.

The key is formed by concatenating the Id of the BO associated with the wrapped `BOProcI` and its attribute name, separated by '@'.

Returns:

A string representing the unique key

getClause

public java.lang.String getClause()

Generates an OQL query clause to identify BPs colliding with the wrapped `BOProcI`.

Handles various scenarios including BLOB changes, scalar attributes, unidirectional and bidirectional relations.

Returns:

A string representing the OQL query clause, or null if the attribute is not found in the schema

getBOTIdsClause

public java.lang.String getBOTIdsClause(EntityI ent)

Generates a clause for retrieving BOT (Business Object Type) Ids associated with the given `EntityI` or any of its sub-entities.

Parameters:

ent - The `EntityI` for which to generate the BOT Ids clause

Returns:

A string representing the BOT Ids clause

See Also:

BOT.getBOTIdsList(de.ipcon.schema.EntityI)