萬盛學電腦網

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

Android 透過 HTTP 協議從伺服器獲取數據的完整實現指南

在 Android 開發中,除了使用本地 SQLite 資料庫,更常見的場景是從網路伺服器獲取數據。本文將詳細介紹如何基於 HTTP 協議實現 Android 客戶端與 Java 伺服器端(Struts2 框架)的數據交互,包含完整的伺服器端配置、Action 實現以及客戶端網路請求代碼。

一、伺服器端環境搭建與配置

1. 建立 Web 項目並導入 Struts2 依賴

創建一個基於 Java EE 5.0 的 Web Project,將以下 JAR 包放置在 WebRoot/WEB-INF/lib 目錄下:

  • xwork-core-2.2.1.1.jar
  • struts2-core-2.2.1.1.jar
  • commons-logging-1.0.4.jar
  • freemarker-2.3.16.jar
  • ognl-3.0.jar
  • javassist-3.7.ga.jar
  • commons-fileupload.jar
  • commons-io.jar
  • json-lib-2.1-jdk15.jar(用於 JSON 數據處理)
  • struts2-json-plugin-2.2.1.1.jar(Struts2 JSON 插件)

2. 配置 web.xml 註冊 Struts2 核心過濾器

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
    xmlns="https://java.sun.com/xml/ns/javaee"
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://java.sun.com/xml/ns/javaee
    https://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <!-- 定義 Struts2 核心控制器 FilterDispatcher -->
    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

3. 編寫 struts.xml 配置文件

將文件放在 WebRoot/WEB-INF/classes 目錄下(注意:原文誤寫為 lib 目錄):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "https://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
    <constant name="struts.i18n.encoding" value="UTF-8"/>
    <constant name="struts.enable.DynamicMethodInvocation" value="true"/>
    
    <!-- 繼承 json-default 以支援 JSON 返回類型 -->
    <package name="dongzi" extends="json-default">
        <action name="login" class="com.example.action.LoginAction" method="login">
            <result type="json"/> <!-- 返回 JSON 格式數據,不跳轉頁面 -->
        </action>
    </package>
</struts>

二、Action 類實現與 JSON 數據返回

LoginAction 完整代碼

public class LoginAction extends ActionSupport implements ServletRequestAware, ServletResponseAware {
    private static final long serialVersionUID = 1L;
    private HttpServletRequest request;
    private HttpServletResponse response;

    @Override
    public void setServletRequest(HttpServletRequest request) {
        this.request = request;
    }

    @Override
    public void setServletResponse(HttpServletResponse response) {
        this.response = response;
    }

    public void login() {
        try {
            response.setContentType("text/html;charset=utf-8");
            response.setCharacterEncoding("UTF-8");
            
            String username = request.getParameter("username");
            String resultMsg;
            
            if ("123456".equals(username)) {
                resultMsg = "真的很奇怪,日本人!";
            } else if ("zhd".equals(username)) {
                resultMsg = "沒有錯,我就是東子哥!";
            } else {
                resultMsg = "我就是東子哥!";
            }
            
            // 直接輸出文本(也可使用 JSONObject 返回結構化數據)
            response.getWriter().write(resultMsg);
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

關鍵點說明:

  • 實現 ServletRequestAware 和 ServletResponseAware 接口以獲取請求/響應對象
  • 包繼承 json-default,結果類型設置為 json
  • 測試 URL:https://localhost:8080/PDAServer/login.action?username=123456
伺服器端運行測試截圖

三、Android 客戶端網路請求實現

注意:模擬器 IP 地址配置

Android 模擬器將自身視為 localhost (127.0.0.1),若連接本機伺服器,必須使用 10.0.2.2 作為 IP 地址。

MainActivity 完整代碼

public class MainActivity extends Activity {
    // 模擬器訪問本機伺服器需使用 10.0.2.2
    private static final String SERVER_URL = "https://10.0.2.2:8080/PDAServer/login.action";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        getPDAServerData(SERVER_URL);
    }

    private void getPDAServerData(String url) {
        // 拼接請求參數
        url += "?username=123456";
        
        // 在子線程中執行網路請求(Android 4.0+ 嚴禁主線程網路操作)
        new Thread(() -> {
            try {
                HttpClient client = new DefaultHttpClient();
                HttpPost request = new HttpPost(new URI(url));
                HttpResponse response = client.execute(request);
                
                // 判斷請求是否成功 (HTTP 200)
                if (response.getStatusLine().getStatusCode() == 200) {
                    HttpEntity entity = response.getEntity();
                    if (entity != null) {
                        String result = EntityUtils.toString(entity, "UTF-8");
                        // 在主線程更新 UI
                        runOnUiThread(() -> {
                            // 這裡處理 result,如顯示在 TextView 或 Toast 中
                            Log.d("ServerResponse", result);
                        });
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }).start();
    }
}

重要提醒

  • 網路請求必須在子線程中執行,否則會拋出 NetworkOnMainThreadException
  • 需在 AndroidManifest.xml 中添加網路權限:<uses-permission android:name="android.permission.INTERNET" />
  • 建議使用成熟的網路框架(如 OkHttp、Retrofit、Volley)替代原生 HttpClient(已在 API 23 中移除)
  • 生產環境應使用 HTTPS 並妥善處理憑證驗證

四、進階優化建議

  1. 數據格式標準化:建議統一使用 JSON 格式,定義統一的響應結構(code、message、data)
  2. 異步處理框架:採用 RxJava + Retrofit 或 Kotlin 協程簡化異步邏輯
  3. 錯誤處理機制:區分網路異常、業務邏輯錯誤、服務器錯誤,提供友好提示
  4. 緩存策略:對非實時數據實施本地緩存,減少網路請求
  5. 安全性:敏感接口添加簽名驗證、Token 鑒權,防止重放攻擊

通過以上步驟,您可以構建一個基於 HTTP 協議的 Android 客戶端與 Java 伺服器端數據交互系統。實際項目中建議根據業務複雜度選擇合適的架構模式(MVP、MVVM)和網路庫,提高代碼可維護性與擴展性。

copyright © 萬盛學電腦網 all rights reserved