android-35/android/app/AsyncNotedAppOp.java - platform/prebuilts/fullsdk/sources - Git at Google

 /*
  * Copyright (C) 2019 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.app;

 import android.annotation.CurrentTimeMillisLong;
 import android.annotation.IntRange;
 import android.annotation.NonNull;
 import android.annotation.Nullable;
 import android.os.Parcelable;

 import com.android.internal.annotations.Immutable;
 import com.android.internal.util.DataClass;
 import com.android.internal.util.Preconditions;

 /**
  * When an {@link AppOpsManager#noteOp(String, int, String, String, String) app-op is noted} and the
  * app the app-op is noted for has a {@link AppOpsManager.OnOpNotedCallback} registered the
  * note-event needs to be delivered to the callback. Usually this is done via an
  * {@link SyncNotedAppOp}, but in some cases this is not possible. In this case an
  * {@link AsyncNotedAppOp} is send to the system server and then forwarded to the
  * {@link AppOpsManager.OnOpNotedCallback} in the app.
  */
 @Immutable
 @DataClass(genEqualsHashCode = true,
         genAidl = true,
         genHiddenConstructor = true,
         genToString = true)
 // - We don't expose the opCode, but rather the public name of the op, hence use a non-standard
 //   getter
 @DataClass.Suppress({"getOpCode"})
 public final class AsyncNotedAppOp implements Parcelable {
     /** Op that was noted */
     private final @IntRange(from = 0) int mOpCode;

     /** Uid that noted the op */
     private final @IntRange(from = 0) int mNotingUid;

     /** {@link android.content.Context#createAttributionContext attribution tag} */
     private final @Nullable String mAttributionTag;

     /** Message associated with the noteOp. This message is set by the app noting the op */
     private final @NonNull String mMessage;

     /** Milliseconds since epoch when the op was noted */
     private final @CurrentTimeMillisLong long mTime;

     /**
      * @return Op that was noted.
      */
     public @NonNull String getOp() {
         return AppOpsManager.opToPublicName(mOpCode);
     }

     //TODO eugenesusla: support inlinable expressions in annotation params of @DataClass members to
     // allow validating via @IntRange(from = 0, to = AppOpsManager._NUM_OP - 1)
     private void onConstructed() {
         Preconditions.checkArgumentInRange(mOpCode, 0, AppOpsManager._NUM_OP - 1, "opCode");
     }

     private String opCodeToString() {
         return getOp();
     }


     // Code below generated by codegen v1.0.23.
     //
     // DO NOT MODIFY!
     // CHECKSTYLE:OFF Generated code
     //
     // To regenerate run:
     // $ codegen $ANDROID_BUILD_TOP/frameworks/base/core/java/android/app/AsyncNotedAppOp.java
     //
     // To exclude the generated code from IntelliJ auto-formatting enable (one-time):
     //   Settings > Editor > Code Style > Formatter Control
     //@formatter:off


     /**
      * Creates a new AsyncNotedAppOp.
      *
      * @param opCode
      *   Op that was noted
      * @param notingUid
      *   Uid that noted the op
      * @param attributionTag
      *   {@link android.content.Context#createAttributionContext attribution tag}
      * @param message
      *   Message associated with the noteOp. This message is set by the app noting the op
      * @param time
      *   Milliseconds since epoch when the op was noted
      * @hide
      */
     @DataClass.Generated.Member
     public AsyncNotedAppOp(
             @IntRange(from = 0) int opCode,
             @IntRange(from = 0) int notingUid,
             @Nullable String attributionTag,
             @NonNull String message,
             @CurrentTimeMillisLong long time) {
         this.mOpCode = opCode;
         com.android.internal.util.AnnotationValidations.validate(
                 IntRange.class, null, mOpCode,
                 "from", 0);
         this.mNotingUid = notingUid;
         com.android.internal.util.AnnotationValidations.validate(
                 IntRange.class, null, mNotingUid,
                 "from", 0);
         this.mAttributionTag = attributionTag;
         this.mMessage = message;
         com.android.internal.util.AnnotationValidations.validate(
                 NonNull.class, null, mMessage);
         this.mTime = time;
         com.android.internal.util.AnnotationValidations.validate(
                 CurrentTimeMillisLong.class, null, mTime);

         onConstructed();
     }

     /**
      * Uid that noted the op
      */
     @DataClass.Generated.Member
     public @IntRange(from = 0) int getNotingUid() {
         return mNotingUid;
     }

     /**
      * {@link android.content.Context#createAttributionContext attribution tag}
      */
     @DataClass.Generated.Member
     public @Nullable String getAttributionTag() {
         return mAttributionTag;
     }

     /**
      * Message associated with the noteOp. This message is set by the app noting the op
      */
     @DataClass.Generated.Member
     public @NonNull String getMessage() {
         return mMessage;
     }

     /**
      * Milliseconds since epoch when the op was noted
      */
     @DataClass.Generated.Member
     public @CurrentTimeMillisLong long getTime() {
         return mTime;
     }

     @Override
     @DataClass.Generated.Member
     public String toString() {
         // You can override field toString logic by defining methods like:
         // String fieldNameToString() { ... }

         return "AsyncNotedAppOp { " +
                 "opCode = " + opCodeToString() + ", " +
                 "notingUid = " + mNotingUid + ", " +
                 "attributionTag = " + mAttributionTag + ", " +
                 "message = " + mMessage + ", " +
                 "time = " + mTime +
         " }";
     }

     @Override
     @DataClass.Generated.Member
     public boolean equals(@Nullable Object o) {
         // You can override field equality logic by defining either of the methods like:
         // boolean fieldNameEquals(AsyncNotedAppOp other) { ... }
         // boolean fieldNameEquals(FieldType otherValue) { ... }

         if (this == o) return true;
         if (o == null || getClass() != o.getClass()) return false;
         @SuppressWarnings("unchecked")
         AsyncNotedAppOp that = (AsyncNotedAppOp) o;
         //noinspection PointlessBooleanExpression
         return true
                 && mOpCode == that.mOpCode
                 && mNotingUid == that.mNotingUid
                 && java.util.Objects.equals(mAttributionTag, that.mAttributionTag)
                 && java.util.Objects.equals(mMessage, that.mMessage)
                 && mTime == that.mTime;
     }

     @Override
     @DataClass.Generated.Member
     public int hashCode() {
         // You can override field hashCode logic by defining methods like:
         // int fieldNameHashCode() { ... }

         int _hash = 1;
         _hash = 31 * _hash + mOpCode;
         _hash = 31 * _hash + mNotingUid;
         _hash = 31 * _hash + java.util.Objects.hashCode(mAttributionTag);
         _hash = 31 * _hash + java.util.Objects.hashCode(mMessage);
         _hash = 31 * _hash + Long.hashCode(mTime);
         return _hash;
     }

     @Override
     @DataClass.Generated.Member
     public void writeToParcel(@NonNull android.os.Parcel dest, int flags) {
         // You can override field parcelling by defining methods like:
         // void parcelFieldName(Parcel dest, int flags) { ... }

         byte flg = 0;
         if (mAttributionTag != null) flg |= 0x4;
         dest.writeByte(flg);
         dest.writeInt(mOpCode);
         dest.writeInt(mNotingUid);
         if (mAttributionTag != null) dest.writeString(mAttributionTag);
         dest.writeString(mMessage);
         dest.writeLong(mTime);
     }

     @Override
     @DataClass.Generated.Member
     public int describeContents() { return 0; }

     /** @hide */
     @SuppressWarnings({"unchecked", "RedundantCast"})
     @DataClass.Generated.Member
     /* package-private */ AsyncNotedAppOp(@NonNull android.os.Parcel in) {
         // You can override field unparcelling by defining methods like:
         // static FieldType unparcelFieldName(Parcel in) { ... }

         byte flg = in.readByte();
         int opCode = in.readInt();
         int notingUid = in.readInt();
         String attributionTag = (flg & 0x4) == 0 ? null : in.readString();
         String message = in.readString();
         long time = in.readLong();

         this.mOpCode = opCode;
         com.android.internal.util.AnnotationValidations.validate(
                 IntRange.class, null, mOpCode,
                 "from", 0);
         this.mNotingUid = notingUid;
         com.android.internal.util.AnnotationValidations.validate(
                 IntRange.class, null, mNotingUid,
                 "from", 0);
         this.mAttributionTag = attributionTag;
         this.mMessage = message;
         com.android.internal.util.AnnotationValidations.validate(
                 NonNull.class, null, mMessage);
         this.mTime = time;
         com.android.internal.util.AnnotationValidations.validate(
                 CurrentTimeMillisLong.class, null, mTime);

         onConstructed();
     }

     @DataClass.Generated.Member
     public static final @NonNull Parcelable.Creator<AsyncNotedAppOp> CREATOR
             = new Parcelable.Creator<AsyncNotedAppOp>() {
         @Override
         public AsyncNotedAppOp[] newArray(int size) {
             return new AsyncNotedAppOp[size];
         }

         @Override
         public AsyncNotedAppOp createFromParcel(@NonNull android.os.Parcel in) {
             return new AsyncNotedAppOp(in);
         }
     };

     @DataClass.Generated(
             time = 1643320606160L,
             codegenVersion = "1.0.23",
             sourceFile = "frameworks/base/core/java/android/app/AsyncNotedAppOp.java",
             inputSignatures = "private final @android.annotation.IntRange int mOpCode\nprivate final @android.annotation.IntRange int mNotingUid\nprivate final @android.annotation.Nullable java.lang.String mAttributionTag\nprivate final @android.annotation.NonNull java.lang.String mMessage\nprivate final @android.annotation.CurrentTimeMillisLong long mTime\npublic @android.annotation.NonNull java.lang.String getOp()\nprivate  void onConstructed()\nprivate  java.lang.String opCodeToString()\nclass AsyncNotedAppOp extends java.lang.Object implements [android.os.Parcelable]\[email protected](genEqualsHashCode=true, genAidl=true, genHiddenConstructor=true, genToString=true)")
     @Deprecated
     private void __metadata() {}


     //@formatter:on
     // End of generated code

 }
	/*
	* Copyright (C) 2019 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.app;

	import android.annotation.CurrentTimeMillisLong;
	import android.annotation.IntRange;
	import android.annotation.NonNull;
	import android.annotation.Nullable;
	import android.os.Parcelable;

	import com.android.internal.annotations.Immutable;
	import com.android.internal.util.DataClass;
	import com.android.internal.util.Preconditions;

	/**
	* When an {@link AppOpsManager#noteOp(String, int, String, String, String) app-op is noted} and the
	* app the app-op is noted for has a {@link AppOpsManager.OnOpNotedCallback} registered the
	* note-event needs to be delivered to the callback. Usually this is done via an
	* {@link SyncNotedAppOp}, but in some cases this is not possible. In this case an
	* {@link AsyncNotedAppOp} is send to the system server and then forwarded to the
	* {@link AppOpsManager.OnOpNotedCallback} in the app.
	*/
	@Immutable
	@DataClass(genEqualsHashCode = true,
	genAidl = true,
	genHiddenConstructor = true,
	genToString = true)
	// - We don't expose the opCode, but rather the public name of the op, hence use a non-standard
	// getter
	@DataClass.Suppress({"getOpCode"})
	public final class AsyncNotedAppOp implements Parcelable {
	/** Op that was noted */
	private final @IntRange(from = 0) int mOpCode;

	/** Uid that noted the op */
	private final @IntRange(from = 0) int mNotingUid;

	/** {@link android.content.Context#createAttributionContext attribution tag} */
	private final @Nullable String mAttributionTag;

	/** Message associated with the noteOp. This message is set by the app noting the op */
	private final @NonNull String mMessage;

	/** Milliseconds since epoch when the op was noted */
	private final @CurrentTimeMillisLong long mTime;

	/**
	* @return Op that was noted.
	*/
	public @NonNull String getOp() {
	return AppOpsManager.opToPublicName(mOpCode);
	}

	//TODO eugenesusla: support inlinable expressions in annotation params of @DataClass members to
	// allow validating via @IntRange(from = 0, to = AppOpsManager._NUM_OP - 1)
	private void onConstructed() {
	Preconditions.checkArgumentInRange(mOpCode, 0, AppOpsManager._NUM_OP - 1, "opCode");
	}

	private String opCodeToString() {
	return getOp();
	}



	// Code below generated by codegen v1.0.23.
	//
	// DO NOT MODIFY!
	// CHECKSTYLE:OFF Generated code
	//
	// To regenerate run:
	// $ codegen $ANDROID_BUILD_TOP/frameworks/base/core/java/android/app/AsyncNotedAppOp.java
	//
	// To exclude the generated code from IntelliJ auto-formatting enable (one-time):
	// Settings > Editor > Code Style > Formatter Control
	//@formatter:off


	/**
	* Creates a new AsyncNotedAppOp.
	*
	* @param opCode
	* Op that was noted
	* @param notingUid
	* Uid that noted the op
	* @param attributionTag
	* {@link android.content.Context#createAttributionContext attribution tag}
	* @param message
	* Message associated with the noteOp. This message is set by the app noting the op
	* @param time
	* Milliseconds since epoch when the op was noted
	* @hide
	*/
	@DataClass.Generated.Member
	public AsyncNotedAppOp(
	@IntRange(from = 0) int opCode,
	@IntRange(from = 0) int notingUid,
	@Nullable String attributionTag,
	@NonNull String message,
	@CurrentTimeMillisLong long time) {
	this.mOpCode = opCode;
	com.android.internal.util.AnnotationValidations.validate(
	IntRange.class, null, mOpCode,
	"from", 0);
	this.mNotingUid = notingUid;
	com.android.internal.util.AnnotationValidations.validate(
	IntRange.class, null, mNotingUid,
	"from", 0);
	this.mAttributionTag = attributionTag;
	this.mMessage = message;
	com.android.internal.util.AnnotationValidations.validate(
	NonNull.class, null, mMessage);
	this.mTime = time;
	com.android.internal.util.AnnotationValidations.validate(
	CurrentTimeMillisLong.class, null, mTime);

	onConstructed();
	}

	/**
	* Uid that noted the op
	*/
	@DataClass.Generated.Member
	public @IntRange(from = 0) int getNotingUid() {
	return mNotingUid;
	}

	/**
	* {@link android.content.Context#createAttributionContext attribution tag}
	*/
	@DataClass.Generated.Member
	public @Nullable String getAttributionTag() {
	return mAttributionTag;
	}

	/**
	* Message associated with the noteOp. This message is set by the app noting the op
	*/
	@DataClass.Generated.Member
	public @NonNull String getMessage() {
	return mMessage;
	}

	/**
	* Milliseconds since epoch when the op was noted
	*/
	@DataClass.Generated.Member
	public @CurrentTimeMillisLong long getTime() {
	return mTime;
	}

	@Override
	@DataClass.Generated.Member
	public String toString() {
	// You can override field toString logic by defining methods like:
	// String fieldNameToString() { ... }

	return "AsyncNotedAppOp { " +
	"opCode = " + opCodeToString() + ", " +
	"notingUid = " + mNotingUid + ", " +
	"attributionTag = " + mAttributionTag + ", " +
	"message = " + mMessage + ", " +
	"time = " + mTime +
	" }";
	}

	@Override
	@DataClass.Generated.Member
	public boolean equals(@Nullable Object o) {
	// You can override field equality logic by defining either of the methods like:
	// boolean fieldNameEquals(AsyncNotedAppOp other) { ... }
	// boolean fieldNameEquals(FieldType otherValue) { ... }

	if (this == o) return true;
	if (o == null \|\| getClass() != o.getClass()) return false;
	@SuppressWarnings("unchecked")
	AsyncNotedAppOp that = (AsyncNotedAppOp) o;
	//noinspection PointlessBooleanExpression
	return true
	&& mOpCode == that.mOpCode
	&& mNotingUid == that.mNotingUid
	&& java.util.Objects.equals(mAttributionTag, that.mAttributionTag)
	&& java.util.Objects.equals(mMessage, that.mMessage)
	&& mTime == that.mTime;
	}

	@Override
	@DataClass.Generated.Member
	public int hashCode() {
	// You can override field hashCode logic by defining methods like:
	// int fieldNameHashCode() { ... }

	int _hash = 1;
	_hash = 31 * _hash + mOpCode;
	_hash = 31 * _hash + mNotingUid;
	_hash = 31 * _hash + java.util.Objects.hashCode(mAttributionTag);
	_hash = 31 * _hash + java.util.Objects.hashCode(mMessage);
	_hash = 31 * _hash + Long.hashCode(mTime);
	return _hash;
	}

	@Override
	@DataClass.Generated.Member
	public void writeToParcel(@NonNull android.os.Parcel dest, int flags) {
	// You can override field parcelling by defining methods like:
	// void parcelFieldName(Parcel dest, int flags) { ... }

	byte flg = 0;
	if (mAttributionTag != null) flg \|= 0x4;
	dest.writeByte(flg);
	dest.writeInt(mOpCode);
	dest.writeInt(mNotingUid);
	if (mAttributionTag != null) dest.writeString(mAttributionTag);
	dest.writeString(mMessage);
	dest.writeLong(mTime);
	}

	@Override
	@DataClass.Generated.Member
	public int describeContents() { return 0; }

	/** @hide */
	@SuppressWarnings({"unchecked", "RedundantCast"})
	@DataClass.Generated.Member
	/* package-private */ AsyncNotedAppOp(@NonNull android.os.Parcel in) {
	// You can override field unparcelling by defining methods like:
	// static FieldType unparcelFieldName(Parcel in) { ... }

	byte flg = in.readByte();
	int opCode = in.readInt();
	int notingUid = in.readInt();
	String attributionTag = (flg & 0x4) == 0 ? null : in.readString();
	String message = in.readString();
	long time = in.readLong();

	this.mOpCode = opCode;
	com.android.internal.util.AnnotationValidations.validate(
	IntRange.class, null, mOpCode,
	"from", 0);
	this.mNotingUid = notingUid;
	com.android.internal.util.AnnotationValidations.validate(
	IntRange.class, null, mNotingUid,
	"from", 0);
	this.mAttributionTag = attributionTag;
	this.mMessage = message;
	com.android.internal.util.AnnotationValidations.validate(
	NonNull.class, null, mMessage);
	this.mTime = time;
	com.android.internal.util.AnnotationValidations.validate(
	CurrentTimeMillisLong.class, null, mTime);

	onConstructed();
	}

	@DataClass.Generated.Member
	public static final @NonNull Parcelable.Creator<AsyncNotedAppOp> CREATOR
	= new Parcelable.Creator<AsyncNotedAppOp>() {
	@Override
	public AsyncNotedAppOp[] newArray(int size) {
	return new AsyncNotedAppOp[size];
	}

	@Override
	public AsyncNotedAppOp createFromParcel(@NonNull android.os.Parcel in) {
	return new AsyncNotedAppOp(in);
	}
	};

	@DataClass.Generated(
	time = 1643320606160L,
	codegenVersion = "1.0.23",
	sourceFile = "frameworks/base/core/java/android/app/AsyncNotedAppOp.java",
	inputSignatures = "private final @android.annotation.IntRange int mOpCode\nprivate final @android.annotation.IntRange int mNotingUid\nprivate final @android.annotation.Nullable java.lang.String mAttributionTag\nprivate final @android.annotation.NonNull java.lang.String mMessage\nprivate final @android.annotation.CurrentTimeMillisLong long mTime\npublic @android.annotation.NonNull java.lang.String getOp()\nprivate void onConstructed()\nprivate java.lang.String opCodeToString()\nclass AsyncNotedAppOp extends java.lang.Object implements [android.os.Parcelable]\[email protected](genEqualsHashCode=true, genAidl=true, genHiddenConstructor=true, genToString=true)")
	@Deprecated
	private void __metadata() {}


	//@formatter:on
	// End of generated code

	}