mirror of
https://github.com/Icinga/icingaweb2.git
synced 2025-07-20 20:34:25 +02:00
monitoring/commands: Replace Command' with
IcingaCommand'
Since there's already a `Cli\Command', `Command' is now named `IcingaCommand'. All concrete Icinga commands should extend `IcingaCommand' which handles command encoding. All other "features" of the `Command' object have been removed because theses "features" should be handled by upcoming concrete command classes. refs #6593
This commit is contained in:
parent
0e2e1bc005
commit
e7eae87f16
@ -1,177 +0,0 @@
|
|||||||
<?php
|
|
||||||
// {{{ICINGA_LICENSE_HEADER}}}
|
|
||||||
// {{{ICINGA_LICENSE_HEADER}}}
|
|
||||||
|
|
||||||
namespace Icinga\Protocol\Commandpipe;
|
|
||||||
|
|
||||||
use Icinga\Exception\ProgrammingError;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Base class for any concrete command implementation
|
|
||||||
*/
|
|
||||||
abstract class Command
|
|
||||||
{
|
|
||||||
/**
|
|
||||||
* Whether hosts are ignored in case of a host- or servicegroup
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $withoutHosts = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Whether services are ignored in case of a host- or servicegroup
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $withoutServices = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Whether child hosts are going to be included in case of a host command
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $withChildren = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Whether only services are going to be included in case of a host command
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $onlyServices = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Whether it is a global command or not
|
|
||||||
*
|
|
||||||
* @var bool
|
|
||||||
*/
|
|
||||||
protected $globalCommand = false;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set whether this command should only affect the services of a host- or servicegroup
|
|
||||||
*
|
|
||||||
* @param bool $state
|
|
||||||
* @return self
|
|
||||||
*/
|
|
||||||
public function excludeHosts($state = true)
|
|
||||||
{
|
|
||||||
$this->withoutHosts = (bool) $state;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set whether this command should only affect the hosts of a host- or servicegroup
|
|
||||||
*
|
|
||||||
* @param bool $state
|
|
||||||
* @return self
|
|
||||||
*/
|
|
||||||
public function excludeServices($state = true)
|
|
||||||
{
|
|
||||||
$this->withoutServices = (bool) $state;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set whether this command should also affect all children hosts of a host
|
|
||||||
*
|
|
||||||
* @param bool $state
|
|
||||||
* @return self
|
|
||||||
*/
|
|
||||||
public function includeChildren($state = true)
|
|
||||||
{
|
|
||||||
$this->withChildren = (bool) $state;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Set whether this command only affects the services associated with a particular host
|
|
||||||
*
|
|
||||||
* @param bool $state
|
|
||||||
* @return self
|
|
||||||
*/
|
|
||||||
public function excludeHost($state = true)
|
|
||||||
{
|
|
||||||
$this->onlyServices = (bool) $state;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Getter for flag whether a command is global
|
|
||||||
* @return bool
|
|
||||||
*/
|
|
||||||
public function provideGlobalCommand()
|
|
||||||
{
|
|
||||||
return (bool) $this->globalCommand;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return this command's arguments in the order expected by the actual command definition
|
|
||||||
*
|
|
||||||
* @return array
|
|
||||||
*/
|
|
||||||
abstract public function getArguments();
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the command as a string with the given host being inserted
|
|
||||||
*
|
|
||||||
* @param string $hostname The name of the host to insert
|
|
||||||
*
|
|
||||||
* @return string The string representation of the command
|
|
||||||
*/
|
|
||||||
abstract public function getHostCommand($hostname);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the command as a string with the given host and service being inserted
|
|
||||||
*
|
|
||||||
* @param string $hostname The name of the host to insert
|
|
||||||
* @param string $servicename The name of the service to insert
|
|
||||||
*
|
|
||||||
* @return string The string representation of the command
|
|
||||||
*/
|
|
||||||
abstract public function getServiceCommand($hostname, $servicename);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the command as a string with the given hostgroup being inserted
|
|
||||||
*
|
|
||||||
* @param string $hostgroup The name of the hostgroup to insert
|
|
||||||
*
|
|
||||||
* @return string The string representation of the command
|
|
||||||
*/
|
|
||||||
public function getHostgroupCommand($hostgroup)
|
|
||||||
{
|
|
||||||
throw new ProgrammingError(
|
|
||||||
'%s does not provide a hostgroup command',
|
|
||||||
get_class($this)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the command as a string with the given servicegroup being inserted
|
|
||||||
*
|
|
||||||
* @param string $servicegroup The name of the servicegroup to insert
|
|
||||||
*
|
|
||||||
* @return string The string representation of the command
|
|
||||||
*/
|
|
||||||
public function getServicegroupCommand($servicegroup)
|
|
||||||
{
|
|
||||||
throw new ProgrammingError(
|
|
||||||
'%s does not provide a servicegroup command',
|
|
||||||
get_class($this)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Return the command as a string for the whole instance
|
|
||||||
*
|
|
||||||
* @param string $instance
|
|
||||||
*
|
|
||||||
* @return string
|
|
||||||
* @throws ProgrammingError
|
|
||||||
*/
|
|
||||||
public function getGlobalCommand($instance = null)
|
|
||||||
{
|
|
||||||
throw new ProgrammingError(
|
|
||||||
'%s does not provide a global command',
|
|
||||||
getclass($this)
|
|
||||||
);
|
|
||||||
}
|
|
||||||
}
|
|
@ -0,0 +1,44 @@
|
|||||||
|
<?php
|
||||||
|
// {{{ICINGA_LICENSE_HEADER}}}
|
||||||
|
// {{{ICINGA_LICENSE_HEADER}}}
|
||||||
|
|
||||||
|
namespace Icinga\Module\Monitoring\Command;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base class for commands sent to an Icinga instance
|
||||||
|
*/
|
||||||
|
abstract class IcingaCommand
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Get the command string
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
abstract public function getCommandString();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Escape a command string
|
||||||
|
*
|
||||||
|
* @param string $commandString
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function escape($commandString)
|
||||||
|
{
|
||||||
|
return str_replace(array("\r", "\n"), array('\r', '\n'), $commandString);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the command as string with the current timestamp as the command submission time
|
||||||
|
*
|
||||||
|
* @return string
|
||||||
|
*/
|
||||||
|
public function __toString()
|
||||||
|
{
|
||||||
|
return sprintf(
|
||||||
|
'[%u] %s',
|
||||||
|
time(),
|
||||||
|
$this->escape($this->getCommandString())
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
Loading…
x
Reference in New Issue
Block a user