// Copyright © 2021 The CefSharp Authors. All rights reserved.
//
// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
using System.IO;
namespace CefSharp.Fluent
{
///
/// Called on the CEF IO thread when the browser needs credentials from the user.
/// This method will only be called for requests initiated from the browser process.
///
/// indicates whether the host is a proxy server.
/// the hostname.
/// the port number.
/// realm
/// scheme
/// is a callback for authentication information
///
/// Return true to continue the request and call when the authentication information is available.
/// If the request has an associated browser/frame then returning false will result in a call to
/// on the associated with that browser, if any.
/// Otherwise, returning false will cancel the request immediately.
///
public delegate bool GetAuthCredentialsDelegate(bool isProxy, string host, int port, string realm, string scheme, IAuthCallback callback);
///
/// Called when some part of the response is read. This method will not be called if the flag is set on the request.
///
/// request
/// A stream containing the bytes received since the last call. Cannot be used outside the scope of this method.
public delegate void OnDownloadDataDelegate(IUrlRequest request, Stream data);
///
/// Notifies the client of download progress.
///
/// request
/// denotes the number of bytes received up to the call
/// is the expected total size of the response (or -1 if not determined).
public delegate void OnDownloadProgressDelegate(IUrlRequest request, long current, long total);
///
/// Notifies the client that the request has completed.
/// Use the property to determine if the
/// request was successful or not.
///
/// request
public delegate void OnRequestCompleteDelegate(IUrlRequest request);
///
/// Notifies the client of upload progress.
/// This method will only be called if the UR_FLAG_REPORT_UPLOAD_PROGRESS flag is set on the request.
///
/// request
/// denotes the number of bytes sent so far.
/// is the total size of uploading data (or -1 if chunked upload is enabled).
public delegate void OnUploadProgressDelegate(IUrlRequest request, long current, long total);
///
/// Fluent UrlRequestClient
///
public class UrlRequestClient : CefSharp.UrlRequestClient
{
private GetAuthCredentialsDelegate getAuthCredentials;
private OnDownloadDataDelegate onDownloadData;
private OnDownloadProgressDelegate onDownloadProgress;
private OnRequestCompleteDelegate onRequestComplete;
private OnUploadProgressDelegate onUploadProgress;
///
/// Create a new UrlRequestClient Builder
///
/// Fluent UrlRequestClient Builder
public static UrlRequestClientBuilder Create()
{
return new UrlRequestClientBuilder();
}
///
/// Use to create a new instance of the fluent builder
///
internal UrlRequestClient()
{
}
internal void SetGetAuthCredentials(GetAuthCredentialsDelegate func)
{
getAuthCredentials = func;
}
internal void SetOnDownloadData(OnDownloadDataDelegate action)
{
onDownloadData = action;
}
internal void SetOnDownloadProgress(OnDownloadProgressDelegate action)
{
onDownloadProgress = action;
}
internal void SetOnRequestComplete(OnRequestCompleteDelegate action)
{
onRequestComplete = action;
}
internal void SetOnUploadProgress(OnUploadProgressDelegate action)
{
onUploadProgress = action;
}
///
protected override bool GetAuthCredentials(bool isProxy, string host, int port, string realm, string scheme, IAuthCallback callback)
{
return getAuthCredentials?.Invoke(isProxy, host, port, realm, scheme, callback) ?? false;
}
///
protected override void OnDownloadData(IUrlRequest request, Stream data)
{
onDownloadData?.Invoke(request, data);
}
///
protected override void OnDownloadProgress(IUrlRequest request, long current, long total)
{
onDownloadProgress?.Invoke(request, current, total);
}
///
protected override void OnRequestComplete(IUrlRequest request)
{
onRequestComplete?.Invoke(request);
}
///
protected override void OnUploadProgress(IUrlRequest request, long current, long total)
{
onUploadProgress?.Invoke(request, current, total);
}
}
}