跨語言 WebService 整合是企業級應用常見需求。本文示範 PHP 使用 NuSOAP 呼叫 Java Axis 1.4 開發的 WebService,處理複雜型別 (自訂物件) 回傳、參數傳遞、編碼設定、錯誤處理完整流程。
// Person.java
import java.io.Serializable;
public class Person implements Serializable {
private static final long serialVersionUID = -410186774891162281L;
private String username;
private int age;
private boolean sex; // true=male, false=female
// Getter/Setter 省略
public String getUsername() { return username; }
public void setUsername(String username) { this.username = username; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public boolean isSex() { return sex; }
public void setSex(boolean sex) { this.sex = sex; }
}
// UserLogin.java
public class UserLogin {
public Person login(String loginName, String loginPasswd) {
Person person = new Person();
if ("laoli".equals(loginName) && "111111".equals(loginPasswd)) {
person.setUsername("老李");
person.setAge(55);
person.setSex(true);
} else if ("xiaoli".equals(loginName) && "123456".equals(loginPasswd)) {
person.setUsername("小麗");
person.setAge(23);
person.setSex(false);
} else {
return null;
}
return person;
}
}
<service name="UserLoginWS" provider="java:RPC">
<parameter name="className" value="UserLogin"/>
<parameter name="allowedMethods" value="login"/>
<beanMapping qname="ns:Person" xmlns:ns="urn:UserLogin"
languageSpecificType="java:Person"/>
</service>
<?php
header("Content-Type: text/html; charset=utf-8");
require_once("libs/nusoap.php"); // NuSOAP 庫
$wsdl = 'https://localhost:8080/axis/services/UserLoginWS?wsdl';
$client = new nusoap_client($wsdl, true); // true = WSDL 模式
// 關鍵編碼設定 (防中文亂碼)
$client->soap_defencoding = 'utf-8';
$client->decode_utf8 = false;
$client->xml_encoding = 'utf-8';
// 檢查建構錯誤
$err = $client->getError();
if ($err) {
die("<h2>Constructor error</h2><pre>$err</pre>");
}
// 呼叫 login 方法
$params = array('loginName' => 'laoli', 'loginPasswd' => '111111');
$result = $client->call('login', $params);
// 錯誤處理
if ($client->fault) {
echo "<h2>SOAP Fault</h2><pre>";
print_r($result);
echo "</pre>";
} else {
$err = $client->getError();
if ($err) {
echo "<h2>Error</h2><pre>$err</pre>";
} else {
echo "<h2>Result</h2><pre>";
print_r($result);
echo "</pre>";
}
}
// 第二次呼叫
$params = array('loginName' => 'xiaoli', 'loginPasswd' => '123456');
$result = $client->call('login', $params);
// 同樣錯誤處理...
?>
Result
Array
(
[username] => 老李
[age] => 55
[sex] => 1
)
Result
Array
(
[username] => 小麗
[age] => 23
[sex] =>
)
| 屬性 | 值 | 作用 |
|---|---|---|
soap_defencoding | utf-8 | 發送請求的預設編碼 |
decode_utf8 | false | 不自動 UTF-8 解碼,保持原始字串 |
xml_encoding | utf-8 | XML 宣告編碼 |