content: /*
   * Copyright (C) 2015 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.security.keymaster;
  
  import android.annotation.UnsupportedAppUsage;
  import android.os.Parcel;
  import android.os.Parcelable;
  
  import java.math.BigInteger;
  import java.util.ArrayList;
  import java.util.Date;
  import java.util.List;
  
  /**
   * @hide
   */
  public class KeyCharacteristics implements Parcelable {
      public KeymasterArguments swEnforced;
      public KeymasterArguments hwEnforced;
  
      public static final @android.annotation.NonNull Parcelable.Creator<KeyCharacteristics> CREATOR =
              new Parcelable.Creator<KeyCharacteristics>() {
                  @Override
                  public KeyCharacteristics createFromParcel(Parcel in) {
                      return new KeyCharacteristics(in);
                  }
  
                  @Override
                  public KeyCharacteristics[] newArray(int length) {
                      return new KeyCharacteristics[length];
                  }
              };
  
      @UnsupportedAppUsage
      public KeyCharacteristics() {}
  
      protected KeyCharacteristics(Parcel in) {
          readFromParcel(in);
      }
  
      /**
       * Makes a shallow copy of other by copying the other's references to the KeymasterArguments
       */
      public void shallowCopyFrom(KeyCharacteristics other) {
          this.swEnforced = other.swEnforced;
          this.hwEnforced = other.hwEnforced;
      }
  
      @Override
      public int describeContents() {
          return 0;
      }
  
      @Override
      public void writeToParcel(Parcel out, int flags) {
          swEnforced.writeToParcel(out, flags);
          hwEnforced.writeToParcel(out, flags);
      }
  
      @UnsupportedAppUsage
      public void readFromParcel(Parcel in) {
          swEnforced = KeymasterArguments.CREATOR.createFromParcel(in);
          hwEnforced = KeymasterArguments.CREATOR.createFromParcel(in);
      }
  
      /**
       * Returns the value of the specified enum tag or {@code defaultValue} if the tag is not
       * present.
       *
       * @throws IllegalArgumentException if {@code tag} is not an enum tag.
       */
      public Integer getEnum(int tag) {
          if (hwEnforced.containsTag(tag)) {
              return hwEnforced.getEnum(tag, -1);
          } else if (swEnforced.containsTag(tag)) {
              return swEnforced.getEnum(tag, -1);
          } else {
              return null;
          }
      }
  
      /**
       * Returns all values of the specified repeating enum tag.
       *
       * throws IllegalArgumentException if {@code tag} is not a repeating enum tag.
       */
      public List<Integer> getEnums(int tag) {
          List<Integer> result = new ArrayList<Integer>();
          result.addAll(hwEnforced.getEnums(tag));
          result.addAll(swEnforced.getEnums(tag));
          return result;
      }
  
      /**
       * Returns the value of the specified unsigned 32-bit int tag or {@code defaultValue} if the tag
       * is not present.
       *
       * @throws IllegalArgumentException if {@code tag} is not an unsigned 32-bit int tag.
       */
      public long getUnsignedInt(int tag, long defaultValue) {
          if (hwEnforced.containsTag(tag)) {
              return hwEnforced.getUnsignedInt(tag, defaultValue);
          } else {
              return swEnforced.getUnsignedInt(tag, defaultValue);
          }
      }
  
      /**
       * Returns all values of the specified repeating unsigned 64-bit long tag.
       *
       * @throws IllegalArgumentException if {@code tag} is not a repeating unsigned 64-bit long tag.
       */
      public List<BigInteger> getUnsignedLongs(int tag) {
          List<BigInteger> result = new ArrayList<BigInteger>();
          result.addAll(hwEnforced.getUnsignedLongs(tag));
          result.addAll(swEnforced.getUnsignedLongs(tag));
          return result;
      }
  
      /**
       * Returns the value of the specified date tag or {@code null} if the tag is not present.
       *
       * @throws IllegalArgumentException if {@code tag} is not a date tag or if the tag's value
       *         represents a time instant which is after {@code 2^63 - 1} milliseconds since Unix
       *         epoch.
       */
      public Date getDate(int tag) {
          Date result = swEnforced.getDate(tag, null);
          if (result != null) {
              return result;
          }
          return hwEnforced.getDate(tag, null);
      }
  
      /**
       * Returns {@code true} if the provided boolean tag is present, {@code false} if absent.
       *
       * @throws IllegalArgumentException if {@code tag} is not a boolean tag.
       */
      public boolean getBoolean(int tag) {
          if (hwEnforced.containsTag(tag)) {
              return hwEnforced.getBoolean(tag);
          } else {
              return swEnforced.getBoolean(tag);
          }
      }
  }
  
  