implemented basic SoapKernel to transform a SoapRequest to a SoapResponse

This commit is contained in:
Christian Kerl 2010-10-05 21:44:30 +02:00
parent 54a76a4ef8
commit b0681e5fcf
10 changed files with 414 additions and 31 deletions

View File

@ -1,21 +1,36 @@
<?php <?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\DependencyInjection; namespace Bundle\WebServiceBundle\DependencyInjection;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\DependencyInjection\Extension\Extension;
use Symfony\Component\DependencyInjection\Loader\XmlFileLoader; use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
use Symfony\Component\DependencyInjection\Extension\Extension; /**
use Symfony\Component\DependencyInjection\ContainerBuilder; * WebServiceExtension.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class WebServiceExtension extends Extension class WebServiceExtension extends Extension
{ {
public function configLoad(array $config, ContainerBuilder $configuration) public function configLoad(array $config, ContainerBuilder $configuration)
{
if(!$configuration->hasDefinition('webservice_http_kernel'))
{ {
$loader = new XmlFileLoader($configuration, __DIR__ . "/../Resources/config"); $loader = new XmlFileLoader($configuration, __DIR__ . "/../Resources/config");
$loader->load("services.xml"); $loader->load("services.xml");
$configuration->setAlias("http_kernel", "webservice_http_kernel"); $configuration->setAlias("http_kernel", "webservice_http_kernel");
} }
}
public function getXsdValidationBasePath() public function getXsdValidationBasePath()
{ {

View File

@ -8,14 +8,18 @@
</parameters> </parameters>
<services> <services>
<service id="webservice_http_kernel" class="Bundle\WebServiceBundle\SoapKernel"> <!-- redefine FrameworkBundle 'http_kernel' service with different id -->
<call method="setContainer">
<argument type="service" id="service_container" />
</call>
</service>
<service id="symfony_http_kernel" class="%http_kernel.class%"> <service id="symfony_http_kernel" class="%http_kernel.class%">
<argument type="service" id="event_dispatcher" /> <argument type="service" id="event_dispatcher" />
<argument type="service" id="controller_resolver" /> <argument type="service" id="controller_resolver" />
</service> </service>
<service id="webservice_soap_server" class="\SoapServer">
<argument type="string" key="%webservice.config.wsdl%" />
</service>
<service id="webservice_http_kernel" class="Bundle\WebServiceBundle\SoapKernel">
<argument type="service" id="webservice_soap_server" />
<argument type="service" id="symfony_http_kernel" />
</service>
</services> </services>
</container> </container>

68
Soap/SoapRequest.php Normal file
View File

@ -0,0 +1,68 @@
<?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\Soap;
use Symfony\Component\HttpFoundation\Request;
/**
* SoapRequest.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class SoapRequest extends Request
{
/**
* @var string
*/
protected $rawContent;
/**
* @var string
*/
protected $soapAction;
/**
* @var unknown
*/
protected $soapHeader;
/**
* @var unknown
*/
protected $soapArguments;
public function __construct($rawContent = null, array $query = null, array $attributes = null, array $cookies = null, array $server = null)
{
parent::__construct($query, null, $attributes, $cookies, null, $server);
$this->rawContent = $rawContent != null ? $rawContent : $this->loadRawContent();
}
/**
* Gets the SOAP XML content.
*
* @return string
*/
public function getRawContent()
{
return $this->rawContent;
}
/**
* Loads the plain HTTP POST data.
*
* @return string
*/
protected function loadRawContent()
{
return isset($GLOBALS['HTTP_RAW_POST_DATA']) ? $GLOBALS['HTTP_RAW_POST_DATA'] : file_get_contents('php://input');
}
}

48
Soap/SoapResponse.php Normal file
View File

@ -0,0 +1,48 @@
<?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\Soap;
use Symfony\Component\HttpFoundation\Response;
/**
* SoapResponse.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class SoapResponse extends Response
{
protected $soapHeaders;
protected $soapReturnValue;
public function __construct($returnValue)
{
parent::__construct();
$this->soapHeaders = array();
$this->soapReturnValue = $returnValue;
}
public function addSoapHeader(\SoapHeader $header)
{
$this->soapHeaders[] = $header;
}
public function getSoapHeaders()
{
return $this->soapHeaders;
}
public function getReturnValue()
{
return $this->soapReturnValue;
}
}

View File

@ -1,23 +1,153 @@
<?php <?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle; namespace Bundle\WebServiceBundle;
use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\DependencyInjection\ContainerAware;
use Symfony\Component\HttpKernel\HttpKernelInterface; use Symfony\Component\HttpKernel\HttpKernelInterface;
use Bundle\WebServiceBundle\Soap\SoapRequest;
use Bundle\WebServiceBundle\Soap\SoapResponse;
class SoapKernel extends ContainerAware implements HttpKernelInterface use Bundle\WebServiceBundle\Util\OutputBuffer;
use Bundle\WebServiceBundle\Util\String;
/**
* SoapKernel converts a SoapRequest to a SoapResponse. It uses PHP's SoapServer for SOAP message
* handling. The logic for every service method is implemented in a Symfony controller. The controller
* to use for a specific service method is defined in the ServiceDefinition. The controller is invoked
* by Symfony's HttpKernel implementation.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class SoapKernel implements HttpKernelInterface
{ {
/**
* @var \SoapServer
*/
protected $soapServer;
/**
* @var \Bundle\WebServiceBundle\Soap\SoapRequest
*/
protected $soapRequest;
/**
* @var \Bundle\WebServiceBundle\Soap\SoapResponse
*/
protected $soapResponse;
/**
* @var \Symfony\Component\HttpKernel\HttpKernelInterface
*/
protected $kernel;
public function __construct(\SoapServer $server, HttpKernelInterface $kernel)
{
$this->soapServer = $server;
$this->soapServer->setObject($this);
$this->kernel = $kernel;
}
public function getRequest() public function getRequest()
{ {
return null; return $this->soapRequest;
} }
public function handle(Request $request = null, $type = self::MASTER_REQUEST, $raw = false) public function handle(Request $request = null, $type = self::MASTER_REQUEST, $raw = false)
{ {
$this->container->getSymfonyHttpKernelService()->handle($request, $type, $raw); $this->soapRequest = $this->checkRequest($request);
$this->soapResponse->setContent(OutputBuffer::get(
function() use($this)
{
$this->soapServer->handle($this->soapRequest->getRawContent());
}
));
return $this->soapResponse;
}
public function __call($method, $arguments)
{
if($this->isSoapHeaderCallback($method))
{
// $this->soapRequest->addSoapHeader(null);
}
else
{
// TODO: set _controller attribute of request
$this->soapRequest->attributes->set('_controller', $method);
$response = $this->kernel->handle($this->soapRequest, self::MASTER_REQUEST, true);
$this->soapResponse = $this->checkResponse($response);
foreach($this->soapResponse->getSoapHeaders() as $header)
{
$this->soapServer->addSoapHeader($header);
}
return $this->soapResponse->getReturnValue();
}
}
/**
* Checks the given Request, that it is a SoapRequest. If the request is null a new
* SoapRequest is created.
*
* @param Request $request A request to check
*
* @return SoapRequest A valid SoapRequest
*
* @throws InvalidArgumentException if the given Request is not a SoapRequest
*/
protected function checkRequest(Request $request)
{
if($request == null)
{
$request = new SoapRequest();
}
if(!is_a($request, __NAMESPACE__ . '\\Soap\\SoapRequest'))
{
throw new InvalidArgumentException();
}
return $request;
}
/**
* Checks the given Response, that it is a SoapResponse.
*
* @param Response $response A response to check
*
* @return SoapResponse A valid SoapResponse
*
* @throws InvalidArgumentException if the given Response is null or not a SoapResponse
*/
protected function checkResponse(Response $response)
{
if($response == null || !is_a($request, __NAMESPACE__ . '\\Soap\\SoapResponse'))
{
throw new InvalidArgumentException();
}
return $response;
}
protected function isSoapHeaderCallback($method)
{
return false; //String::endsWith($method, 'Header');
} }
} }

View File

@ -1,14 +0,0 @@
<?php
namespace Bundle\WebServiceBundle;
use Symfony\Component\HttpFoundation\Request;
class SoapRequest extends Request
{
protected $soapAction;
protected $soapHeader;
protected $soapParameter;
}

40
Tests/SoapKernelTest.php Normal file
View File

@ -0,0 +1,40 @@
<?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\Tests;
use Symfony\Component\HttpFoundation\Request;
use Bundle\WebServiceBundle\SoapKernel;
/**
* UnitTest for \Bundle\WebServiceBundle\SoapKernel.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class SoapKernelTest extends \PHPUnit_Framework_TestCase
{
private $soapKernel;
public function setUp()
{
$soapServer = new \SoapServer();
$this->soapKernel = new SoapKernel($soapServer, null);
}
/**
* @expectedException InvalidArgumentException
*/
public function testInvalidRequest()
{
$this->soapKernel->handle(new Request());
}
}

33
Util/OutputBuffer.php Normal file
View File

@ -0,0 +1,33 @@
<?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\Util;
/**
* OutputBuffer provides utility methods to work with PHP's output buffer.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class OutputBuffer
{
/**
* Gets the output created by the given callable.
*
* @param callable $callback A callable to execute
*
* @return string The output
*/
static public function get($callback)
{
ob_start();
$callback();
return ob_get_clean();
}
}

51
Util/String.php Normal file
View File

@ -0,0 +1,51 @@
<?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle\Util;
/**
* String provides utility methods for strings.
*
* @author Christian Kerl <christian-kerl@web.de>
*/
class String
{
/**
* Checks if a string starts with a given string.
*
* @param string $str A string
* @param string $substr A string to check against
*
* @return bool True if str starts with substr
*/
public static function startsWith($str, $substr)
{
if(is_string($str) && is_string($substr) && strlen($str) >= strlen($substr))
{
return $substr == substr($str, 0, strlen($substr));
}
}
/**
* Checks if a string ends with a given string.
*
* @param string $str A string
* @param string $substr A string to check against
*
* @return bool True if str ends with substr
*/
public static function endsWith($str, $substr)
{
if(is_string($str) && is_string($substr) && strlen($str) >= strlen($substr))
{
return $substr == substr($str, strlen($str) - strlen($substr));
}
}
}

View File

@ -1,4 +1,12 @@
<?php <?php
/*
* This file is part of the WebServiceBundle.
*
* (c) Christian Kerl <christian-kerl@web.de>
*
* This source file is subject to the MIT license that is bundled
* with this source code in the file LICENSE.
*/
namespace Bundle\WebServiceBundle; namespace Bundle\WebServiceBundle;
@ -9,7 +17,7 @@ use Symfony\Component\HttpKernel\Bundle\Bundle;
/** /**
* WebServiceBundle. * WebServiceBundle.
* *
* @author Christian Kerl * @author Christian Kerl <christian-kerl@web.de>
*/ */
class WebServiceBundle extends Bundle class WebServiceBundle extends Bundle
{ {