function testAddDocumentation()
{
$wsdl = new Zend_Soap_Wsdl('MyService', 'http://localhost/MyService.php');
$portType = $wsdl->addPortType('myPortType');
$wsdl->addDocumentation($portType, 'This is a description for Port Type node.');
$this->assertEquals($wsdl->toXml(),
'<?xml version="1.0"?>' . PHP_EOL .
'<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" '
. 'xmlns:tns="http://localhost/MyService.php" '
. 'xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" '
. 'xmlns:xsd="http://www.w3.org/2001/XMLSchema" '
. 'xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" '
. 'name="MyService" targetNamespace="http://localhost/MyService.php">'
. '<portType name="myPortType">'
. '<documentation>This is a description for Port Type node.</documentation>'
. '</portType>'
. '</definitions>' . PHP_EOL);
}
/**
* Add a function to the WSDL document.
*
* @param Zend_Server_Reflection_Function_Abstract $function function to add
* @param Zend_Soap_Wsdl $wsdl WSDL document
* @param object $port wsdl:portType
* @param object $binding wsdl:binding
* @return void
*/
protected function _addFunctionToWsdl($function, $wsdl, $port, $binding)
{
$uri = $this->getUri();
// We only support one prototype: the one with the maximum number of arguments
$prototype = null;
$maxNumArgumentsOfPrototype = -1;
foreach ($function->getPrototypes() as $tmpPrototype) {
$numParams = count($tmpPrototype->getParameters());
if ($numParams > $maxNumArgumentsOfPrototype) {
$maxNumArgumentsOfPrototype = $numParams;
$prototype = $tmpPrototype;
}
}
if ($prototype === null) {
require_once "Zend/Soap/AutoDiscover/Exception.php";
throw new Zend_Soap_AutoDiscover_Exception("No prototypes could be found for the '" . $function->getName() . "' function");
}
// Add the input message (parameters)
$args = array();
if ($this->_bindingStyle['style'] == 'document') {
// Document style: wrap all parameters in a sequence element
$sequence = array();
foreach ($prototype->getParameters() as $param) {
$sequenceElement = array('name' => $param->getName(), 'type' => $wsdl->getType($param->getType()));
if ($param->isOptional()) {
$sequenceElement['nillable'] = 'true';
}
$sequence[] = $sequenceElement;
}
$element = array('name' => $function->getName(), 'sequence' => $sequence);
// Add the wrapper element part, which must be named 'parameters'
$args['parameters'] = array('element' => $wsdl->addElement($element));
} else {
// RPC style: add each parameter as a typed part
foreach ($prototype->getParameters() as $param) {
$args[$param->getName()] = array('type' => $wsdl->getType($param->getType()));
}
}
$wsdl->addMessage($function->getName() . 'In', $args);
$isOneWayMessage = false;
if ($prototype->getReturnType() == "void") {
$isOneWayMessage = true;
}
if ($isOneWayMessage == false) {
// Add the output message (return value)
$args = array();
if ($this->_bindingStyle['style'] == 'document') {
// Document style: wrap the return value in a sequence element
$sequence = array();
if ($prototype->getReturnType() != "void") {
$sequence[] = array('name' => $function->getName() . 'Result', 'type' => $wsdl->getType($prototype->getReturnType()));
}
$element = array('name' => $function->getName() . 'Response', 'sequence' => $sequence);
// Add the wrapper element part, which must be named 'parameters'
$args['parameters'] = array('element' => $wsdl->addElement($element));
} else {
if ($prototype->getReturnType() != "void") {
// RPC style: add the return value as a typed part
$args['return'] = array('type' => $wsdl->getType($prototype->getReturnType()));
}
}
$wsdl->addMessage($function->getName() . 'Out', $args);
}
// Add the portType operation
if ($isOneWayMessage == false) {
$portOperation = $wsdl->addPortOperation($port, $function->getName(), 'tns:' . $function->getName() . 'In', 'tns:' . $function->getName() . 'Out');
} else {
$portOperation = $wsdl->addPortOperation($port, $function->getName(), 'tns:' . $function->getName() . 'In', false);
}
$desc = $function->getDescription();
if (strlen($desc) > 0) {
$wsdl->addDocumentation($portOperation, $desc);
}
// When using the RPC style, make sure the operation style includes a 'namespace' attribute (WS-I Basic Profile 1.1 R2717)
if ($this->_bindingStyle['style'] == 'rpc' && !isset($this->_operationBodyStyle['namespace'])) {
$this->_operationBodyStyle['namespace'] = '' . $uri;
}
// Add the binding operation
if ($isOneWayMessage == false) {
$operation = $wsdl->addBindingOperation($binding, $function->getName(), $this->_operationBodyStyle, $this->_operationBodyStyle);
} else {
$operation = $wsdl->addBindingOperation($binding, $function->getName(), $this->_operationBodyStyle);
}
$wsdl->addSoapOperation($operation, $uri . '#' . $function->getName());
// Add the function name to the list
$this->_functions[] = $function->getName();
}
public function testAddDocumentationToSetInsertsBefore()
{
$wsdl = new Zend_Soap_Wsdl('MyService', 'http://localhost/MyService.php');
$messageParts = array();
$messageParts['parameter1'] = $wsdl->getType('int');
$messageParts['parameter2'] = $wsdl->getType('string');
$messageParts['parameter3'] = $wsdl->getType('mixed');
$message = $wsdl->addMessage('myMessage', $messageParts);
$wsdl->addDocumentation($message, "foo");
$this->assertEquals('<?xml version="1.0"?>' . '<definitions xmlns="http://schemas.xmlsoap.org/wsdl/" ' . 'xmlns:tns="http://localhost/MyService.php" ' . 'xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" ' . 'xmlns:xsd="http://www.w3.org/2001/XMLSchema" ' . 'xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" ' . 'xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" ' . 'name="MyService" targetNamespace="http://localhost/MyService.php">' . '<message name="myMessage">' . '<documentation>foo</documentation>' . '<part name="parameter1" type="xsd:int"/>' . '<part name="parameter2" type="xsd:string"/>' . '<part name="parameter3" type="xsd:anyType"/>' . '</message>' . '</definitions>', $this->sanitizeWsdlXmlOutputForOsCompability($wsdl->toXml()));
}
