在 Android 開發中,除了使用本地 SQLite 資料庫,更常見的場景是從網路伺服器獲取數據。本文將詳細介紹如何基於 HTTP 協議實現 Android 客戶端與 Java 伺服器端(Struts2 框架)的數據交互,包含完整的伺服器端配置、Action 實現以及客戶端網路請求代碼。
創建一個基於 Java EE 5.0 的 Web Project,將以下 JAR 包放置在 WebRoot/WEB-INF/lib 目錄下:
<?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>
將文件放在 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>
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,結果類型設置為 jsonhttps://localhost:8080/PDAServer/login.action?username=123456
Android 模擬器將自身視為 localhost (127.0.0.1),若連接本機伺服器,必須使用 10.0.2.2 作為 IP 地址。
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();
}
}
NetworkOnMainThreadExceptionAndroidManifest.xml 中添加網路權限:<uses-permission android:name="android.permission.INTERNET" />通過以上步驟,您可以構建一個基於 HTTP 協議的 Android 客戶端與 Java 伺服器端數據交互系統。實際項目中建議根據業務複雜度選擇合適的架構模式(MVP、MVVM)和網路庫,提高代碼可維護性與擴展性。