package com.example.kucun2.entity.data;
import android.util.Log;
import com.example.kucun2.function.MyAppFunction;
import java.lang.reflect.Field;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
/**
可同步实体基类
提供实体到服务端的同步功能,包含自动重试机制和线程管理
*/
public abstract class SynchronizableEntity implements EntityClassGrassrootsid {
private static final String TAG = “SynchronizableEntity”;
// 双重缓存结构:外层缓存类名,内层缓存字段名->Field对象
private static final Map<Class<?>, Map<String, Field>> CLASS_FIELD_CACHE = new HashMap<>();
// 网络请求线程池(静态共享)
private static final ExecutorService NETWORK_EXECUTOR = Executors.newFixedThreadPool(4);
/**
获取指定类型操作的端点URL
@param type 操作类型(如"create", “update”, "delete"等)
@return 完整的端点URL路径
@apiNote 该方法通过资源键名拼接规则查找对应的URL资源
@example 对于Product类的create操作,查找键为:“url_create_product”
*/
public String getEndpoint(String type) {
// 构建资源键名:url_操作类型_类名小写
String key = “url_” + type + “_” + this.getClass().getSimpleName().toLowerCase();
return MyAppFunction.getStringResource(“string”, key);
}
//================ 核心同步方法 ================//
/**
同步实体到服务端(公开接口)
@param type 操作类型(如"create", "update"等)
@param callback 同步结果回调接口
@implNote 内部调用私有方法实现带重试机制的同步
@see #sync(String, SyncCallback, int)
*/
public void sync(String type, SyncCallback callback) {
sync(type, callback, 0); // 初始重试次数为0
}
/**
带重试机制的同步实现(私有方法)
@param type 操作类型
@param callback 同步结果回调
@param retryCount 当前重试次数
@implSpec 1. 构建完整端点URL
通过线程池提交网络请求
处理成功/失败回调
*/
private void sync(String type, SyncCallback callback, int retryCount) {
// 构建完整端点URL
String baseUrl = MyAppFunction.getStringResource(“string”, “url”);
String endpoint = baseUrl + getEndpoint(type);
Log.d(TAG, "同步端点: " + endpoint + ", 重试次数: " + retryCount);
// 提交到线程池执行网络请求 NETWORK_EXECUTOR.execute(() -> { ApiClient.postJson(endpoint, this, new ApiClient.ApiCallback() { @Override public void onSuccess(SynchronizableEntity responseData) { handleSyncSuccess(responseData, callback); } @Override public void onError(int statusCode, String error) { handleSyncError(type, statusCode, error, callback, retryCount); } }); });
}
/**
处理同步成功结果
@param responseData 服务端返回的实体数据
@param callback 同步结果回调
@implNote 1. 更新实体ID
记录成功日志
触发成功回调
*/
private void handleSyncSuccess(SynchronizableEntity responseData, SyncCallback callback) {
// 更新实体ID(如果服务端返回了新ID)
if (responseData != null) {
setId(responseData.getId());
Log.i(TAG, "同步成功, 新ID: " + responseData.getId());
}
// 触发成功回调 if (callback != null) callback.onSyncSuccess(this);
}
/**
处理同步错误(含重试逻辑)
@param type 操作类型
@param statusCode HTTP状态码(-1表示网络错误)
@param error 错误信息
@param callback 同步结果回调
@param retryCount 当前重试次数
@implSpec 1. 判断错误是否可重试(网络错误或5xx服务错误)
满足条件时进行指数退避重试
达到最大重试次数后触发失败回调
@algorithm 使用指数退避算法:延迟时间 = 1000ms * 2^重试次数
*/
private void handleSyncError(String type, int statusCode, String error,
SyncCallback callback, int retryCount) {
Log.e(TAG, "同步失败: " + error + ", 状态码: " + statusCode);
// 判断是否可重试(网络错误或服务端5xx错误)
boolean canRetry = statusCode == -1 || (statusCode >= 500 && statusCode < 600);
// 满足重试条件(可重试错误且未达到最大重试次数)
if (canRetry && retryCount < 3) {
// 计算指数退避延迟时间
long delay = (long) (1000 * Math.pow(2, retryCount));
Log.w(TAG, "将在 " + delay + “ms 后重试”);
try { // 当前线程休眠指定时间 Thread.sleep(delay); } catch (InterruptedException e) { // 恢复中断状态 Thread.currentThread().interrupt(); } // 递归调用进行重试(重试次数+1) sync(type, callback, retryCount + 1);
} else {
// 不可重试或达到最大重试次数,触发失败回调
if (callback != null) {
String finalError = “同步失败: " + error;
if (canRetry) finalError += " (重试失败)”;
callback.onSyncFailure(finalError);
}
}
}
// 线程安全的对象复制方法
public void updateFrom(Object source) {
if ( source == null) return;
Class targetClass = this.getClass(); Class sourceClass = source.getClass(); // 获取或创建字段缓存 Map<String, Field> targetFields = getOrCreateFieldCache(targetClass); Map<String, Field> sourceFields = getOrCreateFieldCache(sourceClass); // 遍历源对象字段 for (Map.Entry<String, Field> entry : sourceFields.entrySet()) { String fieldName = entry.getKey(); Field sourceField = entry.getValue(); // 查找目标对象对应字段 Field targetField = targetFields.get(fieldName); if (targetField != null) { // 类型兼容性检查 if (isCompatibleTypes(sourceField.getType(), targetField.getType())) { try { // 复制字段值 Object value = sourceField.get(source); targetField.set(this, value); } catch (IllegalAccessException e) { // 处理异常,记录日志 } } } }
}
// 获取或创建类的字段缓存
private static Map<String, Field> getOrCreateFieldCache(Class<?> clazz) {
// 双重检查锁确保线程安全
if (!CLASS_FIELD_CACHE.containsKey(clazz)) { synchronized (clazz) { if (!CLASS_FIELD_CACHE.containsKey(clazz)) { Map<String, Field> fieldMap = new HashMap<>(); // 递归获取所有字段(包括父类) for (Class<?> current = clazz; current != null; current = current.getSuperclass()) { for (Field field : current.getDeclaredFields()) { field.setAccessible(true); // 突破访问限制 fieldMap.put(field.getName(), field); } } CLASS_FIELD_CACHE.put(clazz, fieldMap); } } } return CLASS_FIELD_CACHE.get(clazz);
}
// 类型兼容性检查(支持自动装箱/拆箱)
private static boolean isCompatibleTypes(Class sourceType, Class targetType) {
// 处理基本类型和包装类的兼容性
if (sourceType.isPrimitive()) {
sourceType = primitiveToWrapper(sourceType);
}
if (targetType.isPrimitive()) {
targetType = primitiveToWrapper(targetType);
}
return targetType.isAssignableFrom(sourceType);
}
// 基本类型转包装类
private static Class primitiveToWrapper(Class primitiveType) {
if (boolean.class.equals(primitiveType)) return Boolean.class;
if (byte.class.equals(primitiveType)) return Byte.class;
if (char.class.equals(primitiveType)) return Character.class;
if (double.class.equals(primitiveType)) return Double.class;
if (float.class.equals(primitiveType)) return Float.class;
if (int.class.equals(primitiveType)) return Integer.class;
if (long.class.equals(primitiveType)) return Long.class;
if (short.class.equals(primitiveType)) return Short.class;
if (void.class.equals(primitiveType)) return Void.class;
return primitiveType;
}
//================ 回调接口 ================//
/**
同步操作回调接口
@implNote 使用方需实现此接口处理同步结果
/
public interface SyncCallback {
/*
同步成功回调
@param entity 同步后的实体对象(已更新ID)
*/
void onSyncSuccess(SynchronizableEntity entity);
/**
同步失败回调
@param error 失败原因描述
*/
void onSyncFailure(String error);
}
}
package com.example.kucun2.entity.data;
import android.os.Handler;
import android.os.Looper;
import android.util.Log;
import com.example.kucun2.entity.Information;
import com.example.kucun2.entity.User;
import com.example.kucun2.function.MyAppFunction;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import okhttp3.*;
import java.io.IOException;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.util.Map;
/**
重构版API客户端 - 更灵活的类型处理
主要改进:
分离请求参数类型和响应类型
支持多种请求方法(GET/POST/PUT/DELETE)
支持表单和JSON两种请求格式
自动推导响应类型
统一的请求执行流程
*/
public class ApiClient {
private static final Gson gson = GsonFactory.createGson();
private static final String TAG = “ApiClient”;
private static final MediaType JSON = MediaType.get(“application/json; charset=utf-8”);
private static final int MAX_RETRY = 3;
private static final Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
// ====================== 核心请求方法 ======================
/**
执行API请求(核心方法)
@param request 构建好的OkHttp请求
@param responseType 期望的响应类型
@param callback 回调接口
@param 响应数据类型
*/
public static void executeRequest(Request request,
Type responseType,
ApiCallback callback) {
OkHttpClient client = MyAppFunction.getClient();
client.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
handleFailure(call, e, callback, 0);
}
@Override public void onResponse(Call call, Response response) throws IOException { handleResponse(response, responseType, callback); }
});
}
// ====================== 请求构建方法 ======================
/**
构建JSON请求
@param url API地址
@param method 请求方法(“POST”, “PUT”, “DELETE”)
@param requestData 请求数据对象
@return 构建好的Request对象
*/
public static Request buildJsonRequest(String url, String method, Object requestData) {
String jsonRequest = ReflectionJsonUtils.toJson(requestData);
Log.d(TAG, method + " URL: " + url);
Log.d(TAG, "请求数据: " + jsonRequest);
RequestBody body = RequestBody.create(JSON, jsonRequest);
return new Request.Builder()
.url(url)
.method(method, body)
.build();
}
/**
构建表单请求
@param url API地址
@param method 请求方法
@param formData 表单数据
@return 构建好的Request对象
*/
public static Request buildFormRequest(String url, String method, Map<String, String> formData) {
FormBody.Builder builder = new FormBody.Builder();
for (Map.Entry<String, String> entry : formData.entrySet()) {
builder.add(entry.getKey(), entry.getValue());
}
Log.d(TAG, method + " URL: " + url);
Log.d(TAG, "表单数据: " + formData);
return new Request.Builder()
.url(url)
.method(method, builder.build())
.build();
}
// ====================== 响应处理方法 ======================
private static void handleResponse(Response response,
Type responseType,
ApiCallback callback) throws IOException {
try (ResponseBody responseBody = response.body()) {
if (!response.isSuccessful()) {
String error = "HTTP " + response.code() + ": " + response.message();
Log.e(TAG, error);
notifyError(callback, response.code(), error);
return;
}
String jsonResponse = responseBody.string(); Log.d(TAG, "服务器响应: " + jsonResponse); // 解析服务端的Information包装 Information wrapper = gson.fromJson(jsonResponse, responseType); if (wrapper != null && wrapper.getStatus() == 200) { notifySuccess(callback, wrapper.getData()); } else { String errorMsg = wrapper != null ? "服务端错误: " + wrapper.getStatus() + " - " + wrapper.getText() : “无效的响应格式”; Log.e(TAG, errorMsg); notifyError(callback, wrapper != null ? wrapper.getStatus() : -1, errorMsg); } } catch (Exception e) { Log.e(TAG, "响应处理异常: " + e.getMessage()); notifyError(callback, -2, "数据处理异常: " + e.getMessage()); }
}
// ====================== 失败处理与重试 ======================
private static void handleFailure(Call call,
IOException e,
ApiCallback callback,
int retryCount) {
if (retryCount < MAX_RETRY) {
Log.w(TAG, “请求失败,第” + (retryCount + 1) + "次重试: " + e.getMessage());
MAIN_HANDLER.postDelayed(() -> {
call.clone().enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
handleFailure(call, e, callback, retryCount + 1);
}
@Override public void onResponse(Call call, Response response) throws IOException { handleResponse(response, getResponseType(callback), callback); } }); }, 2000); } else { Log.e(TAG, "最终请求失败: " + e.getMessage()); notifyError(callback, -1, "网络请求失败: " + e.getMessage()); }
}
// ====================== 类型处理工具 ======================
/**
获取响应类型(通过回调接口的泛型参数)
*/
private static Type getResponseType(ApiCallback callback) {
if (callback == null) {
return new TypeToken(){}.getType();
}
// 尝试获取泛型类型
Type[] genericInterfaces = callback.getClass().getGenericInterfaces();
for (Type type : genericInterfaces) {
if (type instanceof ParameterizedType) {
ParameterizedType pType = (ParameterizedType) type;
if (pType.getRawType().equals(ApiCallback.class)) {
Type dataType = pType.getActualTypeArguments()[0];
return TypeToken.getParameterized(Information.class, dataType).getType();
}
}
}
// 默认返回Object类型
Log.w(TAG, “无法确定响应类型,使用默认Object类型”);
return new TypeToken(){}.getType();
}
// ====================== 回调通知方法 ======================
private static void notifySuccess(ApiCallback callback, R data) {
if (callback != null) {
MAIN_HANDLER.post(() -> callback.onSuccess(data));
}
}
private static void notifyError(ApiCallback callback, int code, String error) {
if (callback != null) {
MAIN_HANDLER.post(() -> callback.onError(code, error));
}
}
// ====================== 专用API方法 ======================
/**
执行JSON API请求
@param url API地址
@param method 请求方法
@param requestData 请求数据
@param callback 回调接口
@param 请求数据类型
@param 响应数据类型
*/
public static <T, R> void jsonRequest(String url,
String method,
T requestData,
ApiCallback callback) {
Request request = buildJsonRequest(url, method, requestData);
executeRequest(request, getResponseType(callback), callback);
}
/**
执行表单API请求
@param url API地址
@param method 请求方法
@param formData 表单数据
@param callback 回调接口
@param 响应数据类型
*/
public static void formRequest(String url,
String method,
Map<String, String> formData,
ApiCallback callback) {
Request request = buildFormRequest(url, method, formData);
executeRequest(request, getResponseType(callback), callback);
}
// ====================== 便捷方法 ======================
public static <T, R> void postJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “POST”, data, callback);
}
public static <T, R> void putJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “PUT”, data, callback);
}
public static <T, R> void deleteJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “DELETE”, data, callback);
}
public static void get(String url, ApiCallback callback) {
Request request = new Request.Builder().url(url).get().build();
executeRequest(request, getResponseType(callback), callback);
}
// ====================== 登录专用方法 ======================
public static void login(String username, String password, LoginCallback callback) {
String url = MyAppFunction.getApiUrl(“url_login”);
Log.d(TAG, "login: " + url);
formRequest(url, “POST”, Map.of( “andy”, username, “pass”, password ), new ApiCallback() { @Override public void onSuccess(User user) { if (callback != null) callback.onSuccess(user); } @Override public void onError(int statusCode, String error) { if (callback != null) callback.onFailure(error); } });
}
// ====================== 回调接口定义 ======================
public interface ApiCallback {
void onSuccess(T data);
void onError(int statusCode, String error);
}
public interface LoginCallback {
void onSuccess(User user);
void onFailure(String error);
}
}
package com.example.kucun2.entity.data;
import android.os.Handler;
import android.os.Looper;
import android.util.Log;
import com.example.kucun2.entity.Information;
import com.example.kucun2.entity.User;
import com.example.kucun2.function.MyAppFunction;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import okhttp3.*;
import java.io.IOException;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.util.Map;
/**
重构版API客户端 - 更灵活的类型处理
主要改进:
分离请求参数类型和响应类型
支持多种请求方法(GET/POST/PUT/DELETE)
支持表单和JSON两种请求格式
自动推导响应类型
统一的请求执行流程
*/
public class ApiClient {
private static final Gson gson = GsonFactory.createGson();
private static final String TAG = “ApiClient”;
private static final MediaType JSON = MediaType.get(“application/json; charset=utf-8”);
private static final int MAX_RETRY = 3;
private static final Handler MAIN_HANDLER = new Handler(Looper.getMainLooper());
// ====================== 核心请求方法 ======================
/**
执行API请求(核心方法)
@param request 构建好的OkHttp请求
@param responseType 期望的响应类型
@param callback 回调接口
@param 响应数据类型
*/
public static void executeRequest(Request request,
Type responseType,
ApiCallback callback) {
OkHttpClient client = MyAppFunction.getClient();
client.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
handleFailure(call, e, callback, 0);
}
@Override public void onResponse(Call call, Response response) throws IOException { handleResponse(response, responseType, callback); }
});
}
// ====================== 请求构建方法 ======================
/**
构建JSON请求
@param url API地址
@param method 请求方法(“POST”, “PUT”, “DELETE”)
@param requestData 请求数据对象
@return 构建好的Request对象
*/
public static Request buildJsonRequest(String url, String method, Object requestData) {
String jsonRequest = ReflectionJsonUtils.toJson(requestData);
Log.d(TAG, method + " URL: " + url);
Log.d(TAG, "请求数据: " + jsonRequest);
RequestBody body = RequestBody.create(JSON, jsonRequest);
return new Request.Builder()
.url(url)
.method(method, body)
.build();
}
/**
构建表单请求
@param url API地址
@param method 请求方法
@param formData 表单数据
@return 构建好的Request对象
*/
public static Request buildFormRequest(String url, String method, Map<String, String> formData) {
FormBody.Builder builder = new FormBody.Builder();
for (Map.Entry<String, String> entry : formData.entrySet()) {
builder.add(entry.getKey(), entry.getValue());
}
Log.d(TAG, method + " URL: " + url);
Log.d(TAG, "表单数据: " + formData);
return new Request.Builder()
.url(url)
.method(method, builder.build())
.build();
}
// ====================== 响应处理方法 ======================
private static void handleResponse(Response response,
Type responseType,
ApiCallback callback) throws IOException {
try (ResponseBody responseBody = response.body()) {
if (!response.isSuccessful()) {
String error = "HTTP " + response.code() + ": " + response.message();
Log.e(TAG, error);
notifyError(callback, response.code(), error);
return;
}
String jsonResponse = responseBody.string(); Log.d(TAG, "服务器响应: " + jsonResponse); // 解析服务端的Information包装 Information wrapper = gson.fromJson(jsonResponse, responseType); if (wrapper != null && wrapper.getStatus() == 200) { notifySuccess(callback, wrapper.getData()); } else { String errorMsg = wrapper != null ? "服务端错误: " + wrapper.getStatus() + " - " + wrapper.getText() : “无效的响应格式”; Log.e(TAG, errorMsg); notifyError(callback, wrapper != null ? wrapper.getStatus() : -1, errorMsg); } } catch (Exception e) { Log.e(TAG, "响应处理异常: " + e.getMessage()); notifyError(callback, -2, "数据处理异常: " + e.getMessage()); }
}
// ====================== 失败处理与重试 ======================
private static void handleFailure(Call call,
IOException e,
ApiCallback callback,
int retryCount) {
if (retryCount < MAX_RETRY) {
Log.w(TAG, “请求失败,第” + (retryCount + 1) + "次重试: " + e.getMessage());
MAIN_HANDLER.postDelayed(() -> {
call.clone().enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
handleFailure(call, e, callback, retryCount + 1);
}
@Override public void onResponse(Call call, Response response) throws IOException { handleResponse(response, getResponseType(callback), callback); } }); }, 2000); } else { Log.e(TAG, "最终请求失败: " + e.getMessage()); notifyError(callback, -1, "网络请求失败: " + e.getMessage()); }
}
// ====================== 类型处理工具 ======================
/**
获取响应类型(通过回调接口的泛型参数)
*/
private static Type getResponseType(ApiCallback callback) {
if (callback == null) {
return new TypeToken(){}.getType();
}
// 尝试获取泛型类型
Type[] genericInterfaces = callback.getClass().getGenericInterfaces();
for (Type type : genericInterfaces) {
if (type instanceof ParameterizedType) {
ParameterizedType pType = (ParameterizedType) type;
if (pType.getRawType().equals(ApiCallback.class)) {
Type dataType = pType.getActualTypeArguments()[0];
return TypeToken.getParameterized(Information.class, dataType).getType();
}
}
}
// 默认返回Object类型
Log.w(TAG, “无法确定响应类型,使用默认Object类型”);
return new TypeToken(){}.getType();
}
// ====================== 回调通知方法 ======================
private static void notifySuccess(ApiCallback callback, R data) {
if (callback != null) {
MAIN_HANDLER.post(() -> callback.onSuccess(data));
}
}
private static void notifyError(ApiCallback callback, int code, String error) {
if (callback != null) {
MAIN_HANDLER.post(() -> callback.onError(code, error));
}
}
// ====================== 专用API方法 ======================
/**
执行JSON API请求
@param url API地址
@param method 请求方法
@param requestData 请求数据
@param callback 回调接口
@param 请求数据类型
@param 响应数据类型
*/
public static <T, R> void jsonRequest(String url,
String method,
T requestData,
ApiCallback callback) {
Request request = buildJsonRequest(url, method, requestData);
executeRequest(request, getResponseType(callback), callback);
}
/**
执行表单API请求
@param url API地址
@param method 请求方法
@param formData 表单数据
@param callback 回调接口
@param 响应数据类型
*/
public static void formRequest(String url,
String method,
Map<String, String> formData,
ApiCallback callback) {
Request request = buildFormRequest(url, method, formData);
executeRequest(request, getResponseType(callback), callback);
}
// ====================== 便捷方法 ======================
public static <T, R> void postJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “POST”, data, callback);
}
public static <T, R> void putJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “PUT”, data, callback);
}
public static <T, R> void deleteJson(String url, T data, ApiCallback callback) {
jsonRequest(url, “DELETE”, data, callback);
}
public static void get(String url, ApiCallback callback) {
Request request = new Request.Builder().url(url).get().build();
executeRequest(request, getResponseType(callback), callback);
}
// ====================== 登录专用方法 ======================
public static void login(String username, String password, LoginCallback callback) {
String url = MyAppFunction.getApiUrl(“url_login”);
Log.d(TAG, "login: " + url);
formRequest(url, “POST”, Map.of( “andy”, username, “pass”, password ), new ApiCallback() { @Override public void onSuccess(User user) { if (callback != null) callback.onSuccess(user); } @Override public void onError(int statusCode, String error) { if (callback != null) callback.onFailure(error); } });
}
// ====================== 回调接口定义 ======================
public interface ApiCallback {
void onSuccess(T data);
void onError(int statusCode, String error);
}
public interface LoginCallback {
void onSuccess(User user);
void onFailure(String error);
}
}
SynchronizableEntity根据ApiClient构建数据请求,创建和查询方法返回的数据类型不同,并且期待返回的类型是基类但是返回的数据是实体类的全部字段很多字段就没有了吧