core/java/android/net/INetworkScoreCache.aidl

   1 /**
   2  * Copyright (c) 2014, 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.net;
  18
  19 import android.net.ScoredNetwork;
  20
  21 /**
  22  * A service which stores a subset of scored networks from the active network scorer.
  23  *
  24  * <p>To be implemented by network subsystems (e.g. Wi-Fi). NetworkScoreService will propagate
  25  * scores down to each subsystem depending on the network type. Implementations may register for
  26  * a given network type by calling NetworkScoreManager.registerNetworkSubsystem.
  27  *
  28  * <p>A proper implementation should throw SecurityException whenever the caller is not privileged.
  29  * It may request scores by calling NetworkScoreManager#requestScores(NetworkKey[]); a call to
  30  * updateScores may follow but may not depending on the active scorer's implementation, and in
  31  * general this method may be called at any time.
  32  *
  33  * <p>Implementations should also override dump() so that "adb shell dumpsys network_score" includes
  34  * the current scores for each network for debugging purposes.
  35  * @hide
  36  */
  37 interface INetworkScoreCache
  38 {
  39     void updateScores(in List<ScoredNetwork> networks);
  40
  41     void clearScores();
  42 }
  43