<?php

namespace wcf\system\database\table\column;

/**
 * Represents a column of a database table.
 *
 * @author  Matthias Schmidt
 * @copyright   2001-2019 WoltLab GmbH
 * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
 * @package WoltLabSuite\Core\System\Database\Table\Column
 * @since   5.2
 */
interface IDatabaseTableColumn
{
    /**
     * Marks the column to be dropped and returns the column.
     *
     * @return  $this
     */
    public function drop(): static;

    /**
     * Returns the data used by `DatabaseEditor` to add the column to a table.
     */
    public function getData(): array;

    /**
     * Returns the name of the column.
     */
    public function getName(): string;

    /**
     * Returns the new name of the column or `null` if the column's name is unchanged.
     *
     * @since       5.4
     */
    public function getNewName(): ?string;

    /**
     * Returns the type of the column.
     */
    public function getType(): string;

    /**
     * Returns `true` if the values of the column cannot be `null`.
     */
    public function isNotNull(): bool;

    /**
     * Sets the name of the column and returns the column.
     *
     * @return  $this
     */
    public function name(string $name): static;

    /**
     * Sets if the values of the column cannot be `null`.
     *
     * @return  $this
     */
    public function notNull(bool $notNull = true): static;

    /**
     * Sets the new name of the column and returns the column.
     *
     * @since       5.4
     * @return $this
     */
    public function renameTo(string $newName): static;

    /**
     * Returns `true` if the column will be dropped.
     */
    public function willBeDropped(): bool;

    /**
     * Returns a `DatabaseTableColumn` object with the given name.
     *
     * @return  $this
     */
    public static function create(string $name): static;

    /**
     * Returns a `DatabaseTableColumn` object with the given name and data.
     *
     * @param array $data data returned by `DatabaseEditor::getColumns()`
     * @return  $this
     */
    public static function createFromData(string $name, array $data): static;
}