Flutter数据安全与保护插件data_dome_plugin的使用

插件说明

Flutter有自己的网络实现方式，但此插件分别使用了iOS上的URLSession和Android上的OkHttp。

注意事项

如果您的项目不支持Swift/Kotlin，请查看这里。

iOS配置

1. 在../ios/Runner/Info.plist文件中添加键值对DataDomeKey，其值为您的DataDome密钥字符串。
2. 同样在../ios/Runner/Info.plist文件中添加键值对DataDomeProxyEnabled，其值为布尔值NO。

对于强制显示iOS上的验证码，请参考DataDome iOS SDK文档。

Android配置

方法调用有一个用于传递DataDome密钥的关键参数。

对于强制显示Android上的验证码，请参考DataDome Android SDK文档，但可能无法正常工作。

使用示例

以下是一个完整的示例代码，展示如何使用data_dome_plugin插件进行HTTP请求。

try {
  // 设置请求头
  final headers = {
    'Content-type': 'application/json',
    'Accept': 'application/json',
  };

  // TODO: 填写URL和Android上的DataDome密钥
  final key = ''; // 替换为您的DataDome密钥
  final url = ''; // 替换为您要访问的URL

  // 准备JSON请求体
  final json = {
    "any": "body",
    "some": 1,
    "is": true,
  };
  final body = Uint8List.fromList(utf8.encode(jsonEncode(json)));

  // 调用DataDome插件发送POST请求
  final result = await DataDomePlugin.httpCall(
    HttpMethod.post, // 使用POST方法
    url,
    headers,
    body,
    key,
  );

  // 将结果转换为HTTP响应
  final response = _makeResponse(result);

  // 打印HTTP状态码
  print(response.statusCode.toString());
} on PlatformException {
  print('Failed HTTP call');
}

// 辅助函数：将插件返回的结果转换为HTTP响应对象
http.Response _makeResponse(Map<String, dynamic> resp) {
  final int code = resp['code'] ?? 500; // 提取状态码，默认为500
  final Uint8List data = resp['data'] ?? Uint8List(0); // 提取响应数据，默认为空字节列表
  return http.Response.bytes(
    data.toList(), // 将Uint8List转换为普通List
    code,
    headers: {'content-type': 'application/json; charset=utf-8'}, // 设置响应头
  );
}

完整示例代码

以下是从官方示例代码中提取并简化后的完整代码：

import 'dart:async';
import 'dart:convert';
import 'dart:typed_data';

import 'package:data_dome_plugin/data_dome_plugin.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:http/http.dart' as http;

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('DataDome Plugin Example'),
        ),
        body: Center(
          child: Text('Running on: $_platformVersion\n'),
        ),
      ),
    );
  }

  // 初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;

    try {
      // 配置GET请求
      final headers = {
        'Content-type': 'application/json',
        'Accept': 'application/json',
      };
      final key = ''; // 替换为您的DataDome密钥
      final url = ''; // 替换为您要访问的URL
      final body = null;

      final result = await DataDomePlugin.httpCall(
        HttpMethod.get,
        url,
        headers,
        body,
        key,
      );
      final response = _makeResponse(result);
      platformVersion = response.statusCode.toString();
    } on PlatformException {
      platformVersion = 'Failed HTTP call';
    }

    try {
      // 配置POST请求
      final headers = {
        'Content-type': 'application/json',
        'Accept': 'application/json',
      };
      final key = ''; // 替换为您的DataDome密钥
      final url = ''; // 替换为您要访问的URL
      final json = {
        "any": "body",
        "some": 1,
        "is": true,
      };
      final body = Uint8List.fromList(utf8.encode(jsonEncode(json)));

      final result = await DataDomePlugin.httpCall(
        HttpMethod.post,
        url,
        headers,
        body,
        key,
      );
      final response = _makeResponse(result);
      platformVersion = response.statusCode.toString();
    } on PlatformException {
      platformVersion = 'Failed HTTP call';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 将插件返回的结果转换为HTTP响应对象
  http.Response _makeResponse(Map<String, dynamic> resp) {
    final int code = resp['code'] ?? 500;
    final Uint8List data = resp['data'] ?? Uint8List(0);
    return http.Response.bytes(
      data.toList(),
      code,
      headers: {'content-type': 'application/json; charset=utf-8'},
    );
  }
}