authenticate属性

void authenticate=(Future<bool> f(Uri url, String scheme, String? realm)?)

设置在网站请求认证时调用的函数。

请求的URL、认证方案和安全域从服务器通过参数 f.urlf.schemef.realm 传入。

函数返回一个Future,应在认证解决后完成。如果不能提供凭据,则Future应以false完成。如果可用凭据,应在使用addCredentials添加这些凭据并在Future中用值true完成之前完成。

如果Futuretrue完成,则将使用更新的凭据重试请求,但是,重试的请求不会携带原始请求有效负载。否则,将正常继续响应处理。

如果已知远程服务器需要对所有请求进行认证,建议直接使用addCredentials,或在请求上手动设置'authorization'头,以避免请求失败的开销,或重试请求中缺少请求有效负载的问题。

实现

void set authenticate(
    Future<bool> Function(Uri url, String scheme, String? realm)? f);