\nre\agentsToplevelAgent

The ToplevelAgent assumes the task of a FrontController. There is only one per request.

Summary

Methods

Properties

Constants

load()
factory()
run()
render()
getIntermediateAgent()

$controller

INLINEERROR_AGENT
STAGE_LOAD
STAGE_RUN

__construct()
actionConstruct()
loadController()
log()
addSubAgent()
_addSubAgent()

$log
$subAgents

N/A

getAgentType()
getClassName()
newSubAgent()
renderSubAgent()
errorInline()
newInlineError()
newInlineErrorService()
loadIntermediateAgent()
_loadIntermediateAgent()
_run()
runIntermediateAgent()
error()

$request
$response
$layout
$intermediateAgent

N/A

File: agents/ToplevelAgent.inc
Package: Default
Class hierarchy: \nre\core\Agent

\nre\agents\ToplevelAgent

Tags

author	coderkun olli@coderkun.de

Constants

INLINEERROR_AGENT

INLINEERROR_AGENT

Name of BottomlevelAgent for showing inline errors

STAGE_LOAD

STAGE_LOAD

Stage: Load

STAGE_RUN

STAGE_RUN

Stage: Run

Properties

$controller

$controller : \nre\core\Controller

Controller of this Agent

Type

\nre\core\Controller

$log

$log : \nre\core\Logger

Log-system

Type

\nre\core\Logger

$subAgents

$subAgents : array

SubAgents

Type

array

$request

$request : \nre\agents\Request

Current request

Type

\nre\agents\Request

$response

$response : \nre\agents\Response

Current response

Type

\nre\agents\Response

$layout

$layout : \nre\agents\Layout

Layout instace

Type

\nre\agents\Layout

$intermediateAgent

$intermediateAgent : \nre\agents\IntermediateAgent

IntermediateAgent instance

Type

\nre\agents\IntermediateAgent

Methods

load()

load(string  $agentName)

Load the class of an Agent.

Parameters

string

$agentName

Name of the Agent to load

Throws

\nre\exceptions\AgentNotFoundException
\nre\core\AgentNotValidException

static

Inherited from: \nre\core\Agent

Tags

static

factory()

factory(string  $agentName, \nre\core\Request  $request, \nre\core\Response  $response, \nre\core\Logger  $log = null)

Instantiate an Agent (Factory Pattern).

Parameters

string	$agentName	Name of the Agent to instantiate
\nre\core\Request	$request	Current request
\nre\core\Response	$response
\nre\core\Logger	$log	Log-system

Throws

\nre\core\DatamodelException
\nre\core\DriverNotValidException
\nre\core\DriverNotFoundException
\nre\core\ViewNotFoundException
\nre\core\ModelNotValidException
\nre\core\ModelNotFoundException
\nre\core\ControllerNotValidException
\nre\core\ControllerNotFoundException

static

Inherited from: \nre\core\Agent

Tags

static

run()

run(\nre\agents\Request  $request, \nre\agents\Response  $response) : \nre\agents\Exception

Run the Controller of this Agent and its SubAgents.

Parameters

\nre\agents\Request	$request	Current request
\nre\agents\Response	$response	Current response

Throws

\nre\agents\ServiceUnavailableException

Returns

\nre\agents\Exception —

Last occurred exception of SubAgents

render()

render(array  $data = array()) : string

Generate output of the Controller of this Agent and its SubAgents.

Parameters

array

$data

View data

Returns

string —

Generated output

getIntermediateAgent()

getIntermediateAgent() : \nre\agents\IntermediateAgent

Return the IntermediateAgent.

Returns

\nre\agents\IntermediateAgent —

IntermediateAgent

__construct()

__construct(\nre\agents\Request  $request, \nre\core\Response  $response, \nre\agents\Logger  $log = null)

Construct a ToplevelAgent.

Parameters

\nre\agents\Request	$request	Current request
\nre\core\Response	$response
\nre\agents\Logger	$log	Log-system

Throws

\nre\agents\ServiceUnavailableException
\nre\agents\DatamodelException
\nre\agents\DriverNotValidException
\nre\agents\DriverNotFoundException
\nre\agents\ViewNotFoundException
\nre\agents\ModelNotValidException
\nre\agents\ModelNotFoundException
\nre\agents\ControllerNotValidException
\nre\agents\ControllerNotFoundException

actionConstruct()

actionConstruct()

Construct SubAgents (per Action).

loadController()

loadController()

Load the Controller of this Agent.

Throws

\nre\core\DatamodelException
\nre\core\DriverNotValidException
\nre\core\DriverNotFoundException
\nre\core\ViewNotFoundException
\nre\core\ModelNotValidException
\nre\core\ModelNotFoundException
\nre\core\ControllerNotValidException
\nre\core\ControllerNotFoundException

log()

log(\nre\core\Exception  $exception, integer  $logMode)

Log an error.

Parameters

\nre\core\Exception	$exception	Occurred exception
integer	$logMode	Log mode

addSubAgent()

addSubAgent(string  $agentName)

Load a SubAgent and add it.

Parameters

string

$agentName

Name of the Agent to load

Throws

\nre\agents\ServiceUnavailableException
\nre\agents\FatalDatamodelException
\nre\agents\AgentNotFoundException
\nre\agents\AgentNotValidException

_addSubAgent()

_addSubAgent(string  $agentName)

Load a SubAgent and add it.

Parameters

string

$agentName

Name of the Agent to load

Throws

\nre\core\ServiceUnavailableException
\nre\core\DatamodelException
\nre\core\AgentNotFoundException
\nre\core\AgentNotValidException

getAgentType()

getAgentType() : string

Determine the type of an Agent.

Returns

string —

Agent type

static

Inherited from: \nre\core\Agent

Tags

static

getClassName()

getClassName(string  $agentName, string  $agentType) : string

Determine the classname for the given Agent name.

Parameters

string	$agentName	Agent name to get classname of
string	$agentType	Agent type of given Agent name

Returns

string —

Classname for the Agent name

static

Inherited from: \nre\core\Agent

Tags

static

newSubAgent()

newSubAgent(string  $agentName) : array

Create a new SubAgent.

Parameters

string

$agentName

Agent name

Throws

\nre\core\DatamodelException

Returns

array —

SubAgent

renderSubAgent()

renderSubAgent(array  $subAgent) : string

Render a SubAgent.

Parameters

array

$subAgent

SubAgent to render

Returns

string —

Generated output

errorInline()

errorInline(  $subAgent,   $request, \nre\core\Excepiton  $exception) : array

Handle the exception of a SubAgent.

Parameters

	$subAgent
	$request
\nre\core\Excepiton	$exception	Occurred exception

Returns

array —

InlineError-SubAgent

newInlineError()

newInlineError(string  $label, \nre\core\Exception  $exception)

Create a new InlineError.

Parameters

string	$label	Name of the original Agent
\nre\core\Exception	$exception	Occurred exception

newInlineErrorService()

newInlineErrorService()

Handle a hardcore error that could not be handled by the system.

loadIntermediateAgent()

loadIntermediateAgent()

Load IntermediateAgent defined by the current request.

Throws

\nre\agents\ServiceUnavailableException

_loadIntermediateAgent()

_loadIntermediateAgent()

Load IntermediateAgent defined by the current request.

Throws

\nre\agents\ServiceUnavailableException

_run()

_run(\nre\agents\Request  $request, \nre\agents\Response  $response) : \nre\agents\Exception

Run the Controller of this Agent and its SubAgents.

Parameters

\nre\agents\Request	$request	Current request
\nre\agents\Response	$response	Current response

Throws

\nre\agents\AccessDeniedException
\nre\agents\IdNotFoundException
\nre\agents\ServiceUnavailableException
\nre\agents\DatamodelException

Returns

\nre\agents\Exception —

Last occurred exception of SubAgents

runIntermediateAgent()

runIntermediateAgent()

Run IntermediateAgent.

Throws

\nre\agents\AccessDeniedException
\nre\agents\ParamsNotValidException
\nre\agents\IdNotFoundException
\nre\agents\ServiceUnavailableException
\nre\agents\DatamodelException

error()

error(\nre\agents\Exception  $exception, integer  $httpStatusCode, string  $stage = self::STAGE_LOAD)

Handle an error that occurred during loading/cnostructing/running of the IntermediateAgent.

Parameters

\nre\agents\Exception	$exception	Occurred exception
integer	$httpStatusCode	HTTP-statuscode
string	$stage	Stage of execution

Throws

\nre\agents\ServiceUnavailableException