content: /*
   * Copyright (C) 2016 The Android Open Source Project
   *
   * Licensed 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 android.net.wifi.aware;
  
  import android.annotation.NonNull;
  import android.util.Log;
  
  /**
   * A class representing a Aware subscribe session. Created when
   * {@link WifiAwareSession#subscribe(SubscribeConfig,
   * DiscoverySessionCallback, android.os.Handler)}
   * is called and a discovery session is created and returned in
   * {@link DiscoverySessionCallback#onSubscribeStarted(SubscribeDiscoverySession)}.
   * See baseline functionality of all discovery sessions in {@link DiscoverySession}.
   * This object allows updating an existing/running subscribe discovery session using
   * {@link #updateSubscribe(SubscribeConfig)}.
   */
  public class SubscribeDiscoverySession extends DiscoverySession {
      private static final String TAG = "SubscribeDiscSession";
  
      /**
       * {@hide}
       */
      public SubscribeDiscoverySession(WifiAwareManager manager, int clientId,
              int sessionId) {
          super(manager, clientId, sessionId);
      }
  
      /**
       * Re-configure the currently active subscribe session. The
       * {@link DiscoverySessionCallback} is not replaced - the same listener used
       * at creation is still used. The results of the configuration are returned using
       * {@link DiscoverySessionCallback}:
       * <ul>
       *     <li>{@link DiscoverySessionCallback#onSessionConfigUpdated()}: configuration
       *     update succeeded.
       *     <li>{@link DiscoverySessionCallback#onSessionConfigFailed()}: configuration
       *     update failed. The subscribe discovery session is still running using its previous
       *     configuration (i.e. update failure does not terminate the session).
       * </ul>
       *
       * @param subscribeConfig The new discovery subscribe session configuration
       *                        ({@link SubscribeConfig}).
       */
      public void updateSubscribe(@NonNull SubscribeConfig subscribeConfig) {
          if (mTerminated) {
              Log.w(TAG, "updateSubscribe: called on terminated session");
              return;
          } else {
              WifiAwareManager mgr = mMgr.get();
              if (mgr == null) {
                  Log.w(TAG, "updateSubscribe: called post GC on WifiAwareManager");
                  return;
              }
  
              mgr.updateSubscribe(mClientId, mSessionId, subscribeConfig);
          }
      }
  }
  