19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 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 19451e338c51e8c45efc0d21536dfae6f78f6d5e06Ignacio Sollaimport android.annotation.SystemApi; 20451e338c51e8c45efc0d21536dfae6f78f6d5e06Ignacio Solla 212377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon/** 222377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * An instance of this class is passed as a parameter in various {@link WebChromeClient} action 232377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * notifications. The object is used as a handle onto the underlying JavaScript-originated request, 242377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * and provides a means for the client to indicate whether this action should proceed. 252377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon */ 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class JsResult { 272df9a91ff5c61dc6d788e034f5e0eb7a77a57ac6Grace Kloba /** 282377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * Callback interface, implemented by the WebViewProvider implementation to receive 292377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * notifications when the JavaScript result represented by a JsResult instance has 302377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * @hide Only for use by WebViewProvider implementations 312df9a91ff5c61dc6d788e034f5e0eb7a77a57ac6Grace Kloba */ 32451e338c51e8c45efc0d21536dfae6f78f6d5e06Ignacio Solla @SystemApi 332377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon public interface ResultReceiver { 342377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon public void onJsResultComplete(JsResult result); 352377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon } 36939e5040b51539be561db1d18dec18196f201f5cJonathan Dixon // This is the caller of the prompt and is the object that is waiting. 37939e5040b51539be561db1d18dec18196f201f5cJonathan Dixon private final ResultReceiver mReceiver; 38939e5040b51539be561db1d18dec18196f201f5cJonathan Dixon // This is a basic result of a confirm or prompt dialog. 39939e5040b51539be561db1d18dec18196f201f5cJonathan Dixon private boolean mResult; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handle the result if the user cancelled the dialog. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void cancel() { 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResult = false; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project wakeUp(); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handle a confirmation response from the user. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void confirm() { 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mResult = true; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project wakeUp(); 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 572377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon /** 582377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * @hide Only for use by WebViewProvider implementations 592377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon */ 60451e338c51e8c45efc0d21536dfae6f78f6d5e06Ignacio Solla @SystemApi 612377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon public JsResult(ResultReceiver receiver) { 622377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon mReceiver = receiver; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 652377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon /** 662377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon * @hide Only for use by WebViewProvider implementations 672377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon */ 68451e338c51e8c45efc0d21536dfae6f78f6d5e06Ignacio Solla @SystemApi 692377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon public final boolean getResult() { 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mResult; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 732377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon /* Notify the caller that the JsResult has completed */ 74939e5040b51539be561db1d18dec18196f201f5cJonathan Dixon private final void wakeUp() { 752377b99f6c6f8dba94c28089330e29933b04d601Jonathan Dixon mReceiver.onJsResultComplete(this); 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 78