monitoring/commands: Introduce `ObjectCommand' for commands that involve a Icinga object

refs #6593

modules/monitoring/library/Monitoring/Command/Common/ObjectCommand.php

@@ -0,0 +1,62 @@
+<?php
+// {{{ICINGA_LICENSE_HEADER}}}
+// {{{ICINGA_LICENSE_HEADER}}}
+
+namespace Icinga\Module\Monitoring\Command\Common;
+
+use Icinga\Module\Monitoring\Command\IcingaCommand;
+use Icinga\Module\Monitoring\Object\MonitoredObject;
+
+/**
+ * Base class for commands that involve a monitored object, i.e. a host or service
+ */
+abstract class ObjectCommand extends IcingaCommand
+{
+    /**
+     * Type host
+     */
+    const TYPE_HOST = MonitoredObject::TYPE_HOST;
+
+    /**
+     * Type service
+     */
+    const TYPE_SERVICE = MonitoredObject::TYPE_SERVICE;
+
+    /**
+     * Allowed Icinga object types for the command
+     *
+     * @var string[]
+     */
+    protected $allowedObjects = array();
+
+    /**
+     * Involved object
+     *
+     * @var MonitoredObject
+     */
+    protected $object;
+
+    /**
+     * Set the involved object
+     *
+     * @param   MonitoredObject $object
+     *
+     * @return  $this
+     */
+    public function setObject(MonitoredObject $object)
+    {
+        $object->assertOneOf($this->allowedObjects);
+        $this->object = $object;
+        return $this;
+    }
+
+    /**
+     * Get the involved object
+     *
+     * @return MonitoredObject
+     */
+    public function getObject()
+    {
+        return $this->object;
+    }
+}