WebViewClient.java revision 881c49c99be006f90a51a444db6b96289947e73a
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.webkit; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Bitmap; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.http.SslError; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.KeyEvent; 23d6b1098e1f46530528dfea415655468ec994bbb6John Reckimport android.view.ViewRootImpl; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WebViewClient { 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Give the host application a chance to take over the control when a new 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * url is about to be loaded in the current WebView. If WebViewClient is not 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * provided, by default WebView will ask Activity Manager to choose the 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proper handler for the url. If WebViewClient is provided, return true 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means the host application handles the url, while return false means the 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current WebView handles the url. 34881c49c99be006f90a51a444db6b96289947e73aMartin Kosiba * This method is not called for requests using the POST "method". 35a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param url The url to be loaded. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return True if the host application wants to leave the current WebView 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and handle the url itself, otherwise return false. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldOverrideUrlLoading(WebView view, String url) { 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that a page has started loading. This method 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is called once for each main frame load so a page with iframes or 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * framesets will call onPageStarted one time for the main frame. This also 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means that onPageStarted will not be called when the contents of an 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * embedded frame changes, i.e. clicking a link whose target is an iframe. 51a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param url The url to be loaded. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param favicon The favicon for this page if it already exists in the 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * database. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPageStarted(WebView view, String url, Bitmap favicon) { 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that a page has finished loading. This method 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is called only for main frame. When onPageFinished() is called, the 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rendering picture may not be updated yet. To get the notification for the 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * new Picture, use {@link WebView.PictureListener#onNewPicture}. 65a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param url The url of the page. 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPageFinished(WebView view, String url) { 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that the WebView will load the resource 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by the given url. 75a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param url The url of the resource the WebView will load. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onLoadResource(WebView view, String url) { 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 83c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * Notify the host application of a resource request and allow the 84c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * application to return the data. If the return value is null, the WebView 85c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * will continue to load the resource as usual. Otherwise, the return 86c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * response and data will be used. NOTE: This method is called by the 87c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * network thread so clients should exercise caution when accessing private 88c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * data. 89c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * 90c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * @param view The {@link android.webkit.WebView} that is requesting the 91c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * resource. 92c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * @param url The raw url of the resource. 93c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * @return A {@link android.webkit.WebResourceResponse} containing the 94c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * response information or null if the WebView should load the 95c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott * resource itself. 96c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott */ 97c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott public WebResourceResponse shouldInterceptRequest(WebView view, 98c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott String url) { 99c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott return null; 100c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott } 101c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott 102c12544a201667383bc3dfb4bd3ad62d98cacd24fPatrick Scott /** 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that there have been an excessive number of 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * HTTP redirects. As the host application if it would like to continue 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * trying to load the resource. The default behavior is to send the cancel 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * message. 107a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cancelMsg The message to send if the host wants to cancel 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param continueMsg The message to send if the host wants to continue 1116a5b0ecae5dc89a951e1e204bc007f50f944c5d1Patrick Scott * @deprecated This method is no longer called. When the WebView encounters 1126a5b0ecae5dc89a951e1e204bc007f50f944c5d1Patrick Scott * a redirect loop, it will cancel the load. 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 114b5503c168a49f0f2b1372678f87d874e7d82aaadKristian Monsen @Deprecated 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onTooManyRedirects(WebView view, Message cancelMsg, 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message continueMsg) { 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project cancelMsg.sendToTarget(); 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12005c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott // These ints must match up to the hidden values in EventHandler. 12105c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Generic error */ 12205c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_UNKNOWN = -1; 12305c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Server or proxy hostname lookup failed */ 12405c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_HOST_LOOKUP = -2; 12505c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Unsupported authentication scheme (not basic or digest) */ 12605c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_UNSUPPORTED_AUTH_SCHEME = -3; 12705c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** User authentication failed on server */ 12805c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_AUTHENTICATION = -4; 12905c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** User authentication failed on proxy */ 13005c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_PROXY_AUTHENTICATION = -5; 13105c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Failed to connect to the server */ 13205c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_CONNECT = -6; 13305c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Failed to read or write to the server */ 13405c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_IO = -7; 13505c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Connection timed out */ 13605c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_TIMEOUT = -8; 13705c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Too many redirects */ 13805c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_REDIRECT_LOOP = -9; 13905c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Unsupported URI scheme */ 14005c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_UNSUPPORTED_SCHEME = -10; 14105c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Failed to perform SSL handshake */ 14205c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_FAILED_SSL_HANDSHAKE = -11; 14305c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Malformed URL */ 14405c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_BAD_URL = -12; 14505c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Generic file error */ 14605c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_FILE = -13; 14705c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** File not found */ 14805c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_FILE_NOT_FOUND = -14; 14905c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott /** Too many requests during this load */ 15005c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott public static final int ERROR_TOO_MANY_REQUESTS = -15; 15105c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15305c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott * Report an error to the host application. These errors are unrecoverable 15405c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott * (i.e. the main resource is unavailable). The errorCode parameter 15505c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott * corresponds to one of the ERROR_* constants. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 157447811c64f60d29a5c0bf2d7ba94b91c68fe2612Patrick Scott * @param errorCode The error code corresponding to an ERROR_* value. 15805c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott * @param description A String describing the error. 15905c9ed9ce1d920c322ee1431cfed64541f0acf3cPatrick Scott * @param failingUrl The url that failed to load. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onReceivedError(WebView view, int errorCode, 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String description, String failingUrl) { 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * As the host application if the browser should resend data as the 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * requested page was a result of a POST. The default is to not resend the 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data. 169a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dontResend The message to send if the browser should not resend 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param resend The message to send if the browser should resend data 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onFormResubmission(WebView view, Message dontResend, 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message resend) { 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dontResend.sendToTarget(); 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application to update its visited links database. 181a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param url The url being visited. 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isReload True if this url is being reloaded. 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void doUpdateVisitedHistory(WebView view, String url, 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isReload) { 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 191fe33a75cc8883dc5d50dd5a2fb0eac702f2a6992Steve Block * Notify the host application that an SSL error occurred while loading a 192fe33a75cc8883dc5d50dd5a2fb0eac702f2a6992Steve Block * resource. The host application must call either handler.cancel() or 193fe33a75cc8883dc5d50dd5a2fb0eac702f2a6992Steve Block * handler.proceed(). Note that the decision may be retained for use in 194fe33a75cc8883dc5d50dd5a2fb0eac702f2a6992Steve Block * response to future SSL errors. The default behavior is to cancel the 195fe33a75cc8883dc5d50dd5a2fb0eac702f2a6992Steve Block * load. 196a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler An SslErrorHandler object that will handle the user's 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * response. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param error The SSL error object. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onReceivedSslError(WebView view, SslErrorHandler handler, 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SslError error) { 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project handler.cancel(); 205a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom } 206a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom 207a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom /** 20846ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * Notifies the host application that the WebView received an HTTP 20946ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * authentication request. The host application can use the supplied 21046ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * {@link HttpAuthHandler} to set the WebView's response to the request. 21146ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * The default behavior is to cancel the request. 212a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 21346ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * @param view the WebView that is initiating the callback 21446ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * @param handler the HttpAuthHandler used to set the WebView's response 21546ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * @param host the host requiring authentication 21646ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * @param realm the realm for which authentication is required 21746ce1db6ff3290b82b12f11715fbe82734a44322Steve Block * @see Webview#getHttpAuthUsernamePassword 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onReceivedHttpAuthRequest(WebView view, 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project HttpAuthHandler handler, String host, String realm) { 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project handler.cancel(); 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Give the host application a chance to handle the key event synchronously. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * e.g. menu shortcut key events need to be filtered this way. If return 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * true, WebView will not handle the key event. If return false, WebView 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will always handle the key event, so none of the super in the view chain 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will see the key event. The default behavior returns false. 230a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param event The key event. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return True if the host application wants to handle the key event 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * itself, otherwise return false 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean shouldOverrideKeyEvent(WebView view, KeyEvent event) { 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that a key was not handled by the WebView. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Except system keys, WebView always consumes the keys in the normal flow 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or if shouldOverrideKeyEvent returns true. This is called asynchronously 244f76a50ce8fdc6aea22cabc77b2977a1a15a79630Ken Wakasa * from where the key is dispatched. It gives the host application a chance 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to handle the unhandled key events. 246a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view The WebView that is initiating the callback. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param event The key event. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onUnhandledKeyEvent(WebView view, KeyEvent event) { 251d6b1098e1f46530528dfea415655468ec994bbb6John Reck ViewRootImpl root = view.getViewRootImpl(); 252d6b1098e1f46530528dfea415655468ec994bbb6John Reck if (root != null) { 253d6b1098e1f46530528dfea415655468ec994bbb6John Reck root.dispatchUnhandledKey(event); 254d6b1098e1f46530528dfea415655468ec994bbb6John Reck } 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notify the host application that the scale applied to the WebView has 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changed. 260a14775949c97a616196f5293209b092ee3d4e9a9Brian Carlstrom * 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param view he WebView that is initiating the callback. 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oldScale The old scale factor 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newScale The new scale factor 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onScaleChanged(WebView view, float oldScale, float newScale) { 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 26785a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott 26885a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott /** 26985a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * Notify the host application that a request to automatically log in the 27085a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * user has been processed. 27185a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * @param view The WebView requesting the login. 27285a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * @param realm The account realm used to look up accounts. 27385a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * @param account An optional account. If not null, the account should be 27485a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * checked against accounts on the device. If it is a valid 27585a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * account, it should be used to log in the user. 27685a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott * @param args Authenticator specific arguments used to log in the user. 27785a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott */ 27885a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott public void onReceivedLoginRequest(WebView view, String realm, 27985a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott String account, String args) { 28085a50ff48b2331913cc87f483eafba9f231c8c8cPatrick Scott } 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 282