296 lines
11 KiB
Java
296 lines
11 KiB
Java
|
/*
|
||
|
|
* 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]\n@com.android.internal.util.DataClass(genEqualsHashCode=true, genAidl=true, genHiddenConstructor=true, genToString=true)")
|
||
|
|
@Deprecated
|
||
|
|
private void __metadata() {}
|
||
|
|
|
||
|
|
|
||
|
|
//@formatter:on
|
||
|
|
// End of generated code
|
||
|
|
|
||
|
|
}
|