GenericContent.php

Go to the documentation of this file.

<?php
 
namespace Elgg\Controllers;
 
use Elgg\Exceptions\Http\ValidationException;
use Elgg\Exceptions\HttpException;
use Elgg\Http\Response;
 
abstract class GenericContent {
    
    protected ?\Elgg\Request $request = null;
    
    protected ?\Elgg\Router\Route $route = null;
    
    protected ?array $route_parts = null;
    
    final public function __invoke(\Elgg\Request $request): Response {
        $this->request = $request;
        $this->route = $request->getHttpRequest()?->getRoute();
        
        $this->getRouteParts();
        $this->assertValidRoute();
        
        return $this->handleRequest($request);
    }
    
    abstract protected function assertValidRoute(): void;
    
    abstract protected function handleRequest(\Elgg\Request $request): Response;
    
    abstract protected function getPageOptions(string $page, array $options): array;
    
    final protected function getRouteParts(): array {
        if (isset($this->route_parts)) {
            return $this->route_parts;
        }
        
        $route_name = $this->route?->getName();
        if (elgg_is_empty($route_name)) {
            throw new ValidationException('Missing route name');
        }
        
        $name_parts = explode(':', $route_name);
        if (count($name_parts) < 3) {
            throw new ValidationException('Unsupported route name configuration');
        }
        
        $this->route_parts = $name_parts;
        return $this->route_parts;
    }
    
    protected function getEntityType(): string {
        return $this->getRouteParts()[1];
    }
    
    protected function getEntitySubtype(): string {
        return $this->getRouteParts()[2];
    }
    
    abstract protected function getPage(): string;
}