| /* |
| * 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 dalvik.system; |
| |
| /** |
| * Holder class for extraneous Class data. |
| * |
| * This class holds data for Class objects that is either rarely useful, only necessary for |
| * debugging purposes or both. This allows us to extend the Class class without impacting memory |
| * use. |
| * |
| * @hide For internal runtime use only. |
| */ |
| public final class ClassExt { |
| /** |
| * If the class is in an erroneous state, we must return the same error on subsequent tries. |
| * |
| * This field is a logical part of the 'Class' type. |
| */ |
| private Throwable erroneousStateError; |
| |
| /** |
| * A Pointer-sized-array of instance jfieldIDs in the same order as the ifields_ array. |
| * The jfieldID is associated with the ArtField at the corresonding index in the ifields_ array. |
| */ |
| private Object instanceJfieldIDs; |
| |
| /** |
| * A Pointer-sized-array of jmethodIDS in the same order as the methods_ |
| * array. The jmethodID is associated with the ArtField at the corresonding |
| * index in the methods_ array. |
| */ |
| private Object jmethodIDs; |
| |
| /** |
| * If the class has undergone structural redefinition, the now obsolete class object. |
| * |
| * Needed to ensure that the class isn't unloaded before its jit code is. Normally this is |
| * handled by the classloader but since the class is now obsolete it's no longer held live |
| * there and instead we must do so manually. This class should not be used for anything. |
| */ |
| private Class<?> obsoleteClass; |
| |
| /** |
| * An array of all obsolete DexCache objects that are needed for obsolete methods. |
| * |
| * These entries are associated with the obsolete ArtMethod pointers at the same indexes in the |
| * obsoleteMethods array. |
| * |
| * This field has native components and is a logical part of the 'Class' type. |
| */ |
| private Object[] obsoleteDexCaches; |
| |
| /** |
| * An array of all native obsolete ArtMethod pointers. |
| * |
| * These are associated with their DexCaches at the same index in the obsoleteDexCaches array. |
| * |
| * This field is actually either an int[] or a long[] depending on size of a pointer. |
| * |
| * This field contains native pointers and is a logical part of the 'Class' type. |
| */ |
| private Object obsoleteMethods; |
| |
| /** |
| * If set, the bytes, native pointer (as a java.lang.Long), or DexCache of the original dex-file |
| * associated with the related class. |
| * |
| * In this instance 'original' means either (1) the dex-file loaded for this class when it was |
| * first loaded after all non-retransformation capable transformations had been performed but |
| * before any retransformation capable ones had been done or (2) the most recent dex-file bytes |
| * given for a class redefinition. |
| * |
| * Needed in order to implement retransformation of classes. |
| * |
| * This field is a logical part of the 'Class' type. |
| */ |
| private Object originalDexFile; |
| |
| /** |
| * A Pointer-sized-array of static jfieldIDs in the same order as the sfields_ array. |
| * The jfieldID is associated with the ArtField at the corresonding index in the sfields_ array. |
| */ |
| private Object staticJfieldIDs; |
| |
| /** |
| * If set, native pointer to the initial, pre-redefine, dex file associated with the related |
| * class. This is different from the {@code originalDexFile} which is the pre-retransform dex |
| * file, i.e. could contain the bytes of the dex file provided during redefine. |
| * |
| * It is enough to store the native pointer because the pre-redefine dex file is either part |
| * of boot classpath or it is being kept alive by its class loader. Class loaders always keep |
| * dex files alive even if all their classes have been redefined. |
| * |
| * Needed in order to preserve access to dex-level hiddenapi flags after JVMTI redefine. |
| * |
| * This field is a logical part of the 'Class' type. |
| */ |
| private long preRedefineDexFilePtr; |
| |
| /** |
| * ClassDef index of the related class in the pre-redefine dex file. Set together with |
| * {@code preRedefineDexFilePtr}. |
| * |
| * Needed in order to preserve access to dex-level hiddenapi flags after JVMTI redefine. |
| * |
| * This field is a logical part of the 'Class' type. |
| */ |
| private int preRedefineClassDefIndex; |
| |
| /** |
| * Backing store of user-defined values pertaining to a class. |
| * Maintained by the ClassValue class. |
| * |
| * ClassValue.ClassValueMap is package-private, hence plain Object. |
| */ |
| public Object classValueMap; |
| |
| /** |
| * Private constructor. |
| * |
| * Only created by the runtime. |
| */ |
| private ClassExt() {} |
| } |