authenticate属性
设置在网站请求认证时调用的函数。
请求的URL、认证方案和安全域从服务器通过参数 f.url
、f.scheme
和 f.realm
传入。
函数返回一个Future,应在认证解决后完成。如果不能提供凭据,则Future应以false
完成。如果可用凭据,应在使用addCredentials添加这些凭据并在Future中用值true
完成之前完成。
如果Future以true
完成,则将使用更新的凭据重试请求,但是,重试的请求不会携带原始请求有效负载。否则,将正常继续响应处理。
如果已知远程服务器需要对所有请求进行认证,建议直接使用addCredentials,或在请求上手动设置'authorization'
头,以避免请求失败的开销,或重试请求中缺少请求有效负载的问题。
实现
void set authenticate(
Future<bool> Function(Uri url, String scheme, String? realm)? f);