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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<?php
/**
* An abstract class that defines shared components for products that use
* OpenStack Nova
*
* @copyright 2012-2013 Rackspace Hosting, Inc.
* See COPYING for licensing information
*
* @package phpOpenCloud
* @version 1.0
* @author Glen Campbell <glen.campbell@rackspace.com>
*/
namespace OpenCloud\Common;
use OpenCloud\OpenStack;
use OpenCloud\Common\Lang;
use OpenCloud\Compute\Flavor;
/**
* Nova is an abstraction layer for the OpenStack compute service.
*
* Nova is used as a basis for several products, including Compute services
* as well as Rackspace's Cloud Databases. This class is, in essence, a vehicle
* for sharing common code between those other classes.
*/
abstract class Nova extends Service
{
private $_url;
/**
* Called when creating a new Compute service object
*
* _NOTE_ that the order of parameters for this is *different* from the
* parent Service class. This is because the earlier parameters are the
* ones that most typically change, whereas the later ones are not
* modified as often.
*
* @param \OpenCloud\Identity $conn - a connection object
* @param string $serviceRegion - identifies the region of this Compute
* service
* @param string $urltype - identifies the URL type ("publicURL",
* "privateURL")
* @param string $serviceName - identifies the name of the service in the
* catalog
*/
public function __construct(
OpenStack $conn,
$serviceType,
$serviceName,
$serviceRegion,
$urltype
) {
parent::__construct(
$conn,
$serviceType,
$serviceName,
$serviceRegion,
$urltype
);
$this->_url = Lang::noslash(parent::Url());
$this->getLogger()->info(Lang::translate('Initializing Nova...'));
}
/**
* Returns a flavor from the service
*
* This is a factory method and should generally be called instead of
* creating a Flavor object directly.
*
* @api
* @param string $id - if supplied, the Flavor identified by this is
* retrieved
* @return Compute\Flavor object
*/
public function Flavor($id = null)
{
return new Flavor($this, $id);
}
/**
* Returns a list of Flavor objects
*
* This is a factory method and should generally be called instead of
* creating a FlavorList object directly.
*
* @api
* @param boolean $details - if TRUE (the default), returns full details.
* Set to FALSE to retrieve minimal details and possibly improve
* performance.
* @param array $filter - optional key/value pairs for creating query
* strings
* @return Collection (or FALSE on an error)
*/
public function FlavorList($details = true, array $filter = array())
{
if ($details) {
$url = $this->Url(Flavor::ResourceName().'/detail', $filter);
} else {
$url = $this->Url(Flavor::ResourceName(), $filter);
}
return $this->Collection('\OpenCloud\Compute\Flavor', $url);
}
/**
* Gets a request from an HTTP source and ensures that the
* content type is always "application/json"
*
* This is a simple subclass of the parent::Request() method that ensures
* that all Compute requests use application/json as the Content-Type:
*
* @param string $url - the URL of the request
* @param string $method - the HTTP method ("GET" by default)
* @param array $headers - an associative array of headers to pass to
* the request
* @param string $body - optional body for POST or PUT requests
* @return \Rackspace\HttpResult object
*/
public function Request($url, $method = 'GET', array $headers = array(), $body = null)
{
$headers['Content-Type'] = RAXSDK_CONTENT_TYPE_JSON;
return parent::Request($url, $method, $headers, $body);
}
/**
* Loads the available namespaces from the /extensions resource
*/
protected function load_namespaces()
{
$ext = $this->Extensions();
foreach($ext as $obj) {
$this->_namespaces[] = $obj->alias;
}
}
}
|
