com.android.dx.rop.code.AccessFlags Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of builder Show documentation
Show all versions of builder Show documentation
Library to build Android applications.
/*
* Copyright (C) 2007 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 com.android.dx.rop.code;
import com.android.dx.util.Hex;
/**
* Constants used as "access flags" in various places in classes, and
* related utilities. Although, at the rop layer, flags are generally
* ignored, this is the layer of communication, and as such, this
* package is where these definitions belong. The flag definitions are
* identical to Java access flags, but {@code ACC_SUPER} isn't
* used at all in translated code, and {@code ACC_SYNCHRONIZED}
* is only used in a very limited way.
*/
public final class AccessFlags {
/** public member / class */
public static final int ACC_PUBLIC = 0x0001;
/** private member */
public static final int ACC_PRIVATE = 0x0002;
/** protected member */
public static final int ACC_PROTECTED = 0x0004;
/** static member */
public static final int ACC_STATIC = 0x0008;
/** final member / class */
public static final int ACC_FINAL = 0x0010;
/**
* synchronized method; only valid in dex files for {@code native}
* methods
*/
public static final int ACC_SYNCHRONIZED = 0x0020;
/**
* class with new-style {@code invokespecial} for superclass
* method access
*/
public static final int ACC_SUPER = 0x0020;
/** volatile field */
public static final int ACC_VOLATILE = 0x0040;
/** bridge method (generated) */
public static final int ACC_BRIDGE = 0x0040;
/** transient field */
public static final int ACC_TRANSIENT = 0x0080;
/** varargs method */
public static final int ACC_VARARGS = 0x0080;
/** native method */
public static final int ACC_NATIVE = 0x0100;
/** "class" is in fact an public static final interface */
public static final int ACC_INTERFACE = 0x0200;
/** abstract method / class */
public static final int ACC_ABSTRACT = 0x0400;
/**
* method with strict floating point ({@code strictfp})
* behavior
*/
public static final int ACC_STRICT = 0x0800;
/** synthetic member */
public static final int ACC_SYNTHETIC = 0x1000;
/** class is an annotation type */
public static final int ACC_ANNOTATION = 0x2000;
/**
* class is an enumerated type; field is an element of an enumerated
* type
*/
public static final int ACC_ENUM = 0x4000;
/** method is a constructor */
public static final int ACC_CONSTRUCTOR = 0x10000;
/**
* method was declared {@code synchronized}; has no effect on
* execution (other than inspecting this flag, per se)
*/
public static final int ACC_DECLARED_SYNCHRONIZED = 0x20000;
/** flags defined on classes */
public static final int CLASS_FLAGS =
ACC_PUBLIC | ACC_FINAL | ACC_SUPER | ACC_INTERFACE | ACC_ABSTRACT |
ACC_SYNTHETIC | ACC_ANNOTATION | ACC_ENUM;
/** flags defined on inner classes */
public static final int INNER_CLASS_FLAGS =
ACC_PUBLIC | ACC_PRIVATE | ACC_PROTECTED | ACC_STATIC | ACC_FINAL |
ACC_INTERFACE | ACC_ABSTRACT | ACC_SYNTHETIC | ACC_ANNOTATION |
ACC_ENUM;
/** flags defined on fields */
public static final int FIELD_FLAGS =
ACC_PUBLIC | ACC_PRIVATE | ACC_PROTECTED | ACC_STATIC | ACC_FINAL |
ACC_VOLATILE | ACC_TRANSIENT | ACC_SYNTHETIC | ACC_ENUM;
/** flags defined on methods */
public static final int METHOD_FLAGS =
ACC_PUBLIC | ACC_PRIVATE | ACC_PROTECTED | ACC_STATIC | ACC_FINAL |
ACC_SYNCHRONIZED | ACC_BRIDGE | ACC_VARARGS | ACC_NATIVE |
ACC_ABSTRACT | ACC_STRICT | ACC_SYNTHETIC | ACC_CONSTRUCTOR |
ACC_DECLARED_SYNCHRONIZED;
/** indicates conversion of class flags */
private static final int CONV_CLASS = 1;
/** indicates conversion of field flags */
private static final int CONV_FIELD = 2;
/** indicates conversion of method flags */
private static final int CONV_METHOD = 3;
/**
* This class is uninstantiable.
*/
private AccessFlags() {
// This space intentionally left blank.
}
/**
* Returns a human-oriented string representing the given access flags,
* as defined on classes (not fields or methods).
*
* @param flags the flags
* @return {@code non-null;} human-oriented string
*/
public static String classString(int flags) {
return humanHelper(flags, CLASS_FLAGS, CONV_CLASS);
}
/**
* Returns a human-oriented string representing the given access flags,
* as defined on inner classes.
*
* @param flags the flags
* @return {@code non-null;} human-oriented string
*/
public static String innerClassString(int flags) {
return humanHelper(flags, INNER_CLASS_FLAGS, CONV_CLASS);
}
/**
* Returns a human-oriented string representing the given access flags,
* as defined on fields (not classes or methods).
*
* @param flags the flags
* @return {@code non-null;} human-oriented string
*/
public static String fieldString(int flags) {
return humanHelper(flags, FIELD_FLAGS, CONV_FIELD);
}
/**
* Returns a human-oriented string representing the given access flags,
* as defined on methods (not classes or fields).
*
* @param flags the flags
* @return {@code non-null;} human-oriented string
*/
public static String methodString(int flags) {
return humanHelper(flags, METHOD_FLAGS, CONV_METHOD);
}
/**
* Returns whether the flag {@code ACC_PUBLIC} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_PUBLIC} flag
*/
public static boolean isPublic(int flags) {
return (flags & ACC_PUBLIC) != 0;
}
/**
* Returns whether the flag {@code ACC_PROTECTED} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_PROTECTED} flag
*/
public static boolean isProtected(int flags) {
return (flags & ACC_PROTECTED) != 0;
}
/**
* Returns whether the flag {@code ACC_PRIVATE} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_PRIVATE} flag
*/
public static boolean isPrivate(int flags) {
return (flags & ACC_PRIVATE) != 0;
}
/**
* Returns whether the flag {@code ACC_STATIC} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_STATIC} flag
*/
public static boolean isStatic(int flags) {
return (flags & ACC_STATIC) != 0;
}
/**
* Returns whether the flag {@code ACC_CONSTRUCTOR} is on in
* the given flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_CONSTRUCTOR} flag
*/
public static boolean isConstructor(int flags) {
return (flags & ACC_CONSTRUCTOR) != 0;
}
/**
* Returns whether the flag {@code ACC_INTERFACE} is on in
* the given flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_INTERFACE} flag
*/
public static boolean isInterface(int flags) {
return (flags & ACC_INTERFACE) != 0;
}
/**
* Returns whether the flag {@code ACC_SYNCHRONIZED} is on in
* the given flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_SYNCHRONIZED} flag
*/
public static boolean isSynchronized(int flags) {
return (flags & ACC_SYNCHRONIZED) != 0;
}
/**
* Returns whether the flag {@code ACC_ABSTRACT} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_ABSTRACT} flag
*/
public static boolean isAbstract(int flags) {
return (flags & ACC_ABSTRACT) != 0;
}
/**
* Returns whether the flag {@code ACC_NATIVE} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_NATIVE} flag
*/
public static boolean isNative(int flags) {
return (flags & ACC_NATIVE) != 0;
}
/**
* Returns whether the flag {@code ACC_ANNOTATION} is on in the given
* flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_ANNOTATION} flag
*/
public static boolean isAnnotation(int flags) {
return (flags & ACC_ANNOTATION) != 0;
}
/**
* Returns whether the flag {@code ACC_DECLARED_SYNCHRONIZED} is
* on in the given flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_DECLARED_SYNCHRONIZED} flag
*/
public static boolean isDeclaredSynchronized(int flags) {
return (flags & ACC_DECLARED_SYNCHRONIZED) != 0;
}
/**
* Returns whether the flag {@code ACC_ENUM} is on in the given flags.
*
* @param flags the flags to check
* @return the value of the {@code ACC_ENUM} flag
*/
public static boolean isEnum(int flags) {
return (flags & ACC_ENUM) != 0;
}
/**
* Helper to return a human-oriented string representing the given
* access flags.
*
* @param flags the defined flags
* @param mask mask for the "defined" bits
* @param what what the flags represent (one of {@code CONV_*})
* @return {@code non-null;} human-oriented string
*/
private static String humanHelper(int flags, int mask, int what) {
StringBuffer sb = new StringBuffer(80);
int extra = flags & ~mask;
flags &= mask;
if ((flags & ACC_PUBLIC) != 0) {
sb.append("|public");
}
if ((flags & ACC_PRIVATE) != 0) {
sb.append("|private");
}
if ((flags & ACC_PROTECTED) != 0) {
sb.append("|protected");
}
if ((flags & ACC_STATIC) != 0) {
sb.append("|static");
}
if ((flags & ACC_FINAL) != 0) {
sb.append("|final");
}
if ((flags & ACC_SYNCHRONIZED) != 0) {
if (what == CONV_CLASS) {
sb.append("|super");
} else {
sb.append("|synchronized");
}
}
if ((flags & ACC_VOLATILE) != 0) {
if (what == CONV_METHOD) {
sb.append("|bridge");
} else {
sb.append("|volatile");
}
}
if ((flags & ACC_TRANSIENT) != 0) {
if (what == CONV_METHOD) {
sb.append("|varargs");
} else {
sb.append("|transient");
}
}
if ((flags & ACC_NATIVE) != 0) {
sb.append("|native");
}
if ((flags & ACC_INTERFACE) != 0) {
sb.append("|interface");
}
if ((flags & ACC_ABSTRACT) != 0) {
sb.append("|abstract");
}
if ((flags & ACC_STRICT) != 0) {
sb.append("|strictfp");
}
if ((flags & ACC_SYNTHETIC) != 0) {
sb.append("|synthetic");
}
if ((flags & ACC_ANNOTATION) != 0) {
sb.append("|annotation");
}
if ((flags & ACC_ENUM) != 0) {
sb.append("|enum");
}
if ((flags & ACC_CONSTRUCTOR) != 0) {
sb.append("|constructor");
}
if ((flags & ACC_DECLARED_SYNCHRONIZED) != 0) {
sb.append("|declared_synchronized");
}
if ((extra != 0) || (sb.length() == 0)) {
sb.append('|');
sb.append(Hex.u2(extra));
}
return sb.substring(1);
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy