FacturaScripts

Where

in package

• Application

Representa una cláusula WHERE de SQL y la traduce a un fragmento seguro de SQL para usarla con la conexión de FacturaScripts.

Table of Contents

Constants

FIELD_SEPARATOR  : mixed = '|'

Separador para indicar varios campos en `$fields`; produce condiciones unidas por OR.

Properties

$fields  : mixed

Nombre del campo (o varios separados por FIELD_SEPARATOR).

$operation  : mixed

Conector con la cláusula previa al concatenar: `AND` u `OR`.

$operator  : mixed

Operador SQL: `=`, `!=`, `<`, `>`, `LIKE`, `IN`, `BETWEEN`, `XLIKE`, ... o `(` para grupos.

$subWhere  : mixed

Cláusulas hijas cuando el operador es `(` (grupo anidado).

$useField  : mixed

Si es true, los valores con prefijo `field:` se interpretan como nombre de columna.

$value  : mixed

Valor a comparar; puede ser escalar, array (IN/BETWEEN) o null (se traduce a IS NULL).

$db  : mixed

Conexión compartida perezosa, instanciada en el primer uso.

Methods

__construct()  : mixed

Construye una cláusula simple. En general es preferible usar los factory estáticos (`eq`, `like`, `in`, ...) en lugar de instanciar directamente.

between()  : self

Crea `campo BETWEEN value1 AND value2`.

column()  : self

Factory genérico que permite especificar operador y conector arbitrarios.

eq()  : self

Crea `campo = value` (o `campo IS NULL` si value es null).

gt()  : self

Crea `campo > value`.

gte()  : self

Crea `campo >= value`.

in()  : self

Crea `campo IN (...)`.

isNotNull()  : self

Crea `campo IS NOT NULL`.

isNull()  : self

Crea `campo IS NULL`.

like()  : self

Crea `LOWER(campo) LIKE LOWER('%value%')`.

lt()  : self

Crea `campo < value`.

lte()  : self

Crea `campo <= value`.

multiSql()  : string

Convierte un array de cláusulas Where en el SQL combinado, sin el prefijo `WHERE`.

multiSqlLegacy()  : string

Variante de `multiSql()` para código legacy: acepta también instancias de `DataBaseWhere` y devuelve el SQL ya prefijado con ` WHERE ` (cadena vacía si el array está vacío).

notBetween()  : self

Crea `campo NOT BETWEEN value1 AND value2`.

notEq()  : self

Crea `campo != value` (o `campo IS NOT NULL` si value es null).

notIn()  : self

Crea `campo NOT IN (...)`. Mismas reglas de `$values` que `in()`.

notLike()  : self

Crea `LOWER(campo) NOT LIKE LOWER('%value%')` con el mismo manejo de comodines que `like()`.

or()  : self

Variante genérica con conector OR.

orBetween()  : self

Equivale a `between()` pero unido a la cláusula previa con OR.

orEq()  : self

Equivale a `eq()` pero unido a la cláusula previa con OR.

orGt()  : self

Equivale a `gt()` pero unido a la cláusula previa con OR.

orGte()  : self

Equivale a `gte()` pero unido a la cláusula previa con OR.

orIn()  : self

Equivale a `in()` pero unido a la cláusula previa con OR.

orIsNotNull()  : self

Equivale a `isNotNull()` pero unido a la cláusula previa con OR.

orIsNull()  : self

Equivale a `isNull()` pero unido a la cláusula previa con OR.

orLike()  : self

Equivale a `like()` pero unido a la cláusula previa con OR.

orLt()  : self

Equivale a `lt()` pero unido a la cláusula previa con OR.

orLte()  : self

Equivale a `lte()` pero unido a la cláusula previa con OR.

orNotBetween()  : self

Equivale a `notBetween()` pero unido a la cláusula previa con OR.

orNotEq()  : self

Equivale a `notEq()` pero unido a la cláusula previa con OR.

orNotIn()  : self

Equivale a `notIn()` pero unido a la cláusula previa con OR.

orNotLike()  : self

Equivale a `notLike()` pero unido a la cláusula previa con OR.

orRegexp()  : self

Equivale a `regexp()` pero unido a la cláusula previa con OR.

orSub()  : self

Equivale a `sub()` pero unido a la cláusula previa con OR.

orXlike()  : self

Equivale a `xlike()` pero unido a la cláusula previa con OR.

regexp()  : self

Crea `campo REGEXP value` (la sintaxis exacta depende del motor, vía `getOperator`).

sql()  : string

Renderiza esta cláusula simple como SQL (sin prefijo `WHERE` ni el conector `operation`).

sub()  : self

Agrupa varias cláusulas en una sub-condición que se renderizará entre paréntesis.

useField()  : self

Habilita la interpretación del prefijo `field:` en los valores para esta condición.

xlike()  : self

Crea una búsqueda multipalabra: divide `$value` por espacios y aplica un LIKE a cada palabra, combinándolos con AND (la fila debe contener todas las palabras).

db()  : DataBase

sqlColumn()  : string

sqlOperatorBetween()  : string

sqlOperatorIn()  : string

sqlOperatorLike()  : string

sqlOperatorXLike()  : string

sqlValue()  : string