// 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); } } }