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())); }