src/xwalk/runtime/android/core/src/org/xwalk/core/XWalkContentsClient.java

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Copyright (c) 2013 Intel Corporation. All rights reserved.
   3 // Use of this source code is governed by a BSD-style license that can be
   4 // found in the LICENSE file.
   5
   6 package org.xwalk.core;
   7
   8 import android.content.pm.ActivityInfo;
   9 import android.graphics.Bitmap;
  10 import android.graphics.Picture;
  11 import android.graphics.Rect;
  12 import android.graphics.RectF;
  13 import android.net.http.SslError;
  14 import android.os.Handler;
  15 import android.os.Looper;
  16 import android.os.Message;
  17 import android.util.Log;
  18 import android.view.KeyEvent;
  19 import android.view.View;
  20 import android.webkit.ConsoleMessage;
  21 import android.webkit.ValueCallback;
  22 import android.webkit.WebResourceResponse;
  23
  24 import org.chromium.content.browser.ContentViewClient;
  25 import org.chromium.content.browser.ContentViewCore;
  26 import org.chromium.content.browser.WebContentsObserverAndroid;
  27 import org.chromium.net.NetError;
  28
  29 /**
  30  * Base-class that a XWalkViewContents embedder derives from to receive callbacks.
  31  * This extends ContentViewClient, as in many cases we want to pass-thru ContentViewCore
  32  * callbacks right to our embedder, and this setup facilities that.
  33  * For any other callbacks we need to make transformations of (e.g. adapt parameters
  34  * or perform filtering) we can provide final overrides for methods here, and then introduce
  35  * new abstract methods that the our own client must implement.
  36  * i.e.: all methods in this class should either be final, or abstract.
  37  */
  38 abstract class XWalkContentsClient extends ContentViewClient {
  39
  40     private static final String TAG = "XWalkContentsClient";
  41     private final XWalkContentsClientCallbackHelper mCallbackHelper =
  42         new XWalkContentsClientCallbackHelper(this);
  43
  44     private XWalkWebContentsObserver mWebContentsObserver;
  45
  46     private double mDIPScale;
  47
  48     public class XWalkWebContentsObserver extends WebContentsObserverAndroid {
  49         public XWalkWebContentsObserver(ContentViewCore contentViewCore) {
  50             super(contentViewCore);
  51         }
  52
  53         @Override
  54         public void didStopLoading(String url) {
  55             onPageFinished(url);
  56         }
  57
  58         @Override
  59         public void didFailLoad(boolean isProvisionalLoad,
  60                 boolean isMainFrame, int errorCode, String description, String failingUrl) {
  61             if (errorCode == NetError.ERR_ABORTED || !isMainFrame) {
  62                 // This error code is generated for the following reasons:
  63                 // - XWalkView.stopLoading is called,
  64                 // - the navigation is intercepted by the embedder via shouldOverrideNavigation.
  65                 //
  66                 // The XWalkView does not notify the embedder of these situations using this
  67                 // error code with the XWalkClient.onReceivedError callback. What's more,
  68                 // the XWalkView does not notify the embedder of sub-frame failures.
  69                 return;
  70             }
  71             onReceivedError(ErrorCodeConversionHelper.convertErrorCode(errorCode),
  72                     description, failingUrl);
  73         }
  74
  75         @Override
  76         public void didNavigateAnyFrame(String url, String baseUrl, boolean isReload) {
  77             doUpdateVisitedHistory(url, isReload);
  78         }
  79
  80         @Override
  81         public void didFinishLoad(long frameId, String validatedUrl, boolean isMainFrame) {
  82             // Both didStopLoading and didFinishLoad will be called once a page is finished
  83             // to load, but didStopLoading will also be called when user clicks "X" button
  84             // on browser UI to stop loading page.
  85             //
  86             // So it is safe for Crosswalk to rely on didStopLoading to ensure onPageFinished
  87             // can be called.
  88         }
  89     }
  90
  91     @Override
  92     final public void onUpdateTitle(String title) {
  93         onTitleChanged(title);
  94     }
  95
  96     void installWebContentsObserver(ContentViewCore contentViewCore) {
  97         if (mWebContentsObserver != null) {
  98             mWebContentsObserver.detachFromWebContents();
  99         }
 100         mWebContentsObserver = new XWalkWebContentsObserver(contentViewCore);
 101     }
 102
 103     void setDIPScale(double dipScale) {
 104         mDIPScale = dipScale;
 105     }
 106
 107     final XWalkContentsClientCallbackHelper getCallbackHelper() {
 108         return mCallbackHelper;
 109     }
 110
 111     //--------------------------------------------------------------------------------------------
 112     //             XWalkView specific methods that map directly to XWalkViewClient / XWalkWebChromeClient
 113     //--------------------------------------------------------------------------------------------
 114
 115     public abstract void getVisitedHistory(ValueCallback<String[]> callback);
 116
 117     public abstract void doUpdateVisitedHistory(String url, boolean isReload);
 118
 119     public abstract void onProgressChanged(int progress);
 120
 121     public abstract WebResourceResponse shouldInterceptRequest(String url);
 122
 123     public abstract void onResourceLoadStarted(String url);
 124
 125     public abstract void onResourceLoadFinished(String url);
 126
 127     public abstract void onLoadResource(String url);
 128
 129     public abstract boolean shouldOverrideUrlLoading(String url);
 130
 131     public abstract void onUnhandledKeyEvent(KeyEvent event);
 132
 133     public abstract boolean onConsoleMessage(ConsoleMessage consoleMessage);
 134
 135     public abstract void onReceivedHttpAuthRequest(XWalkHttpAuthHandler handler,
 136             String host, String realm);
 137
 138     public abstract void onReceivedSslError(ValueCallback<Boolean> callback, SslError error);
 139
 140     public abstract void onReceivedLoginRequest(String realm, String account, String args);
 141
 142     public abstract void onFormResubmission(Message dontResend, Message resend);
 143
 144     public abstract void onDownloadStart(String url, String userAgent, String contentDisposition,
 145             String mimeType, long contentLength);
 146
 147     public abstract void onGeolocationPermissionsShowPrompt(String origin,
 148             XWalkGeolocationPermissions.Callback callback);
 149
 150     public abstract void onGeolocationPermissionsHidePrompt();
 151
 152     public final void onScaleChanged(float oldScale, float newScale) {
 153         onScaleChangedScaled((float)(oldScale * mDIPScale), (float)(newScale * mDIPScale));
 154     }
 155
 156     public abstract void onScaleChangedScaled(float oldScale, float newScale);
 157
 158     protected abstract boolean onCreateWindow(boolean isDialog, boolean isUserGesture);
 159
 160     protected abstract void onCloseWindow();
 161
 162     public abstract void onReceivedTouchIconUrl(String url, boolean precomposed);
 163
 164     public abstract void onReceivedIcon(Bitmap bitmap);
 165
 166     protected abstract void onRequestFocus();
 167
 168     protected abstract View getVideoLoadingProgressView();
 169
 170     public abstract void onPageStarted(String url);
 171
 172     public abstract void onPageFinished(String url);
 173
 174     public abstract void onReceivedError(int errorCode, String description, String failingUrl);
 175
 176     public abstract void onRendererUnresponsive();
 177
 178     public abstract void onRendererResponsive();
 179
 180     public abstract void onTitleChanged(String title);
 181
 182     public abstract void onToggleFullscreen(boolean enterFullscreen);
 183
 184     public abstract boolean hasEnteredFullscreen();
 185
 186     public abstract boolean shouldOverrideRunFileChooser(
 187             int processId, int renderId, int mode, String acceptTypes, boolean capture);
 188
 189     // TODO (michaelbai): Remove this method once the same method remove from
 190     // XWalkContentsClientAdapter.
 191     public void onShowCustomView(View view,
 192            int requestedOrientation, XWalkWebChromeClient.CustomViewCallback callback) {
 193     }
 194
 195     // TODO (michaelbai): This method should be abstract, having empty body here
 196     // makes the merge to the Android easy.
 197     public void onShowCustomView(View view, XWalkWebChromeClient.CustomViewCallback callback) {
 198         onShowCustomView(view, ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED, callback);
 199     }
 200
 201     public abstract void onHideCustomView();
 202
 203     public abstract Bitmap getDefaultVideoPoster();
 204
 205     public abstract void didFinishLoad(String url);
 206
 207     //--------------------------------------------------------------------------------------------
 208     //                              Other XWalkView-specific methods
 209     //--------------------------------------------------------------------------------------------
 210     //
 211     public abstract void onFindResultReceived(int activeMatchOrdinal, int numberOfMatches,
 212             boolean isDoneCounting);
 213
 214     /**
 215      * Called whenever there is a new content picture available.
 216      * @param picture New picture.
 217      */
 218     public abstract void onNewPicture(Picture picture);
 219 }