API Documentation

Service/Nirvanix/Namespace/Base.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Service  
subpackage
Nirvanix  
version
$Id: Base.php 23775 2011-03-01 17:25:24Z ralph $  

\Zend_Service_Nirvanix_Namespace_Base

The Nirvanix web services are split into namespaces. This is a proxy class representing one namespace. It allows calls to the namespace to be made by PHP object calls rather than by having to construct HTTP client requests.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Service  
subpackage
Nirvanix  

Properties

Propertyprotected  $_defaults= 'array'

Defaults for POST parameters. When a request to the service is to be made, the POST parameters are merged into these. This is a convenience feature so parameters that are repeatedly required like sessionToken do not need to be supplied again and again by the user.

Default valuearrayDetails
Type
$_defaults
array
Propertyprotectedstring  $_host= 'http://services.nirvanix.com'

Host to use for calls to this Nirvanix namespace. It is possible that the user will wish to use different hosts for different namespaces.

Default valuehttp://services.nirvanix.comDetails
Type
string
Propertyprotected\Zend_Http_Client  $_httpClient= ''

HTTP client instance that will be used to make calls to the Nirvanix web services.

Details
Type
\Zend_Http_Client
Propertyprotectedstring  $_namespace= ''

Name of this namespace as used in the URL.

Details
Type
string

Methods

methodpublic__call( string $methodName, array $args ) : \Zend_Service_Nirvanix_Response

When a method call is made against this proxy, convert it to an HTTP request to make against the Nirvanix REST service.

$imfs->DeleteFiles(array('filePath' => 'foo'));

Assuming this object was proxying the IMFS namespace, the method call above would call the DeleteFiles command. The POST parameters would be filePath, merged with the $this->_defaults (containing the sessionToken).

Parameters
Name Type Description
$methodName string Name of the command to call on this namespace.
$args array Only the first is used and it must be an array. It contains the POST params.
Returns
Type Description
\Zend_Service_Nirvanix_Response
methodpublic__construct( array $options = array ) : void

Class constructor.

Parameters
Name Type Description
$options array Options and dependency injection
methodprotected_makeUri( string $methodName ) : string

Make a complete URI from an RPC method name. All Nirvanix REST service URIs use the same format.

Parameters
Name Type Description
$methodName string RPC method name
Returns
Type Description
string
methodprotected_wrapResponse( \Zend_Http_Response $httpResponse ) : \Zend_Service_Nirvanix_Response

All Nirvanix REST service calls return an XML payload. This method makes a Zend_Service_Nirvanix_Response from that XML payload.

Parameters
Name Type Description
$httpResponse \Zend_Http_Response Raw response from Nirvanix
Returns
Type Description
\Zend_Service_Nirvanix_Response Wrapped response
methodpublicgetHttpClient( ) : \Zend_Http_Client

Return the HTTP client used for this namespace. This is useful for inspecting the last request or directly interacting with the HTTP client.

Returns
Type Description
\Zend_Http_Client
Documentation was generated by DocBlox 0.13.3.