77 lines
2.4 KiB
PHP
77 lines
2.4 KiB
PHP
<?php
|
|
namespace nulib\schema\_list;
|
|
|
|
use nulib\ref\schema\ref_schema;
|
|
use nulib\ValueException;
|
|
use nulib\schema\Schema;
|
|
use nulib\schema\Wrapper;
|
|
|
|
class ListSchema extends Schema {
|
|
/** @var array meta-schema d'un schéma de nature liste */
|
|
const METASCHEMA = ref_schema::LIST_METASCHEMA;
|
|
|
|
/**
|
|
* indiquer si $definition est une définition de schéma de nature liste que
|
|
* {@link normalize()} pourrait normaliser
|
|
*/
|
|
static function isa_definition($definition): bool {
|
|
if (!is_array($definition)) return false;
|
|
# nature explicitement spécifiée
|
|
if (self::have_nature($definition, $nature)) {
|
|
return $nature === "list";
|
|
}
|
|
# un unique élément tableau à l'index 0
|
|
$count = count($definition);
|
|
$haveIndex0 = array_key_exists(0, $definition);
|
|
return $count == 1 && $haveIndex0 && is_array($definition[0]);
|
|
}
|
|
|
|
static function normalize($definition, $definitionKey=null): array {
|
|
if (!is_array($definition)) $definition = [$definition];
|
|
if (!self::have_nature($definition)) {
|
|
$definition = [
|
|
"?array",
|
|
"" => "list",
|
|
"schema" => $definition[0],
|
|
];
|
|
}
|
|
self::_normalize_definition($definition, $definitionKey);
|
|
self::_ensure_nature($definition, "list", "array");
|
|
return $definition;
|
|
}
|
|
|
|
function __construct($definition=null, $definitionKey=null, bool $normalize=true) {
|
|
if ($definition === null) $definition = static::SCHEMA;
|
|
if ($normalize) {
|
|
$definition = self::normalize($definition, $definitionKey);
|
|
$this->_definition = $definition;
|
|
self::_ensure_type($definition);
|
|
self::_ensure_schema_instances($definition);
|
|
}
|
|
$this->definition = $definition;
|
|
}
|
|
|
|
const KEYS = [null];
|
|
|
|
function getKeys(): array {
|
|
return self::KEYS;
|
|
}
|
|
|
|
public function getSchema($key=false): Schema {
|
|
if ($key !== null) throw ValueException::invalid_key($key);
|
|
return $this;
|
|
}
|
|
|
|
protected function newWrapper(): ListWrapper {
|
|
return new ListWrapper($this);
|
|
}
|
|
|
|
function getWrapper(&$value=null, $valueKey=null, ?array $params = null, ?Wrapper &$wrapper=null): ListWrapper {
|
|
# si pas de valeur ni de wrapper, pas de vérification et donc pas d'exception
|
|
# cf le code similaire dans ScalarWrapper::__construct()
|
|
$verifix = $value !== null || $wrapper !== null;
|
|
if (!($wrapper instanceof ListWrapper)) $wrapper = $this->newWrapper();
|
|
return $wrapper->reset($value, $valueKey, $verifix);
|
|
}
|
|
}
|