85 lines
3.0 KiB
Dart
85 lines
3.0 KiB
Dart
/// API 配置管理类：统一管理所有 API 端点路径
|
|
class ApiConfig {
|
|
ApiConfig._();
|
|
|
|
// ==================== API 路径（固定不变）====================
|
|
|
|
/// 上报接口路径（固定）
|
|
static const String defaultReportPath = '/api/eventTracking/batchReport.json';
|
|
|
|
/// 上报接口路径
|
|
static String get reportPath => defaultReportPath;
|
|
|
|
// ==================== 配置方法 ====================
|
|
|
|
/// 构建完整的 URL
|
|
/// [baseDomain] 基础域名，如 'https://api.example.com'
|
|
/// [path] API 路径，如 '/api/analytics/report'
|
|
/// [appId] 应用ID（可选），如果提供会作为查询参数添加到URL中
|
|
/// 返回完整的 URL，如 'https://api.example.com/api/analytics/report?appId=xxx'
|
|
static String buildUrl(String baseDomain, String path, {String? appId}) {
|
|
// 确保路径以 / 开头
|
|
final normalizedPath = _normalizePath(path);
|
|
|
|
// 解析基础域名
|
|
final uri = Uri.parse(baseDomain);
|
|
final scheme = uri.scheme.isEmpty ? 'https' : uri.scheme;
|
|
final host = uri.host.isEmpty ? baseDomain : uri.host;
|
|
|
|
// 保留非默认端口（如 :8080），避免 IP+端口 场景下端口丢失
|
|
final defaultPort = scheme == 'https' ? 443 : 80;
|
|
final portSuffix =
|
|
(uri.port > 0 && uri.port != defaultPort) ? ':${uri.port}' : '';
|
|
|
|
// 保留 baseDomain 中的路径前缀（如 /v2），仅在 host 成功解析时使用
|
|
// 去掉末尾 / 避免与 normalizedPath 拼出双斜杠
|
|
final basePath = uri.host.isNotEmpty && uri.path.isNotEmpty && uri.path != '/'
|
|
? (uri.path.endsWith('/')
|
|
? uri.path.substring(0, uri.path.length - 1)
|
|
: uri.path)
|
|
: '';
|
|
|
|
// 构建完整 URL
|
|
String url = '$scheme://$host$portSuffix$basePath$normalizedPath';
|
|
|
|
// 如果提供了 appId，添加到查询参数
|
|
if (appId != null && appId.isNotEmpty) {
|
|
url = _addQueryParameter(url, 'appId', appId);
|
|
}
|
|
|
|
return url;
|
|
}
|
|
|
|
/// 规范化路径：确保路径以 / 开头
|
|
static String _normalizePath(String path) {
|
|
if (path.isEmpty) {
|
|
return '/';
|
|
}
|
|
return path.startsWith('/') ? path : '/$path';
|
|
}
|
|
|
|
/// 获取上报接口 URL
|
|
/// [baseDomain] 基础域名
|
|
/// [appId] 应用ID（可选，如果提供会作为查询参数）
|
|
static String getReportUrl(String baseDomain, {String? appId}) {
|
|
return buildUrl(baseDomain, reportPath, appId: appId);
|
|
}
|
|
|
|
/// 添加查询参数到 URL
|
|
/// [url] 原始 URL
|
|
/// [key] 参数名
|
|
/// [value] 参数值
|
|
static String _addQueryParameter(String url, String key, String value) {
|
|
try {
|
|
final uri = Uri.parse(url);
|
|
final queryParams = Map<String, String>.from(uri.queryParameters);
|
|
queryParams[key] = value;
|
|
return uri.replace(queryParameters: queryParams).toString();
|
|
} catch (e) {
|
|
// 如果 URL 解析失败，直接拼接
|
|
final separator = url.contains('?') ? '&' : '?';
|
|
return '$url$separator$key=${Uri.encodeComponent(value)}';
|
|
}
|
|
}
|
|
}
|