administrador.base.orm.columnas.columnas_full - gamboamartin/administrador GitHub Wiki

columnas_full

La función columnas_full es una función privada que se encarga de generar la cadena completa de columnas SQL para una consulta, combinando múltiples opciones y configuraciones. Evalúa si se deben aplicar columnas por tabla y utiliza la lógica correspondiente para generar la salida final.

Signatura

private function columnas_full(array $columnas_by_table, bool $columnas_en_bruto, array $columnas_sql, array $extension_estructura, array $extra_join, modelo_base $modelo, array $renombres, array $tablas_select): array|string

Parámetros

• array $columnas_by_table:
  Un array que contiene los nombres de las tablas que se van a utilizar en la consulta SQL. Este array solo se debe utilizar si la lógica de columnas por tabla está habilitada.

• bool $columnas_en_bruto:
  Un valor booleano que indica si las columnas deben ser procesadas en su forma original (true) o si deben ser ajustadas y personalizadas (false).

• array $columnas_sql:
  Un array que contiene columnas SQL adicionales o personalizadas que pueden ser integradas en la cadena resultante.

• array $extension_estructura:
  Un array que define la estructura de extensión para la consulta SQL. Las claves del array son los nombres de las tablas y los valores contienen los datos específicos relacionados con la tabla.

• array $extra_join:
  Un array que contiene información sobre columnas adicionales que se deben agregar a la consulta desde uniones (JOIN) extras.

• modelo_base $modelo:
  Una instancia de la clase modelo_base que representa el modelo de datos sobre el que se está trabajando. Este objeto proporciona los metadatos y atributos necesarios para ajustar las columnas.

• array $renombres:
  Un array que contiene las tablas y los nombres alternativos (renombres) que deben ser aplicados. Las claves del array son los nombres de las tablas, y los valores son arrays que contienen la información relacionada con el renombrado de columnas.

• array $tablas_select:
  Un array que contiene las tablas de las cuales se desean seleccionar columnas. Las claves del array son los nombres de las tablas y los valores son los nombres de estas tablas.

Retorno

• array|string:
  Retorna una cadena que representa las columnas SQL generadas y ajustadas para su uso en la consulta. En caso de error, retorna un array de error generado por $this->error->error().

Explicación Detallada

1. Verificación de aplicación de columnas por tabla:

   • La función llama a aplica_columnas_by_table() para determinar si se debe aplicar la lógica de columnas por tabla basada en el array $columnas_by_table.
   • Si ocurre un error durante esta verificación, se genera un mensaje de error y se retorna un array de error.

2. Generación de columnas:

   • La función llama a columnas() para generar la cadena de columnas SQL, utilizando los parámetros proporcionados y la evaluación de aplica_columnas_by_table.
   • Si ocurre un error durante la generación de columnas, se genera un mensaje de error y se retorna un array de error.

3. Retorno de las columnas generadas:

   • Si todas las etapas se completan con éxito, la función retorna la cadena de columnas SQL generadas y ajustadas.

Ejemplos

$columnas_by_table = ['usuarios', 'pedidos'];
$columnas_en_bruto = false;
$columnas_sql = ['id', 'nombre', 'email'];
$extension_estructura = ['usuarios' => ['campo1', 'campo2']];
$extra_join = ['extra_campo' => 'valor_extra'];
$modelo = new modelo_base();
$renombres = ['usuarios' => ['renombre' => 'usuarios_activos']];
$tablas_select = ['usuarios' => 'usuarios', 'pedidos' => 'pedidos'];

$resultado = $this->columnas_full($columnas_by_table, $columnas_en_bruto, $columnas_sql, $extension_estructura, $extra_join, $modelo, $renombres, $tablas_select);

// Resultado esperado:
// Una cadena con las columnas SQL generadas y ajustadas.
// Un array de error si ocurre algún problema.

Código de la Función

private function columnas_full(array $columnas_by_table, bool $columnas_en_bruto, array $columnas_sql,
                                   array $extension_estructura, array $extra_join, modelo_base $modelo,
                                   array $renombres, array $tablas_select): array|string
    {

        $aplica_columnas_by_table = $this->aplica_columnas_by_table(columnas_by_table: $columnas_by_table);
        if (errores::$error) {
            return $this->error->error(mensaje: 'Error al verificar aplicacion de columnas en modelo '.$modelo->tabla,
                data: $aplica_columnas_by_table);
        }

        $columnas = $this->columnas(aplica_columnas_by_table: $aplica_columnas_by_table,
            columnas_by_table: $columnas_by_table, columnas_en_bruto: $columnas_en_bruto, columnas_sql: $columnas_sql,
            extension_estructura: $extension_estructura, extra_join: $extra_join, modelo: $modelo,
            renombres: $renombres, tablas_select: $tablas_select);
        if (errores::$error) {
            return $this->error->error(mensaje: 'Error al integrar columnas en modelo '.$modelo->tabla,
                data: $columnas);
        }


        return $columnas;


    }