Deprecate SOAP_Base's __set_type_translation() method in favour of se…

…tTypeTranslation().

git-svn-id: http://svn.php.net/repository/pear/packages/SOAP/trunk@227858 c90b9560-bf6c-de11-be94-00142212c4b1

Base.php

@@ -1180,7 +1180,24 @@ function _decodeDIMEMessage(&$data, &$headers, &$attachments)
         }
     }
 
+    /**
+     * @deprecated Use setTypeTranslation().
+     */
     function __set_type_translation($type, $class = null)
+    {
+        $this->setTypeTranslation($type, $class);
+    }
+
+    /**
+     * Explicitly sets the translation for a specific class.
+     *
+     * Auto translation works for all cases, but opens ANY class in the script
+     * to be used as a data type, and may not be desireable.
+     *
+     * @param string $type   A SOAP type.
+     * @param string $class  A PHP class name.
+     */
+    function setTypeTranslation($type, $class = null)
     {
         $tq =& new QName($type);
         if (!$class) {

example/client.php

@@ -77,8 +77,8 @@
  * class. auto_translation works for all cases, but opens ANY class in the
  * script to be used as a data type, and may not be desireable. Both can be
  * used on client or server. */
-$soapclient->__set_type_translation('{http://soapinterop.org/xsd}SOAPStruct',
-                                    'SOAPStruct');
+$soapclient->setTypeTranslation('{http://soapinterop.org/xsd}SOAPStruct',
+                                'SOAPStruct');
 $ret = $soapclient->call('echoStruct',
                          $p = array('inputStruct' => $struct->__to_soap()),
                          $options);

example/wsdl_client.php

@@ -54,22 +54,22 @@
 
 $struct = new SOAPStruct('test string',123,123.123);
 
-/* send an object, get an object back */
-/* tell client to translate to classes we provide if possible */
+/* Send an object, get an object back.
+ * Tell the client to translate to classes we provide if possible. */
 $soapclient->_auto_translation = true;
-/* or you can explicitly set the translation for
-   a specific class.  auto_translation works for all cases,
-   but opens ANY class in the script to be used as a data type,
-   and may not be desireable.  both can be used on client or
-   server */
-$soapclient->__set_type_translation('{http://soapinterop.org/xsd}SOAPStruct','SOAPStruct');
+/* Or you can explicitly set the translation for a specific class.
+ * auto_translation works for all cases, but opens ANY class in the script to
+ * be used as a data type, and may not be desireable.  both can be used on
+ * client or server. */
+$soapclient->setTypeTranslation('{http://soapinterop.org/xsd}SOAPStruct',
+                                'SOAPStruct');
 $ret = $soapclient->echoStruct($struct->__to_soap());
-#print $soapclient->__get_wire();
+//print $soapclient->__get_wire();
 print_r($ret);
 
 /**
- * PHP doesn't support multiple OUT parameters in function calls, so we
- * must do a little work to make it happen here.  This requires knowledge on the
+ * PHP doesn't support multiple OUT parameters in function calls, so we must
+ * do a little work to make it happen here.  This requires knowledge on the
  * developers part to figure out how they want to deal with it.
  */
 $ret = $soapclient->echoStructAsSimpleTypes($struct->__to_soap());

package.xml

@@ -48,6 +48,7 @@
 * Replace all invalid characters in label and variable name of the generated proxy code. (Bug 7493).
 * Add setDefaultNamespace() (Request #5622).
 * Make sure that generated proxy code doesn't use method or class names that are reserved words in PHP (Bug 3048).
+* Deprecate SOAP_Base's __set_type_translation() method in favour of setTypeTranslation().
 * Deprecate SOAP_WSDL's set_service() method in favour of setService().
 * Remove deprecated parse() method from SOAP_WSDL.
 * Fix subsequent failures if one transmission with a Transport class instance failed (Bug 7469).