summaryrefslogtreecommitdiffstats
path: root/library/Icingadb/Common/HostStates.php
blob: b3a9473eeac85823cef99168ee6c51358763de0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<?php

/* Icinga DB Web | (c) 2020 Icinga GmbH | GPLv2 */

namespace Icinga\Module\Icingadb\Common;

/**
 * Collection of possible host states.
 */
class HostStates
{
    const UP = 0;

    const DOWN = 1;

    const UNREACHABLE = 2;

    const PENDING = 99;

    /**
     * Get the integer value of the given textual host state
     *
     * @param string $state
     *
     * @return int
     *
     * @throws \InvalidArgumentException If the given host state is invalid, i.e. not known
     */
    public static function int(string $state): int
    {
        switch (strtolower($state)) {
            case 'up':
                $int = self::UP;
                break;
            case 'down':
                $int = self::DOWN;
                break;
            case 'unreachable':
                $int = self::UNREACHABLE;
                break;
            case 'pending':
                $int = self::PENDING;
                break;
            default:
                throw new \InvalidArgumentException(sprintf('Invalid host state %d', $state));
        }

        return $int;
    }

    /**
     * Get the textual representation of the passed host state
     *
     * @param int|null $state
     *
     * @return string
     *
     * @throws \InvalidArgumentException If the given host state is invalid, i.e. not known
     */
    public static function text(int $state = null): string
    {
        switch (true) {
            case $state === self::UP:
                $text = 'up';
                break;
            case $state === self::DOWN:
                $text = 'down';
                break;
            case $state === self::UNREACHABLE:
                $text = 'unreachable';
                break;
            case $state === self::PENDING:
                $text = 'pending';
                break;
            case $state === null:
                $text = 'not-available';
                break;
            default:
                throw new \InvalidArgumentException(sprintf('Invalid host state %d', $state));
        }

        return $text;
    }

    /**
     * Get the translated textual representation of the passed host state
     *
     * @param int|null $state
     *
     * @return string
     *
     * @throws \InvalidArgumentException If the given host state is invalid, i.e. not known
     */
    public static function translated(int $state = null): string
    {
        switch (true) {
            case $state === self::UP:
                $text = t('up');
                break;
            case $state === self::DOWN:
                $text = t('down');
                break;
            case $state === self::UNREACHABLE:
                $text = t('unreachable');
                break;
            case $state === self::PENDING:
                $text = t('pending');
                break;
            case $state === null:
                $text = t('not available');
                break;
            default:
                throw new \InvalidArgumentException(sprintf('Invalid host state %d', $state));
        }

        return $text;
    }
}