萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 呼叫 Java WebService (Axis 1.4) 完整實戰:NuSOAP 客戶端對接複雜型別回傳

跨語言 WebService 整合是企業級應用常見需求。本文示範 PHP 使用 NuSOAP 呼叫 Java Axis 1.4 開發的 WebService,處理複雜型別 (自訂物件) 回傳、參數傳遞、編碼設定、錯誤處理完整流程。

Java 端服務定義 (Axis 1.4)

資料傳輸物件 (DTO)

// 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;
    }
}

部署描述檔 (deploy.wsdd) 關鍵片段

<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 端 NuSOAP 客戶端完整代碼

<?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] => 
)

關鍵配置解析

常見問題與解決

  1. 中文亂碼:確保 PHP 檔案 UTF-8 無 BOM、資料庫連線 UTF-8、NuSOAP 三個編碼屬性全設為 utf-8、Java 端 Tomcat URIEncoding="UTF-8"
  2. 複雜型別無法映射:WSDL 中 beanMapping 必須正確對應 Java 類全名與 XML 命名空間
  3. Null 回傳處理:PHP 端需檢查 $result === null 或陣列鍵是否存在
  4. NuSOAP 版本:使用 0.9.5+ 版本,舊版有命名空間 Bug
  5. Axis 版本差異:Axis 1.x/2.x WSDL 風格不同,需對應調整

現代替代方案

  • PHP 原生 SoapClient:PHP 5.0+ 內建,效能優於 NuSOAP,但複雜型別映射需手動 classmap
  • WSDL to PHP 生成器:如 goetas-webservices/xsd2php、wsdl2phpgenerator 生成型別安全客戶端
  • REST/JSON API:新專案優先考慮 RESTful API,避免 SOAP 複雜度
<?php
// 原生 SoapClient 範例
$client = new SoapClient($wsdl, array(
    'encoding' => 'UTF-8',
    'classmap' => array('Person' => 'PersonDTO'),  // 映射到本地類
    'trace' => 1,
    'exceptions' => true
));
$person = $client->login(['loginName' => 'laoli', 'loginPasswd' => '111111']);
?>

NuSOAP 為老專案提供無需 WSDL 編譯的動態呼叫能力,但新專案強烈建議遷移至原生 SoapClient 或 REST 架構。

copyright © 萬盛學電腦網 all rights reserved
屬性值作用
soap_defencodingutf-8發送請求的預設編碼
decode_utf8false不自動 UTF-8 解碼,保持原始字串
xml_encodingutf-8XML 宣告編碼