2011-10-09 19:13:12 +02:00
|
|
|
<?php
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file is part of the BeSimpleSoapBundle.
|
|
|
|
*
|
|
|
|
* (c) Christian Kerl <christian-kerl@web.de>
|
|
|
|
* (c) Francis Besset <francis.besset@gmail.com>
|
|
|
|
*
|
|
|
|
* This source file is subject to the MIT license that is bundled
|
|
|
|
* with this source code in the file LICENSE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace BeSimple\SoapCommon;
|
|
|
|
|
2011-10-09 23:53:58 +02:00
|
|
|
use BeSimple\SoapCommon\Converter\TypeConverterCollection;
|
|
|
|
use BeSimple\SoapCommon\Converter\TypeConverterInterface;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @author Christian Kerl <christian-kerl@web.de>
|
|
|
|
* @author Francis Besset <francis.besset@gmail.com>
|
|
|
|
*/
|
|
|
|
abstract class AbstractSoapBuilder
|
|
|
|
{
|
|
|
|
protected $wsdl;
|
2011-10-10 20:13:16 +02:00
|
|
|
protected $soapOptions = array();
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
static public function createWithDefaults()
|
|
|
|
{
|
|
|
|
$builder = new static();
|
|
|
|
|
2011-10-09 23:53:58 +02:00
|
|
|
return $builder
|
2011-10-09 19:13:12 +02:00
|
|
|
->withSoapVersion12()
|
|
|
|
->withEncoding('UTF-8')
|
|
|
|
->withSingleElementArrays()
|
|
|
|
;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function __construct()
|
|
|
|
{
|
2011-10-10 20:13:16 +02:00
|
|
|
$this->soapOptions['features'] = 0;
|
|
|
|
$this->soapOptions['classmap'] = new Classmap();
|
|
|
|
$this->soapOptions['typemap'] = new TypeConverterCollection();
|
2011-10-09 19:13:12 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public function getWsdl()
|
|
|
|
{
|
|
|
|
return $this->wsdl;
|
|
|
|
}
|
|
|
|
|
2011-10-09 23:53:58 +02:00
|
|
|
public function getSoapOptions()
|
2011-10-09 19:13:12 +02:00
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$options = $this->soapOptions;
|
|
|
|
|
|
|
|
$options['classmap'] = $this->soapOptions['classmap']->all();
|
|
|
|
$options['typemap'] = $this->soapOptions['typemap']->getTypemap();
|
|
|
|
|
|
|
|
return $options;
|
2011-10-09 19:13:12 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWsdl($wsdl)
|
|
|
|
{
|
|
|
|
$this->wsdl = $wsdl;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withSoapVersion11()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['soap_version'] = SOAP_1_1;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withSoapVersion12()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['soap_version'] = SOAP_1_2;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function withEncoding($encoding)
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['encoding'] = $encoding;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
2011-10-10 22:18:20 +02:00
|
|
|
public function withWsdlCache($cache)
|
|
|
|
{
|
2011-10-11 21:24:32 +02:00
|
|
|
if (!in_array($cache, Cache::getTypes(), true)) {
|
|
|
|
throw new \InvalidArgumentException();
|
2011-10-10 22:18:20 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
$this->soapOptions['cache_wsdl'] = $cache;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
2011-10-09 19:13:12 +02:00
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWsdlCacheNone()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['cache_wsdl'] = Cache::TYPE_NONE;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWsdlCacheDisk()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['cache_wsdl'] = Cache::TYPE_DISK;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWsdlCacheMemory()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['cache_wsdl'] = Cache::TYPE_MEMORY;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWsdlCacheDiskAndMemory()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['cache_wsdl'] = Cache::TYPE_DISK_MEMORY;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enables the SOAP_SINGLE_ELEMENT_ARRAYS feature.
|
|
|
|
* If enabled arrays containing only one element will be passed as arrays otherwise the single element is extracted and directly passed.
|
|
|
|
*
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withSingleElementArrays()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['features'] |= SOAP_SINGLE_ELEMENT_ARRAYS;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enables the SOAP_WAIT_ONE_WAY_CALLS feature.
|
|
|
|
*
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withWaitOneWayCalls()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['features'] |= SOAP_WAIT_ONE_WAY_CALLS;
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Enables the SOAP_USE_XSI_ARRAY_TYPE feature.
|
|
|
|
*
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withUseXsiArrayType()
|
|
|
|
{
|
2011-10-09 23:53:58 +02:00
|
|
|
$this->soapOptions['features'] |= SOAP_USE_XSI_ARRAY_TYPE;
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function withTypeConverter(TypeConverterInterface $converter)
|
|
|
|
{
|
|
|
|
$this->soapOptions['typemap']->add($converter);
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function withTypeConverters(TypeConverterCollection $converters, $merge = true)
|
|
|
|
{
|
|
|
|
if ($merge) {
|
|
|
|
$this->soapOptions['typemap']->addCollection($converters);
|
|
|
|
} else {
|
|
|
|
$this->soapOptions['typemap']->set($converters->all());
|
|
|
|
}
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds a class mapping to the classmap.
|
|
|
|
*
|
|
|
|
* @param string $xmlType
|
|
|
|
* @param string $phpType
|
|
|
|
*
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withClassMapping($xmlType, $phpType)
|
|
|
|
{
|
2011-10-10 20:13:16 +02:00
|
|
|
$this->soapOptions['classmap']->add($xmlType, $phpType);
|
2011-10-09 23:53:58 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the classmap.
|
|
|
|
*
|
|
|
|
* @param array $classmap The classmap.
|
|
|
|
* @param boolean $merge If true the given classmap is merged into the existing one, otherwise the existing one is overwritten.
|
|
|
|
*
|
|
|
|
* @return AbstractSoapBuilder
|
|
|
|
*/
|
|
|
|
public function withClassmap(Classmap $classmap, $merge = true)
|
|
|
|
{
|
|
|
|
if ($merge) {
|
2011-10-10 20:13:16 +02:00
|
|
|
$this->soapOptions['classmap']->addClassmap($classmap);
|
2011-10-09 23:53:58 +02:00
|
|
|
} else {
|
2011-10-10 20:13:16 +02:00
|
|
|
$this->soapOptions['classmap']->set($classmap->all());
|
2011-10-09 23:53:58 +02:00
|
|
|
}
|
2011-10-09 19:13:12 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
protected function validateWsdl()
|
|
|
|
{
|
|
|
|
if (null === $this->wsdl) {
|
|
|
|
throw new \InvalidArgumentException('The WSDL has to be configured!');
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|