mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-08-27 21:15:40 +02:00
MINOR: Replaced usage of renamed classes with the new namespaced name. From: Andrew Short <andrewjshort@gmail.com> git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/trunk@90075 467b73ca-7a2a-4603-9d3b-597d59a354a9
250 lines
6.4 KiB
PHP
Executable File
250 lines
6.4 KiB
PHP
Executable File
<?php
|
|
/**
|
|
* Basic SOAP Server to access and modify DataObject instances.
|
|
* You can enable SOAP access on a DataObject by setting {@link DataObject::$api_access} to true.
|
|
* This means that you'll also enable a RESTful API through {@link RestfulServer}.
|
|
*
|
|
* Usage - Getting a record:
|
|
* <code>
|
|
* $c = new SoapClient('http://mysite.com/soap/v1/wsdl');
|
|
* echo $c->getXML("MyClassName", 99); // gets record #99 as xml
|
|
* </code>
|
|
*
|
|
* Usage - Updating a record:
|
|
* <code>
|
|
* $c = new SoapClient('http://mysite.com/soap/v1/wsdl');
|
|
* $data = array('MyProperty' => 'MyUpdatedValue');
|
|
* echo $c->putXML("MyClassName", 99, null, $data);
|
|
* </code>
|
|
*
|
|
* Usage - Creating a record:
|
|
* <code>
|
|
* $c = new SoapClient('http://mysite.com/soap/v1/wsdl');
|
|
* $data = array('MyProperty' => 'MyValue');
|
|
* echo $c->putXML("MyClassName", null, null, $data);
|
|
* </code>
|
|
*
|
|
* Usage - Creating a record:
|
|
* <code>
|
|
* $c = new SoapClient('http://mysite.com/soap/v1/wsdl');
|
|
* echo $c->deleteXML("MyClassName");
|
|
* </code>
|
|
*
|
|
* @todo Test relation methods
|
|
*
|
|
* @package sapphire
|
|
* @subpackage api
|
|
*/
|
|
class SOAPModelAccess extends SapphireSoapServer {
|
|
|
|
public static $methods = array(
|
|
'getXML' => array(
|
|
'class' => 'string',
|
|
'id' => 'int',
|
|
'relation' => 'string',
|
|
'_returns' => 'string',
|
|
),
|
|
'getJSON' => array(
|
|
'class' => 'string',
|
|
'id' => 'int',
|
|
'relation' => 'string',
|
|
'_returns' => 'string',
|
|
),
|
|
'putXML' => array(
|
|
'class' => 'string',
|
|
'id' => 'int',
|
|
'relation' => 'string',
|
|
'data' => 'string',
|
|
'username' => 'string',
|
|
'password' => 'string',
|
|
'_returns' => 'boolean',
|
|
),
|
|
'putJSON' => array(
|
|
'class' => 'string',
|
|
'id' => 'int',
|
|
'relation' => 'string',
|
|
'_returns' => 'boolean',
|
|
),
|
|
);
|
|
|
|
function Link($action = null) {
|
|
return Controller::join_links("soap/v1/", $action);
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful GET requests with XML data.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @return string
|
|
*/
|
|
function getXML($class, $id, $relation = false, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'xml'),
|
|
null,
|
|
null,
|
|
'GET'
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful GET requests with JSON data.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @param string $username
|
|
* @param string $password
|
|
* @return string
|
|
*/
|
|
function getJSON($class, $id, $relation = false, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'json'),
|
|
null,
|
|
null,
|
|
'GET'
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful POST and PUT requests with XML data.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @param array $data
|
|
* @param string $username
|
|
* @param string $password
|
|
* @return string
|
|
*/
|
|
function putXML($class, $id = false, $relation = false, $data, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'xml'),
|
|
array(),
|
|
null,
|
|
($id) ? 'PUT' : 'POST',
|
|
$data
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful POST and PUT requests with JSON data.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @param array $data
|
|
* @param string $username
|
|
* @param string $password
|
|
* @return string
|
|
*/
|
|
function putJSON($class = false, $id = false, $relation = false, $data, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'json'),
|
|
array(),
|
|
null,
|
|
($id) ? 'PUT' : 'POST',
|
|
$data
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful DELETE requests.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @param string $username
|
|
* @param string $password
|
|
* @return string
|
|
*/
|
|
function deleteXML($class, $id, $relation = false, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'xml'),
|
|
null,
|
|
null,
|
|
'DELETE'
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Used to emulate RESTful DELETE requests.
|
|
*
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation Relation name
|
|
* @param string $username
|
|
* @param string $password
|
|
* @return string
|
|
*/
|
|
function deleteJSON($class, $id, $relation = false, $username = null, $password = null) {
|
|
$this->authenticate($username, $password);
|
|
|
|
$response = Director::test(
|
|
$this->buildRestfulURL($class, $id, $relation, 'json'),
|
|
null,
|
|
null,
|
|
'DELETE'
|
|
);
|
|
|
|
return ($response->isError()) ? $this->getErrorMessage($response) : $response->getBody();
|
|
}
|
|
|
|
/**
|
|
* Faking an HTTP Basicauth login in the PHP environment
|
|
* that RestfulServer can pick up.
|
|
*
|
|
* @param string $username Username
|
|
* @param string $password Plaintext password
|
|
*/
|
|
protected function authenticate($username, $password) {
|
|
if(is_string($username)) $_SERVER['PHP_AUTH_USER'] = $username;
|
|
if(is_string($password)) $_SERVER['PHP_AUTH_PW'] = $password;
|
|
}
|
|
|
|
/**
|
|
* @param string $class
|
|
* @param Number $id
|
|
* @param string $relation
|
|
* @param string $extension
|
|
* @return string
|
|
*/
|
|
protected function buildRestfulURL($class, $id, $relation, $extension) {
|
|
$url = "api/v1/{$class}";
|
|
if($id) $url .= "/{$id}";
|
|
if($relation) $url .= "/{$relation}";
|
|
if($extension) $url .= "/.{$extension}";
|
|
return $url;
|
|
}
|
|
|
|
/**
|
|
* @param SS_HTTPResponse $response
|
|
* @return string XML string containing the HTTP error message
|
|
*/
|
|
protected function getErrorMessage($response) {
|
|
return "<error type=\"authentication\" code=\"" . $response->getStatusCode() . "\">" . $response->getStatusDescription() . "</error>";
|
|
}
|
|
}
|
|
|
|
?>
|