Java tutorial
/* Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package org.apache.cordova; import java.util.Collection; import java.util.LinkedHashMap; import org.json.JSONException; import android.content.Intent; import android.content.res.Configuration; import android.net.Uri; import android.os.Bundle; import android.os.Debug; import android.util.Log; /** * PluginManager is exposed to JavaScript in the Cordova WebView. * * Calling native plugin code can be done by calling PluginManager.exec(...) * from JavaScript. */ public class PluginManager { private static String TAG = "PluginManager"; private static final int SLOW_EXEC_WARNING_THRESHOLD = Debug.isDebuggerConnected() ? 60 : 16; // List of service entries private final LinkedHashMap<String, CordovaPlugin> pluginMap = new LinkedHashMap<String, CordovaPlugin>(); private final LinkedHashMap<String, PluginEntry> entryMap = new LinkedHashMap<String, PluginEntry>(); private final CordovaInterface ctx; private final CordovaWebView app; private boolean isInitialized; private CordovaPlugin permissionRequester; public PluginManager(CordovaWebView cordovaWebView, CordovaInterface cordova, Collection<PluginEntry> pluginEntries) { this.ctx = cordova; this.app = cordovaWebView; setPluginEntries(pluginEntries); } public Collection<PluginEntry> getPluginEntries() { return entryMap.values(); } public void setPluginEntries(Collection<PluginEntry> pluginEntries) { if (isInitialized) { this.onPause(false); this.onDestroy(); pluginMap.clear(); entryMap.clear(); } for (PluginEntry entry : pluginEntries) { addService(entry); } if (isInitialized) { startupPlugins(); } } /** * Init when loading a new HTML page into webview. */ public void init() { LOG.d(TAG, "init()"); isInitialized = true; this.onPause(false); this.onDestroy(); pluginMap.clear(); this.startupPlugins(); } /** * Create plugins objects that have onload set. */ private void startupPlugins() { for (PluginEntry entry : entryMap.values()) { // Add a null entry to for each non-startup plugin to avoid ConcurrentModificationException // When iterating plugins. if (entry.onload) { getPlugin(entry.service); } else { pluginMap.put(entry.service, null); } } } /** * Receives a request for execution and fulfills it by finding the appropriate * Java class and calling it's execute method. * * PluginManager.exec can be used either synchronously or async. In either case, a JSON encoded * string is returned that will indicate if any errors have occurred when trying to find * or execute the class denoted by the clazz argument. * * @param service String containing the service to run * @param action String containing the action that the class is supposed to perform. This is * passed to the plugin execute method and it is up to the plugin developer * how to deal with it. * @param callbackId String containing the id of the callback that is execute in JavaScript if * this is an async plugin call. * @param rawArgs An Array literal string containing any arguments needed in the * plugin execute method. */ public void exec(final String service, final String action, final String callbackId, final String rawArgs) { CordovaPlugin plugin = getPlugin(service); if (plugin == null) { Log.d(TAG, "exec() call to unknown plugin: " + service); PluginResult cr = new PluginResult(PluginResult.Status.CLASS_NOT_FOUND_EXCEPTION); app.sendPluginResult(cr, callbackId); return; } CallbackContext callbackContext = new CallbackContext(callbackId, app); try { long pluginStartTime = System.currentTimeMillis(); boolean wasValidAction = plugin.execute(action, rawArgs, callbackContext); long duration = System.currentTimeMillis() - pluginStartTime; if (duration > SLOW_EXEC_WARNING_THRESHOLD) { Log.w(TAG, "THREAD WARNING: exec() call to " + service + "." + action + " blocked the main thread for " + duration + "ms. Plugin should use CordovaInterface.getThreadPool()."); } if (!wasValidAction) { PluginResult cr = new PluginResult(PluginResult.Status.INVALID_ACTION); callbackContext.sendPluginResult(cr); } } catch (JSONException e) { PluginResult cr = new PluginResult(PluginResult.Status.JSON_EXCEPTION); callbackContext.sendPluginResult(cr); } catch (Exception e) { Log.e(TAG, "Uncaught exception from plugin", e); callbackContext.error(e.getMessage()); } } /** * Get the plugin object that implements the service. * If the plugin object does not already exist, then create it. * If the service doesn't exist, then return null. * * @param service The name of the service. * @return CordovaPlugin or null */ public CordovaPlugin getPlugin(String service) { CordovaPlugin ret = pluginMap.get(service); if (ret == null) { PluginEntry pe = entryMap.get(service); if (pe == null) { return null; } if (pe.plugin != null) { ret = pe.plugin; } else { ret = instantiatePlugin(pe.pluginClass); } ret.privateInitialize(service, ctx, app, app.getPreferences()); pluginMap.put(service, ret); } return ret; } /** * Add a plugin class that implements a service to the service entry table. * This does not create the plugin object instance. * * @param service The service name * @param className The plugin class name */ public void addService(String service, String className) { PluginEntry entry = new PluginEntry(service, className, false); this.addService(entry); } /** * Add a plugin class that implements a service to the service entry table. * This does not create the plugin object instance. * * @param entry The plugin entry */ public void addService(PluginEntry entry) { this.entryMap.put(entry.service, entry); if (entry.plugin != null) { entry.plugin.privateInitialize(entry.service, ctx, app, app.getPreferences()); pluginMap.put(entry.service, entry.plugin); } } /** * Called when the system is about to start resuming a previous activity. * * @param multitasking Flag indicating if multitasking is turned on for app */ public void onPause(boolean multitasking) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onPause(multitasking); } } } /** * Called when the system received an HTTP authentication request. Plugins can use * the supplied HttpAuthHandler to process this auth challenge. * * @param view The WebView that is initiating the callback * @param handler The HttpAuthHandler used to set the WebView's response * @param host The host requiring authentication * @param realm The realm for which authentication is required * * @return Returns True if there is a plugin which will resolve this auth challenge, otherwise False * */ public boolean onReceivedHttpAuthRequest(CordovaWebView view, ICordovaHttpAuthHandler handler, String host, String realm) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null && plugin.onReceivedHttpAuthRequest(app, handler, host, realm)) { return true; } } return false; } /** * Called when he system received an SSL client certificate request. Plugin can use * the supplied ClientCertRequest to process this certificate challenge. * * @param view The WebView that is initiating the callback * @param request The client certificate request * * @return Returns True if plugin will resolve this auth challenge, otherwise False * */ public boolean onReceivedClientCertRequest(CordovaWebView view, ICordovaClientCertRequest request) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null && plugin.onReceivedClientCertRequest(app, request)) { return true; } } return false; } /** * Called when the activity will start interacting with the user. * * @param multitasking Flag indicating if multitasking is turned on for app */ public void onResume(boolean multitasking) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onResume(multitasking); } } } /** * Called when the activity is becoming visible to the user. */ public void onStart() { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onStart(); } } } /** * Called when the activity is no longer visible to the user. */ public void onStop() { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onStop(); } } } /** * The final call you receive before your activity is destroyed. */ public void onDestroy() { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onDestroy(); } } } /** * Send a message to all plugins. * * @param id The message id * @param data The message data * @return Object to stop propagation or null */ public Object postMessage(String id, Object data) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { Object obj = plugin.onMessage(id, data); if (obj != null) { return obj; } } } return ctx.onMessage(id, data); } /** * Called when the activity receives a new intent. */ public void onNewIntent(Intent intent) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onNewIntent(intent); } } } /** * Called when the webview is going to request an external resource. * * This delegates to the installed plugins, and returns true/false for the * first plugin to provide a non-null result. If no plugins respond, then * the default policy is applied. * * @param url The URL that is being requested. * @return Returns true to allow the resource to load, * false to block the resource. */ public boolean shouldAllowRequest(String url) { for (PluginEntry entry : this.entryMap.values()) { CordovaPlugin plugin = pluginMap.get(entry.service); if (plugin != null) { Boolean result = plugin.shouldAllowRequest(url); if (result != null) { return result; } } } // Default policy: if (url.startsWith("blob:") || url.startsWith("data:") || url.startsWith("about:blank")) { return true; } // TalkBack requires this, so allow it by default. if (url.startsWith("https://ssl.gstatic.com/accessibility/javascript/android/")) { return true; } if (url.startsWith("file://")) { //This directory on WebKit/Blink based webviews contains SQLite databases! //DON'T CHANGE THIS UNLESS YOU KNOW WHAT YOU'RE DOING! return !url.contains("/app_webview/"); } return false; } /** * Called when the webview is going to change the URL of the loaded content. * * This delegates to the installed plugins, and returns true/false for the * first plugin to provide a non-null result. If no plugins respond, then * the default policy is applied. * * @param url The URL that is being requested. * @return Returns true to allow the navigation, * false to block the navigation. */ public boolean shouldAllowNavigation(String url) { for (PluginEntry entry : this.entryMap.values()) { CordovaPlugin plugin = pluginMap.get(entry.service); if (plugin != null) { Boolean result = plugin.shouldAllowNavigation(url); if (result != null) { return result; } } } // Default policy: return url.startsWith("file://") || url.startsWith("about:blank"); } /** * Called when the webview is requesting the exec() bridge be enabled. */ public boolean shouldAllowBridgeAccess(String url) { for (PluginEntry entry : this.entryMap.values()) { CordovaPlugin plugin = pluginMap.get(entry.service); if (plugin != null) { Boolean result = plugin.shouldAllowBridgeAccess(url); if (result != null) { return result; } } } // Default policy: return url.startsWith("file://"); } /** * Called when the webview is going not going to navigate, but may launch * an Intent for an URL. * * This delegates to the installed plugins, and returns true/false for the * first plugin to provide a non-null result. If no plugins respond, then * the default policy is applied. * * @param url The URL that is being requested. * @return Returns true to allow the URL to launch an intent, * false to block the intent. */ public Boolean shouldOpenExternalUrl(String url) { for (PluginEntry entry : this.entryMap.values()) { CordovaPlugin plugin = pluginMap.get(entry.service); if (plugin != null) { Boolean result = plugin.shouldOpenExternalUrl(url); if (result != null) { return result; } } } // Default policy: // External URLs are not allowed return false; } /** * Called when the URL of the webview changes. * * @param url The URL that is being changed to. * @return Return false to allow the URL to load, return true to prevent the URL from loading. */ public boolean onOverrideUrlLoading(String url) { for (PluginEntry entry : this.entryMap.values()) { CordovaPlugin plugin = pluginMap.get(entry.service); if (plugin != null && plugin.onOverrideUrlLoading(url)) { return true; } } return false; } /** * Called when the app navigates or refreshes. */ public void onReset() { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onReset(); } } } Uri remapUri(Uri uri) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { Uri ret = plugin.remapUri(uri); if (ret != null) { return ret; } } } return null; } /** * Create a plugin based on class name. */ private CordovaPlugin instantiatePlugin(String className) { CordovaPlugin ret = null; try { Class<?> c = null; if ((className != null) && !("".equals(className))) { c = Class.forName(className); } if (c != null & CordovaPlugin.class.isAssignableFrom(c)) { ret = (CordovaPlugin) c.newInstance(); } } catch (Exception e) { e.printStackTrace(); System.out.println("Error adding plugin " + className + "."); } return ret; } /** * Called by the system when the device configuration changes while your activity is running. * * @param newConfig The new device configuration */ public void onConfigurationChanged(Configuration newConfig) { for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { plugin.onConfigurationChanged(newConfig); } } } public Bundle onSaveInstanceState() { Bundle state = new Bundle(); for (CordovaPlugin plugin : this.pluginMap.values()) { if (plugin != null) { Bundle pluginState = plugin.onSaveInstanceState(); if (pluginState != null) { state.putBundle(plugin.getServiceName(), pluginState); } } } return state; } }