SslErrorHandler

Kotlin |Java

public class SslErrorHandler
extends Handler

java.lang.Object
↳	android.os.Handler
	↳	android.webkit.SslErrorHandler

Represents a request for handling an SSL error.

A WebView creates an instance of this class. The instance is passed to WebViewClient.onReceivedSslError(WebView, SslErrorHandler, SslError).

The host application must call cancel() or, contrary to secure web communication standards, proceed() to provide the web view's response to the request.

Summary

Public methods
`void`	`cancel()` Instructs the `WebView` that encountered the SSL certificate error to terminate communication with the server.
`void`	`proceed()` Instructs the `WebView` that encountered the SSL certificate error to ignore the error and continue communicating with the server.

Inherited methods

From class


        
          android.os.Handler

`static Handler`	`createAsync(Looper looper, Handler.Callback callback)` Create a new Handler whose posted messages and runnables are not subject to synchronization barriers such as display vsync.
`static Handler`	`createAsync(Looper looper)` Create a new Handler whose posted messages and runnables are not subject to synchronization barriers such as display vsync.
`void`	`dispatchMessage(Message msg)` Handle system messages here.
`final void`	`dump(Printer pw, String prefix)`
`final Looper`	`getLooper()`
`String`	`getMessageName(Message message)` Returns a string representing the name of the specified message.
`void`	`handleMessage(Message msg)` Subclasses must implement this to receive messages.
`final boolean`	`hasCallbacks(Runnable r)` Check if there are any pending posts of messages with callback r in the message queue.
`final boolean`	`hasMessages(int what)` Check if there are any pending posts of messages with code 'what' in the message queue.
`final boolean`	`hasMessages(int what, Object object)` Check if there are any pending posts of messages with code 'what' and whose obj is 'object' in the message queue.
`final Message`	`obtainMessage(int what, Object obj)` Same as `obtainMessage()`, except that it also sets the what and obj members of the returned Message.
`final Message`	`obtainMessage()` Returns a new `Message` from the global message pool.
`final Message`	`obtainMessage(int what, int arg1, int arg2)` Same as `obtainMessage()`, except that it also sets the what, arg1 and arg2 members of the returned Message.
`final Message`	`obtainMessage(int what, int arg1, int arg2, Object obj)` Same as `obtainMessage()`, except that it also sets the what, obj, arg1,and arg2 values on the returned Message.
`final Message`	`obtainMessage(int what)` Same as `obtainMessage()`, except that it also sets the what member of the returned Message.
`final boolean`	`post(Runnable r)` Causes the Runnable r to be added to the message queue.
`final boolean`	`postAtFrontOfQueue(Runnable r)` Posts a message to an object that implements Runnable.
`final boolean`	`postAtTime(Runnable r, long uptimeMillis)` Causes the Runnable r to be added to the message queue, to be run at a specific time given by `uptimeMillis`.
`final boolean`	`postAtTime(Runnable r, Object token, long uptimeMillis)` Causes the Runnable r to be added to the message queue, to be run at a specific time given by `uptimeMillis`.
`final boolean`	`postDelayed(Runnable r, long delayMillis)` Causes the Runnable r to be added to the message queue, to be run after the specified amount of time elapses.
`final boolean`	`postDelayed(Runnable r, Object token, long delayMillis)` Causes the Runnable r to be added to the message queue, to be run after the specified amount of time elapses.
`final void`	`removeCallbacks(Runnable r)` Remove any pending posts of Runnable r that are in the message queue.
`final void`	`removeCallbacks(Runnable r, Object token)` Remove any pending posts of Runnable `r` with Object `token` that are in the message queue.
`final void`	`removeCallbacksAndMessages(Object token)` Remove any pending posts of callbacks and sent messages whose `obj` is `token`.
`final void`	`removeMessages(int what)` Remove any pending posts of messages with code 'what' that are in the message queue.
`final void`	`removeMessages(int what, Object object)` Remove any pending posts of messages with code 'what' and whose obj is 'object' that are in the message queue.
`final boolean`	`sendEmptyMessage(int what)` Sends a Message containing only the what value.
`final boolean`	`sendEmptyMessageAtTime(int what, long uptimeMillis)` Sends a Message containing only the what value, to be delivered at a specific time.
`final boolean`	`sendEmptyMessageDelayed(int what, long delayMillis)` Sends a Message containing only the what value, to be delivered after the specified amount of time elapses.
`final boolean`	`sendMessage(Message msg)` Pushes a message onto the end of the message queue after all pending messages before the current time.
`final boolean`	`sendMessageAtFrontOfQueue(Message msg)` Enqueue a message at the front of the message queue, to be processed on the next iteration of the message loop.
`boolean`	`sendMessageAtTime(Message msg, long uptimeMillis)` Enqueue a message into the message queue after all pending messages before the absolute time (in milliseconds) `uptimeMillis`.
`final boolean`	`sendMessageDelayed(Message msg, long delayMillis)` Enqueue a message into the message queue after all pending messages before (current time + delayMillis).
`String`	`toString()` Returns a string representation of the object.

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

cancel

Added in API level 1

public void cancel ()

Instructs the WebView that encountered the SSL certificate error to terminate communication with the server. Cancels the current server request and all pending requests for the WebView.

The host application must call this method to prevent a resource from loading when an SSL certificate is invalid.

See also:

WebViewClient.onReceivedSslError(WebView, SslErrorHandler, SslError)

proceed

Added in API level 1

public void proceed ()

Instructs the WebView that encountered the SSL certificate error to ignore the error and continue communicating with the server.

Warning: When an SSL error occurs, the host application should always call cancel() rather than proceed() because an invalid SSL certificate means the connection is not secure.

See also:

WebViewClient.onReceivedSslError(WebView, SslErrorHandler, SslError)