Flutter本地存储管理插件sweet_cookie_jar的使用

1. About

Usable cookie management library in Dart

SweetCookieJar 是一个开源的Dart库。借助 SweetCookieJar，您可以轻松地在应用程序中管理cookie。它扩展了官方 Cookie 类的功能，并且可以与 http 包中的 Responses 一起工作。即使响应头中设置了多个 set-cookie，这也是 http 包的一个弱点，但 SweetCookieJar 可以非常方便地管理这些cookie信息！

不再需要复杂的实现来处理响应头中设置的多个 set-cookie。只需将 Response 传递给 SweetCookieJar 的构造函数即可！

1.1. Introduction

1.1.1. Install Library

• With Dart:

  dart pub add sweet_cookie_jar
  

• With Flutter:

  flutter pub add sweet_cookie_jar
  

1.1.2. Import It

import 'package:sweet_cookie_jar/sweet_cookie_jar.dart';

1.1.3. Use SweetCookieJar

import 'package:sweet_cookie_jar/sweet_cookie_jar.dart';

void main() {
    // The cookie set in the response header
    // will be extracted by the constructor process.
    final cookieJar = SweetCookieJar.from(response: response);

    if (cookieJar.isEmpty) {
        // It means that there is no cookie information
        // in the response header.
        return;
    }

    // You can find cookie by name easily.
    final cookie = cookieJar.find(name: 'AWSALB');
    print(cookie.name);
    print(cookie.value);

    // Also you can get cookie as JSON format.
    print(cookie.toJson());

    if (cookie.isExpired) {
        // Do something when cookie is expired.
        return;
    }
}

示例代码

// Copyright (c) 2021, Kato Shinya. All rights reserved.
// Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'package:http/http.dart' as http;
import 'package:sweet_cookie_jar/sweet_cookie_jar.dart';

class DemoSweetCookieJar {
  void main() async {
    // Simulate an HTTP response with multiple set-cookie headers
    final response = http.Response(
      '',
      200,
      headers: {
        'set-cookie':
            'AWSALB=CGSOoaFEi91n9xSfeeSxoUvs0A/TTQn9/Mbxe8dtkv50cBqJmHTwPw3; Expires=Tue, 14 Dec 2021 02:20:37 GMT; Path=/,AWSALBCORS=OHhxYMU0mU7WOoh+4RH5bxe8d6AytmnHaZNGUBqJmHTwPw3; Expires=Tue, 14 Dec 2021 02:20:37 GMT; Path=/; SameSite=None; Secure,jwt_token=test; Domain=.test; Max-Age=31536000; Path=/; expires=Wed, 07-Dec-2022 02:20:37 GMT; SameSite=lax; Secure,csrf_token=test==; Domain=.test; Max-Age=31536000; Path=/; expires=Wed, 07-Dec-2022 02:20:37 GMT,csrf_token=test==; Domain=.test; Max-Age=31536000; Path=/; expires=Wed, 07-Dec-2022 02:20:37 GMT,wuuid=77be8f46-4'
      },
    );

    final cookieJar = SweetCookieJar.from(response: response);

    if (cookieJar.isEmpty) {
      // It means that there is no cookie information
      // in the response header.
      print('No cookies found.');
      return;
    }

    // Find and print specific cookie details
    final cookie = cookieJar.find(name: 'AWSALB');
    if (cookie != null) {
      print('Cookie Name: ${cookie.name}');
      print('Cookie Value: ${cookie.value}');
      print('Cookie JSON: ${cookie.toJson()}');

      if (cookie.isExpired) {
        print('This cookie has expired.');
      } else {
        print('This cookie is still valid.');
      }
    } else {
      print('Cookie not found.');
    }
  }
}

在这个示例中，我们模拟了一个HTTP响应，其中包含多个 set-cookie 头。通过 SweetCookieJar，我们可以轻松提取并管理这些cookie。这个示例展示了如何查找特定名称的cookie、打印其详细信息以及检查其是否已过期。

希望这个详细的介绍和示例代码能帮助您更好地理解和使用 sweet_cookie_jar 插件！如果有任何问题或需要进一步的帮助，请随时提问。