RegistryTrait.php

<?php
 
/*
 *
 *  ____            _        _   __  __ _                  __  __ ____
 * |  _ \ ___   ___| | _____| |_|  \/  (_)_ __   ___      |  \/  |  _ \
 * | |_) / _ \ / __| |/ / _ \ __| |\/| | | '_ \ / _ \_____| |\/| | |_) |
 * |  __/ (_) | (__|   <  __/ |_| |  | | | | | |  __/_____| |  | |  __/
 * |_|   \___/ \___|_|\_\___|\__|_|  |_|_|_| |_|\___|     |_|  |_|_|
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * @author PocketMine Team
 * @link http://www.pocketmine.net/
 *
 *
 */
 
declare(strict_types=1);
 
namespace pocketmine\utils;
 
use function array_map;
use function count;
use function mb_strtoupper;
use function preg_match;
 
trait RegistryTrait{
    private static $members = null;
 
    private static function verifyName(string $name) : void{
        if(preg_match('/^(?!\d)[A-Za-z\d_]+$/u', $name) === 0){
            throw new \InvalidArgumentException("Invalid member name \"$name\", should only contain letters, numbers and underscores, and must not start with a number");
        }
    }
 
    private static function _registryRegister(string $name, object $member) : void{
        if(self::$members === null){
            throw new AssumptionFailedError("Cannot register members outside of " . self::class . "::setup()");
        }
        self::verifyName($name);
        $upperName = mb_strtoupper($name);
        if(isset(self::$members[$upperName])){
            throw new \InvalidArgumentException("\"$upperName\" is already reserved");
        }
        self::$members[$upperName] = $member;
    }
 
    abstract protected static function setup() : void;
 
    protected static function checkInit() : void{
        if(self::$members === null){
            self::$members = [];
            self::setup();
        }
    }
 
    private static function _registryFromString(string $name) : object{
        self::checkInit();
        if(self::$members === null){
            throw new AssumptionFailedError(self::class . "::checkInit() did not initialize self::\$members correctly");
        }
        $upperName = mb_strtoupper($name);
        if(!isset(self::$members[$upperName])){
            throw new \InvalidArgumentException("No such registry member: " . self::class . "::" . $upperName);
        }
        return self::preprocessMember(self::$members[$upperName]);
    }
 
    protected static function preprocessMember(object $member) : object{
        return $member;
    }
 
    public static function __callStatic(string $name, array $arguments) : object{
        if(count($arguments) > 0){
            throw new \ArgumentCountError("Expected exactly 0 arguments, " . count($arguments) . " passed");
        }
 
        //fast path
        if(self::$members !== null && isset(self::$members[$name])){
            return self::preprocessMember(self::$members[$name]);
        }
 
        //fallback
        try{
            return self::_registryFromString($name);
        }catch(\InvalidArgumentException $e){
            throw new \Error($e->getMessage(), 0, $e);
        }
    }
 
    private static function _registryGetAll() : array{
        self::checkInit();
        return array_map(self::preprocessMember(...), self::$members ?? throw new AssumptionFailedError(self::class . "::checkInit() did not initialize self::\$members correctly"));
    }
}