DefaultNetworkDelegate (JxBrowser 6.23.1 API)

java.lang.Object
- com.teamdev.jxbrowser.chromium.javafx.DefaultNetworkDelegate

All Implemented Interfaces:: NetworkDelegate

public class DefaultNetworkDelegate
extends java.lang.Object
implements NetworkDelegate

Constructor Summary

Constructors
Constructor and Description
`DefaultNetworkDelegate()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`onAuthRequired(AuthRequiredParams params)` This method is invoked when a request receives an authentication challenge and is unable to respond using cached credentials. 当请求收到身份验证质询并且无法使用缓存的凭据进行响应时，将调用此方法。
`void`	`onBeforeRedirect(BeforeRedirectParams params)` This method is invoked when a server-initiated redirect is about to occur. 当服务器启动的重定向即将发生时，将调用此方法。
`void`	`onBeforeSendHeaders(BeforeSendHeadersParams params)` This method is invoked when a request is about to occur and the initial headers have been prepared. 当即将发生请求并且已经准备好初始标头时，将调用此方法。
`void`	`onBeforeSendProxyHeaders(BeforeSendProxyHeadersParams params)` The similar to `NetworkDelegate.onBeforeSendHeaders(BeforeSendHeadersParams)` method. 与NetworkDelegate.onBeforeSendHeaders（BeforeSendHeadersParams）方法类似。
`void`	`onBeforeURLRequest(BeforeURLRequestParams params)` This method is invoked when a request is about to occur. 当即将发生请求时，将调用此方法。
`boolean`	`onCanGetCookies(java.lang.String url, java.util.List<Cookie> cookies)` This method is invoked when Chromium engine decides whether `cookies` can be sent back to the web server. 当Chromium引擎决定是否可以将Cookie发送回Web服务器时，将调用此方法。
`boolean`	`onCanSetCookies(java.lang.String url, java.util.List<Cookie> cookies)` This method is invoked when Chromium engine decides whether `cookies` can be saved for the `url` or not. 当Chromium引擎决定是否可以为URL保存cookie时，将调用此方法。
`void`	`onCompleted(RequestCompletedParams params)` This method is invoked when a request has been processed successfully or failed. 请求成功或失败处理后，将调用此方法。
`void`	`onDataReceived(DataReceivedParams params)` This method is invoked each time when a part of the response body is received. 每当接收到响应主体的一部分时，都会调用此方法。
`void`	`onDestroyed(RequestParams params)` This method is invoked when a request is being destroyed. 销毁请求时将调用此方法。
`void`	`onHeadersReceived(HeadersReceivedParams params)` This method is invoked each time that an HTTP(S) response header is received. 每当接收到HTTP（S）响应标头时，都会调用此方法。
`void`	`onPACScriptError(PACScriptErrorParams params)` This method is invoked when Chromium proxy resolver failed to parse PAC script file to extract proxy settings. 当Chromium代理解析程序无法解析PAC脚本文件以提取代理设置时，将调用此方法。
`void`	`onResponseStarted(ResponseStartedParams params)` This method is invoked when the first byte of the response body is received. 当接收到响应主体的第一个字节时，将调用此方法。
`void`	`onSendHeaders(SendHeadersParams params)` This method is invoked right before the HTTP headers are sent to the network. 在HTTP标头发送到网络之前，将立即调用此方法。

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DefaultNetworkDelegate
```
public DefaultNetworkDelegate()
```
- Method Detail
  - onBeforeURLRequest
```
public void onBeforeURLRequest(BeforeURLRequestParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when a request is about to occur. This event is sent before any TCP connection is made and can be used to redirect requests to another location. This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, then default behavior will be used - the target URL will not be changed.
    当即将发生请求时，将调用此方法。在建立任何TCP连接之前发送此事件，该事件可用于将请求重定向到另一个位置。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则将使用默认行为-目标URL将不会更改。
    
    Specified by:
    
    onBeforeURLRequest in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL and HTTP method ("GET", "POST", etc.). To override the target URL use the RequestParams.setURL(String) method. -提供有关请求URL和HTTP方法的信息（“ GET”，“ POST”等）。要覆盖目标URL，请使用方法。
  - onBeforeRedirect
```
public void onBeforeRedirect(BeforeRedirectParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when a server-initiated redirect is about to occur. This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, the loading process will not be affected.
    当服务器启动的重定向即将发生时，将调用此方法。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则加载过程将不受影响。
    
    Specified by:
    
    onBeforeRedirect in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about the current URL, new URL, HTTP method ("GET", "POST", etc.) and HTTP response code (e.g., 200, 404, and so on). -提供有关当前URL，新URL，HTTP方法（“ GET”，“ POST”等）和HTTP响应代码（例如200、404等）的信息。
  - onBeforeSendHeaders
```
public void onBeforeSendHeaders(BeforeSendHeadersParams params)
```
    Description copied from interface: NetworkDelegate
    This method is invoked when a request is about to occur and the initial headers have been prepared. It allows adding, modifying, and deleting HTTP request headers. This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, the loading process will not be affected.
    Note that one URL request can be split into several HTTP requests (for example to fetch individual byte ranges from a large file) or can be handled by the network stack without communicating with the network. For this reason, the event does not provide the final HTTP headers that are sent to the network. For example, all headers that are related to caching are invisible.
    
    The following headers are currently not provided to the onBeforeSendHeaders event.
    - Authorization
    - Cache-Control
    - Connection
    - Content-Length
    - Host
    - If-Modified-Since
    - If-None-Match
    - If-Range
    - Partial-Data
    - Pragma
    - Proxy-Authorization
    - Proxy-Connection
    - Transfer-Encoding
    当即将发生请求并且已经准备好初始标头时，将调用此方法。它允许添加，修改和删除HTTP请求标头。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则加载过程将不受影响。请注意，一个URL请求可以分为几个HTTP请求（例如，从一个大文件中提取单个字节范围），或者可以由网络堆栈处理而无需与网络进行通信。因此，该事件不提供发送到网络的最终HTTP标头。例如，所有与缓存相关的标头都是不可见的。当前未向onBeforeSendHeaders事件提供以下标头。授权缓存控制连接内容长度主机If-Modified-If-None-Match-If-Range部分数据语法Proxy-授权Proxy-Connection传输编码
    
    Specified by:
    
    onBeforeSendHeaders in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.) and HTTP request headers. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等）和HTTP请求标头的信息。
  - onSendHeaders
```
public void onSendHeaders(SendHeadersParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked right before the HTTP headers are sent to the network. This event is informational and it does not allow modifying HTTP headers. This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, the loading process will not be affected.
    在HTTP标头发送到网络之前，将立即调用此方法。此事件是信息性事件，它不允许修改HTTP标头。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则加载过程将不受影响。
    
    Specified by:
    
    onSendHeaders in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.) and HTTP request headers. HTTP headers overriding has no effect. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等）和HTTP请求标头的信息。 HTTP标头覆盖无效。
  - onHeadersReceived
```
public void onHeadersReceived(HeadersReceivedParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked each time that an HTTP(S) response header is received. Due to redirects and authentication requests this can happen multiple times per request. This event is intended to allow adding, modifying, and deleting HTTP response headers, such as incoming "Set-Cookie" headers.
    This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, the loading process will not be affected.
    
    每当接收到HTTP（S）响应标头时，都会调用此方法。由于重定向和身份验证请求，每个请求可能会多次发生。此事件旨在允许添加，修改和删除HTTP响应标头，例如传入的“ Set-Cookie”标头。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则加载过程将不受影响。
    
    Specified by:
    
    onHeadersReceived in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.) and HTTP request headers. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等）和HTTP请求标头的信息。
  - onResponseStarted
```
public void onResponseStarted(ResponseStartedParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when the first byte of the response body is received. For HTTP requests, this means that the status line and response headers are available. This event is informational.
    This method is invoked synchronously. URL request will be blocked while this method is executing. If this method throws an exception, the loading process will not be affected.
    
    当接收到响应主体的第一个字节时，将调用此方法。对于HTTP请求，这意味着状态行和响应标头均可用。此事件是信息性的。该方法被同步调用。执行此方法时，URL请求将被阻止。如果此方法引发异常，则加载过程将不受影响。
    
    Specified by:
    
    onResponseStarted in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.) and HTTP response code. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等）和HTTP响应代码的信息。
  - onDataReceived
```
public void onDataReceived(DataReceivedParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked each time when a part of the response body is received. When the whole response body is received, NetworkDelegate.onCompleted(RequestCompletedParams) method will be fired. This event is informational.
    Note that Mime-Type and Charset, provided by DataReceivedParams, are taken from response headers and may be overridden by NetworkDelegate.onHeadersReceived(HeadersReceivedParams) method.
    
    每当接收到响应主体的一部分时，都会调用此方法。收到整个响应正文后，将触发NetworkDelegate.onCompleted（RequestCompletedParams）方法。此事件是信息性的。请注意，由DataReceivedParams提供的Mime-Type和Charset是从响应头中获取的，并且可以被NetworkDelegate.onHeadersReceived（HeadersReceivedParams）方法覆盖。
    
    Specified by:
    
    onDataReceived in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.), Mime-Type, and response data. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等），Mime-Type和响应数据的信息。
  - onCompleted
```
public void onCompleted(RequestCompletedParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when a request has been processed successfully or failed. You can get information about HTTP request status via the RequestCompletedParams.getStatus() method. If HTTP request status is RequestStatus.FAILED, you can get information about network error using the RequestCompletedParams.getErrorCode() method.
    请求成功或失败处理后，将调用此方法。您可以通过RequestCompletedParams.getStatus（）方法获取有关HTTP请求状态的信息。如果HTTP请求状态为RequestStatus.FAILED，则可以使用RequestCompletedParams.getErrorCode（）方法获取有关网络错误的信息。
    
    Specified by:
    
    onCompleted in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request URL, HTTP method ("GET", "POST", etc.), request status, response code and network error code. -提供有关请求URL，HTTP方法（“ GET”，“ POST”等），请求状态，响应代码和网络错误代码的信息。
  - onDestroyed
```
public void onDestroyed(RequestParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when a request is being destroyed.
    销毁请求时将调用此方法。
    
    Specified by:
    
    onDestroyed in interface NetworkDelegate
    
    Parameters:
    
    params - provides information about request. -提供有关请求的信息。
  - onAuthRequired
```
public boolean onAuthRequired(AuthRequiredParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when a request receives an authentication challenge and is unable to respond using cached credentials. You can use this method to handle "basic" or "digest" authentication.
    FYI: to test "basic" or "digest" authentication you can use http://test.webdav.org/
    
    当请求收到身份验证质询并且无法使用缓存的凭据进行响应时，将调用此方法。您可以使用此方法来处理“基本”或“摘要”身份验证。仅供参考：要测试“基本”或“摘要”身份验证，可以使用http://test.webdav.org/
    
    Specified by:
    
    onAuthRequired in interface NetworkDelegate
    
    Parameters:
    
    params - the authentication challenge information such as authentication scheme, URL etc. Use AuthRequiredParams.setUsername(String) and AuthRequiredParams.setPassword(String) to provide authentication credentials. -身份验证质询信息，例如身份验证方案，URL等。使用和提供身份验证凭据。
    
    Returns:
    
    true when authentication must be canceled. 何时必须取消身份验证。
  - onCanSetCookies
```
public boolean onCanSetCookies(java.lang.String url,
                               java.util.List<Cookie> cookies)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when Chromium engine decides whether cookies can be saved for the url or not. Return true to allow engine to save the cookies. If you return false, the cookies will not be saved and will not be available in CookieStorage.
    If this method throws an exception, then default behavior will be applied - the method returns true.
    
    当Chromium引擎决定是否可以为URL保存cookie时，将调用此方法。返回true以允许引擎保存cookie。如果返回false，则cookie将不会被保存，并且在CookieStorage中将不可用。如果此方法引发异常，则将应用默认行为-该方法返回true。
    
    Specified by:
    
    onCanSetCookies in interface NetworkDelegate
    
    Parameters:
    
    url - a string representation of the URL associated with the cookies. -与关联的URL的字符串表示形式。
    
    cookies - a list of cookies to apply. -要应用的Cookie列表。
    
    Returns:
    
    true to allow saving cookies. 允许保存cookie。
  - onCanGetCookies
```
public boolean onCanGetCookies(java.lang.String url,
                               java.util.List<Cookie> cookies)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when Chromium engine decides whether cookies can be sent back to the web server. Return true to allow cookies to be sent to the web server.
    If this method throws an exception, then default behavior will be applied - the method returns true.
    
    当Chromium引擎决定是否可以将Cookie发送回Web服务器时，将调用此方法。返回true以允许将cookie发送到Web服务器。如果此方法引发异常，则将应用默认行为-该方法返回true。
    
    Specified by:
    
    onCanGetCookies in interface NetworkDelegate
    
    Parameters:
    
    url - a string representation of the URL associated with the cookies. -与关联的URL的字符串表示形式。
    
    cookies - a list of cookies to send. -要发送的Cookie列表。
    
    Returns:
    
    true to allow sending cookies. 允许发送cookie。
  - onBeforeSendProxyHeaders
```
public void onBeforeSendProxyHeaders(BeforeSendProxyHeadersParams params)
```
    Description copied from interface: NetworkDelegate
    
    The similar to NetworkDelegate.onBeforeSendHeaders(BeforeSendHeadersParams) method. Fires when proxy connection is used, after onBeforeSendHeaders method is invoked. Provides information about proxy connection, and also allows adding, modifying, and deleting HTTP request headers.
    与NetworkDelegate.onBeforeSendHeaders（BeforeSendHeadersParams）方法类似。在调用onBeforeSendHeaders方法之后，使用代理连接时触发。提供有关代理连接的信息，还允许添加，修改和删除HTTP请求标头。
    
    Specified by:
    
    onBeforeSendProxyHeaders in interface NetworkDelegate
  - onPACScriptError
```
public void onPACScriptError(PACScriptErrorParams params)
```
    Description copied from interface: NetworkDelegate
    
    This method is invoked when Chromium proxy resolver failed to parse PAC script file to extract proxy settings.
    当Chromium代理解析程序无法解析PAC脚本文件以提取代理设置时，将调用此方法。
    
    Specified by:
    
    onPACScriptError in interface NetworkDelegate
    
    Parameters:
    
    params - details about PAC script error such as line number and error message. -有关PAC脚本错误的详细信息，例如行号和错误消息。

Class DefaultNetworkDelegate

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DefaultNetworkDelegate

Method Detail

onBeforeURLRequest

onBeforeRedirect

onBeforeSendHeaders

onSendHeaders

onHeadersReceived

onResponseStarted

onDataReceived

onCompleted

onDestroyed

onAuthRequired

onCanSetCookies

onCanGetCookies

onBeforeSendProxyHeaders

onPACScriptError