1 /*
2  * Copyright (C) 2008 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.storage;
18 
19 import android.compat.annotation.UnsupportedAppUsage;
20 import android.os.Build;
21 
22 /**
23  * Used for receiving notifications from the StorageManager
24  *
25  * @hide
26  */
27 public class StorageEventListener {
28 
29     @UnsupportedAppUsage
StorageEventListener()30     public StorageEventListener() {
31     }
32 
33     /**
34      * Called when the detection state of a USB Mass Storage host has changed.
35      * @param connected true if the USB mass storage is connected.
36      */
37     @UnsupportedAppUsage
onUsbMassStorageConnectionChanged(boolean connected)38     public void onUsbMassStorageConnectionChanged(boolean connected) {
39     }
40 
41     /**
42      * Called when storage has changed state
43      * @param path the filesystem path for the storage
44      * @param oldState the old state as returned by {@link android.os.Environment#getExternalStorageState()}.
45      * @param newState the old state as returned by {@link android.os.Environment#getExternalStorageState()}.
46      */
47     @UnsupportedAppUsage
onStorageStateChanged(String path, String oldState, String newState)48     public void onStorageStateChanged(String path, String oldState, String newState) {
49     }
50 
51     @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
onVolumeStateChanged(VolumeInfo vol, int oldState, int newState)52     public void onVolumeStateChanged(VolumeInfo vol, int oldState, int newState) {
53     }
54 
55     @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
onVolumeRecordChanged(VolumeRecord rec)56     public void onVolumeRecordChanged(VolumeRecord rec) {
57     }
58 
59     @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
onVolumeForgotten(String fsUuid)60     public void onVolumeForgotten(String fsUuid) {
61     }
62 
63     @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
onDiskScanned(DiskInfo disk, int volumeCount)64     public void onDiskScanned(DiskInfo disk, int volumeCount) {
65     }
66 
67     @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
onDiskDestroyed(DiskInfo disk)68     public void onDiskDestroyed(DiskInfo disk) {
69     }
70 }
71