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
|
<?php
namespace Dropbox;
/**
* The Dropbox web API accesses three hosts; this structure holds the
* names of those three hosts. This is primarily for mocking things out
* during testing. Most of the time you won't have to deal with this class
* directly, and even when you do, you'll just use the default
* value: {@link Host::getDefault()}.
*
* @internal
*/
final class Host
{
/**
* Returns a Host object configured with the three standard Dropbox host: "api.dropbox.com",
* "api-content.dropbox.com", and "www.dropbox.com"
*
* @return Host
*/
static function getDefault()
{
if (!self::$defaultValue) {
self::$defaultValue = new Host("api.dropbox.com", "api-content.dropbox.com", "www.dropbox.com");
}
return self::$defaultValue;
}
private static $defaultValue;
/** @var string */
private $api;
/** @var string */
private $content;
/** @var string */
private $web;
/**
* Constructor.
*
* @param string $api
* See {@link getApi()}
* @param string $content
* See {@link getContent()}
* @param string $web
* See {@link getWeb()}
*/
function __construct($api, $content, $web)
{
$this->api = $api;
$this->content = $content;
$this->web = $web;
}
/**
* Returns the host name of the main Dropbox API server.
* The default is "api.dropbox.com".
*
* @return string
*/
function getApi() { return $this->api; }
/**
* Returns the host name of the Dropbox API content server.
* The default is "api-content.dropbox.com".
*
* @return string
*/
function getContent() { return $this->content; }
/**
* Returns the host name of the Dropbox web server. Used during user authorization.
* The default is "www.dropbox.com".
*
* @return string
*/
function getWeb() { return $this->web; }
/**
* Check that a function argument is of type <code>Host</code>.
*
* @internal
*/
static function checkArg($argName, $argValue)
{
if (!($argValue instanceof self)) Checker::throwError($argName, $argValue, __CLASS__);
}
/**
* Check that a function argument is either <code>null</code> or of type
* <code>Host</code>.
*
* @internal
*/
static function checkArgOrNull($argName, $argValue)
{
if ($argValue === null) return;
if (!($argValue instanceof self)) Checker::throwError($argName, $argValue, __CLASS__);
}
}
|