1 /*
2  * Copyright (C) 2006 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.os;
18 
19 import android.util.AndroidException;
20 
21 /**
22  * Parent exception for all Binder remote-invocation errors
23  */
24 public class RemoteException extends AndroidException {
RemoteException()25     public RemoteException() {
26         super();
27     }
28 
RemoteException(String message)29     public RemoteException(String message) {
30         super(message);
31     }
32 
33     /** {@hide} */
rethrowAsRuntimeException()34     public RuntimeException rethrowAsRuntimeException() {
35         throw new RuntimeException(this);
36     }
37 
38     /**
39      * Rethrow this exception when we know it came from the system server. This
40      * gives us an opportunity to throw a nice clean
41      * {@link DeadSystemException} signal to avoid spamming logs with
42      * misleading stack traces.
43      * <p>
44      * Apps making calls into the system server may end up persisting internal
45      * state or making security decisions based on the perceived success or
46      * failure of a call, or any default values returned. For this reason, we
47      * want to strongly throw when there was trouble with the transaction.
48      *
49      * @hide
50      */
rethrowFromSystemServer()51     public RuntimeException rethrowFromSystemServer() {
52         if (this instanceof DeadObjectException) {
53             throw new RuntimeException(new DeadSystemException());
54         } else {
55             throw new RuntimeException(this);
56         }
57     }
58 }
59