/* * Copyright (C) 2008 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. */ #include "java_lang_reflect_Field.h" #include "android-base/stringprintf.h" #include "nativehelper/jni_macros.h" #include "art_field-inl.h" #include "base/utils.h" #include "class_linker-inl.h" #include "class_linker.h" #include "common_throws.h" #include "dex/dex_file-inl.h" #include "dex/dex_file_annotations.h" #include "jni/jni_internal.h" #include "jvalue-inl.h" #include "mirror/class-inl.h" #include "mirror/field-inl.h" #include "mirror/object_array-alloc-inl.h" #include "native_util.h" #include "reflection-inl.h" #include "scoped_fast_native_object_access-inl.h" #include "well_known_classes.h" namespace art { using android::base::StringPrintf; template ALWAYS_INLINE inline static bool VerifyFieldAccess(Thread* self, ObjPtr field, ObjPtr obj) REQUIRES_SHARED(Locks::mutator_lock_) { if (kIsSet && field->IsFinal()) { ThrowIllegalAccessException( StringPrintf("Cannot set %s field %s of class %s", PrettyJavaAccessFlags(field->GetAccessFlags()).c_str(), ArtField::PrettyField(field->GetArtField()).c_str(), field->GetDeclaringClass() == nullptr ? "null" : field->GetDeclaringClass()->PrettyClass().c_str()).c_str()); return false; } ObjPtr calling_class; if (!VerifyAccess(self, obj, field->GetDeclaringClass(), field->GetAccessFlags(), &calling_class, 1)) { ThrowIllegalAccessException( StringPrintf("Class %s cannot access %s field %s of class %s", calling_class == nullptr ? "null" : calling_class->PrettyClass().c_str(), PrettyJavaAccessFlags(field->GetAccessFlags()).c_str(), ArtField::PrettyField(field->GetArtField()).c_str(), field->GetDeclaringClass() == nullptr ? "null" : field->GetDeclaringClass()->PrettyClass().c_str()).c_str()); return false; } return true; } template ALWAYS_INLINE inline static bool GetFieldValue(ObjPtr o, ObjPtr f, Primitive::Type field_type, JValue* value) REQUIRES_SHARED(Locks::mutator_lock_) { DCHECK_EQ(value->GetJ(), INT64_C(0)); MemberOffset offset(f->GetOffset()); const bool is_volatile = f->IsVolatile(); switch (field_type) { case Primitive::kPrimBoolean: value->SetZ(is_volatile ? o->GetFieldBooleanVolatile(offset) : o->GetFieldBoolean(offset)); return true; case Primitive::kPrimByte: value->SetB(is_volatile ? o->GetFieldByteVolatile(offset) : o->GetFieldByte(offset)); return true; case Primitive::kPrimChar: value->SetC(is_volatile ? o->GetFieldCharVolatile(offset) : o->GetFieldChar(offset)); return true; case Primitive::kPrimInt: case Primitive::kPrimFloat: value->SetI(is_volatile ? o->GetField32Volatile(offset) : o->GetField32(offset)); return true; case Primitive::kPrimLong: case Primitive::kPrimDouble: value->SetJ(is_volatile ? o->GetField64Volatile(offset) : o->GetField64(offset)); return true; case Primitive::kPrimShort: value->SetS(is_volatile ? o->GetFieldShortVolatile(offset) : o->GetFieldShort(offset)); return true; case Primitive::kPrimNot: if (kAllowReferences) { value->SetL(is_volatile ? o->GetFieldObjectVolatile(offset) : o->GetFieldObject(offset)); return true; } // Else break to report an error. break; case Primitive::kPrimVoid: // Never okay. break; } ThrowIllegalArgumentException( StringPrintf("Not a primitive field: %s", ArtField::PrettyField(f->GetArtField()).c_str()).c_str()); return false; } ALWAYS_INLINE inline static bool CheckReceiver(const ScopedFastNativeObjectAccess& soa, jobject j_rcvr, ObjPtr* f, ObjPtr* class_or_rcvr) REQUIRES_SHARED(Locks::mutator_lock_) { soa.Self()->AssertThreadSuspensionIsAllowable(); ObjPtr declaring_class = (*f)->GetDeclaringClass(); if ((*f)->IsStatic()) { if (UNLIKELY(!declaring_class->IsInitialized())) { StackHandleScope<2> hs(soa.Self()); HandleWrapperObjPtr h_f(hs.NewHandleWrapper(f)); HandleWrapperObjPtr h_klass(hs.NewHandleWrapper(&declaring_class)); ClassLinker* const class_linker = Runtime::Current()->GetClassLinker(); if (UNLIKELY(!class_linker->EnsureInitialized(soa.Self(), h_klass, true, true))) { DCHECK(soa.Self()->IsExceptionPending()); return false; } } *class_or_rcvr = declaring_class; return true; } *class_or_rcvr = soa.Decode(j_rcvr); if (!VerifyObjectIsClass(*class_or_rcvr, declaring_class)) { DCHECK(soa.Self()->IsExceptionPending()); return false; } return true; } static jobject Field_get(JNIEnv* env, jobject javaField, jobject javaObj) { ScopedFastNativeObjectAccess soa(env); ObjPtr f = soa.Decode(javaField); ObjPtr o; if (!CheckReceiver(soa, javaObj, &f, &o)) { DCHECK(soa.Self()->IsExceptionPending()); return nullptr; } // If field is not set to be accessible, verify it can be accessed by the caller. if (!f->IsAccessible() && !VerifyFieldAccess(soa.Self(), f, o)) { DCHECK(soa.Self()->IsExceptionPending()); return nullptr; } // We now don't expect suspension unless an exception is thrown. // Get the field's value, boxing if necessary. Primitive::Type field_type = f->GetTypeAsPrimitiveType(); JValue value; if (!GetFieldValue(o, f, field_type, &value)) { DCHECK(soa.Self()->IsExceptionPending()); return nullptr; } return soa.AddLocalReference(BoxPrimitive(field_type, value)); } template ALWAYS_INLINE inline static JValue GetPrimitiveField(JNIEnv* env, jobject javaField, jobject javaObj) { ScopedFastNativeObjectAccess soa(env); ObjPtr f = soa.Decode(javaField); ObjPtr o; if (!CheckReceiver(soa, javaObj, &f, &o)) { DCHECK(soa.Self()->IsExceptionPending()); return JValue(); } // If field is not set to be accessible, verify it can be accessed by the caller. if (!f->IsAccessible() && !VerifyFieldAccess(soa.Self(), f, o)) { DCHECK(soa.Self()->IsExceptionPending()); return JValue(); } // We now don't expect suspension unless an exception is thrown. // Read the value. Primitive::Type field_type = f->GetTypeAsPrimitiveType(); JValue field_value; if (field_type == kPrimitiveType) { // This if statement should get optimized out since we only pass in valid primitive types. if (UNLIKELY(!GetFieldValue(o, f, kPrimitiveType, &field_value))) { DCHECK(soa.Self()->IsExceptionPending()); return JValue(); } return field_value; } if (!GetFieldValue(o, f, field_type, &field_value)) { DCHECK(soa.Self()->IsExceptionPending()); return JValue(); } // Widen it if necessary (and possible). JValue wide_value; if (!ConvertPrimitiveValue(false, field_type, kPrimitiveType, field_value, &wide_value)) { DCHECK(soa.Self()->IsExceptionPending()); return JValue(); } return wide_value; } static jboolean Field_getBoolean(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetZ(); } static jbyte Field_getByte(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetB(); } static jchar Field_getChar(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetC(); } static jdouble Field_getDouble(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetD(); } static jfloat Field_getFloat(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetF(); } static jint Field_getInt(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetI(); } static jlong Field_getLong(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetJ(); } static jshort Field_getShort(JNIEnv* env, jobject javaField, jobject javaObj) { return GetPrimitiveField(env, javaField, javaObj).GetS(); } ALWAYS_INLINE inline static void SetFieldValue(ObjPtr o, ObjPtr f, Primitive::Type field_type, bool allow_references, const JValue& new_value) REQUIRES_SHARED(Locks::mutator_lock_) { DCHECK(f->GetDeclaringClass()->IsInitialized()); MemberOffset offset(f->GetOffset()); const bool is_volatile = f->IsVolatile(); switch (field_type) { case Primitive::kPrimBoolean: if (is_volatile) { o->SetFieldBooleanVolatile(offset, new_value.GetZ()); } else { o->SetFieldBoolean(offset, new_value.GetZ()); } break; case Primitive::kPrimByte: if (is_volatile) { o->SetFieldBooleanVolatile(offset, new_value.GetB()); } else { o->SetFieldBoolean(offset, new_value.GetB()); } break; case Primitive::kPrimChar: if (is_volatile) { o->SetFieldCharVolatile(offset, new_value.GetC()); } else { o->SetFieldChar(offset, new_value.GetC()); } break; case Primitive::kPrimInt: case Primitive::kPrimFloat: if (is_volatile) { o->SetField32Volatile(offset, new_value.GetI()); } else { o->SetField32(offset, new_value.GetI()); } break; case Primitive::kPrimLong: case Primitive::kPrimDouble: if (is_volatile) { o->SetField64Volatile(offset, new_value.GetJ()); } else { o->SetField64(offset, new_value.GetJ()); } break; case Primitive::kPrimShort: if (is_volatile) { o->SetFieldShortVolatile(offset, new_value.GetS()); } else { o->SetFieldShort(offset, new_value.GetS()); } break; case Primitive::kPrimNot: if (allow_references) { if (is_volatile) { o->SetFieldObjectVolatile(offset, new_value.GetL()); } else { o->SetFieldObject(offset, new_value.GetL()); } break; } // Else fall through to report an error. FALLTHROUGH_INTENDED; case Primitive::kPrimVoid: // Never okay. ThrowIllegalArgumentException( StringPrintf("Not a primitive field: %s", ArtField::PrettyField(f->GetArtField()).c_str()).c_str()); return; } } static void Field_set(JNIEnv* env, jobject javaField, jobject javaObj, jobject javaValue) { ScopedFastNativeObjectAccess soa(env); ObjPtr f = soa.Decode(javaField); // Check that the receiver is non-null and an instance of the field's declaring class. ObjPtr o; if (!CheckReceiver(soa, javaObj, &f, &o)) { DCHECK(soa.Self()->IsExceptionPending()); return; } ObjPtr field_type; const char* field_type_descriptor = f->GetArtField()->GetTypeDescriptor(); Primitive::Type field_prim_type = Primitive::GetType(field_type_descriptor[0]); if (field_prim_type == Primitive::kPrimNot) { field_type = f->GetType(); } else { field_type = Runtime::Current()->GetClassLinker()->LookupPrimitiveClass(field_type_descriptor[0]); } DCHECK(field_type != nullptr) << field_type_descriptor; // We now don't expect suspension unless an exception is thrown. // Unbox the value, if necessary. ObjPtr boxed_value = soa.Decode(javaValue); JValue unboxed_value; if (!UnboxPrimitiveForField(boxed_value, field_type, f->GetArtField(), &unboxed_value)) { DCHECK(soa.Self()->IsExceptionPending()); return; } // If field is not set to be accessible, verify it can be accessed by the caller. if (!f->IsAccessible() && !VerifyFieldAccess(soa.Self(), f, o)) { DCHECK(soa.Self()->IsExceptionPending()); return; } SetFieldValue(o, f, field_prim_type, true, unboxed_value); } template static void SetPrimitiveField(JNIEnv* env, jobject javaField, jobject javaObj, const JValue& new_value) { ScopedFastNativeObjectAccess soa(env); ObjPtr f = soa.Decode(javaField); ObjPtr o; if (!CheckReceiver(soa, javaObj, &f, &o)) { return; } Primitive::Type field_type = f->GetTypeAsPrimitiveType(); if (UNLIKELY(field_type == Primitive::kPrimNot)) { ThrowIllegalArgumentException( StringPrintf("Not a primitive field: %s", ArtField::PrettyField(f->GetArtField()).c_str()).c_str()); return; } // Widen the value if necessary (and possible). JValue wide_value; if (!ConvertPrimitiveValue(false, kPrimitiveType, field_type, new_value, &wide_value)) { DCHECK(soa.Self()->IsExceptionPending()); return; } // If field is not set to be accessible, verify it can be accessed by the caller. if (!f->IsAccessible() && !VerifyFieldAccess(soa.Self(), f, o)) { DCHECK(soa.Self()->IsExceptionPending()); return; } // Write the value. SetFieldValue(o, f, field_type, false, wide_value); } static void Field_setBoolean(JNIEnv* env, jobject javaField, jobject javaObj, jboolean z) { JValue value; value.SetZ(z); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setByte(JNIEnv* env, jobject javaField, jobject javaObj, jbyte b) { JValue value; value.SetB(b); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setChar(JNIEnv* env, jobject javaField, jobject javaObj, jchar c) { JValue value; value.SetC(c); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setDouble(JNIEnv* env, jobject javaField, jobject javaObj, jdouble d) { JValue value; value.SetD(d); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setFloat(JNIEnv* env, jobject javaField, jobject javaObj, jfloat f) { JValue value; value.SetF(f); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setInt(JNIEnv* env, jobject javaField, jobject javaObj, jint i) { JValue value; value.SetI(i); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setLong(JNIEnv* env, jobject javaField, jobject javaObj, jlong j) { JValue value; value.SetJ(j); SetPrimitiveField(env, javaField, javaObj, value); } static void Field_setShort(JNIEnv* env, jobject javaField, jobject javaObj, jshort s) { JValue value; value.SetS(s); SetPrimitiveField(env, javaField, javaObj, value); } static jobject Field_getAnnotationNative(JNIEnv* env, jobject javaField, jclass annotationType) { ScopedFastNativeObjectAccess soa(env); StackHandleScope<1> hs(soa.Self()); ArtField* field = soa.Decode(javaField)->GetArtField(); if (field->GetDeclaringClass()->IsProxyClass()) { return nullptr; } Handle klass(hs.NewHandle(soa.Decode(annotationType))); return soa.AddLocalReference(annotations::GetAnnotationForField(field, klass)); } static jlong Field_getArtField(JNIEnv* env, jobject javaField) { ScopedFastNativeObjectAccess soa(env); ArtField* field = soa.Decode(javaField)->GetArtField(); return reinterpret_cast(field); } static jstring Field_getNameInternal(JNIEnv* env, jobject javaField) { ScopedFastNativeObjectAccess soa(env); ArtField* field = soa.Decode(javaField)->GetArtField(); return soa.AddLocalReference(field->ResolveNameString()); } static jobjectArray Field_getDeclaredAnnotations(JNIEnv* env, jobject javaField) { ScopedFastNativeObjectAccess soa(env); ArtField* field = soa.Decode(javaField)->GetArtField(); if (field->GetDeclaringClass()->IsProxyClass()) { // Return an empty array instead of a null pointer. ObjPtr annotation_array_class = soa.Decode(WellKnownClasses::java_lang_annotation_Annotation__array); ObjPtr> empty_array = mirror::ObjectArray::Alloc(soa.Self(), annotation_array_class, 0); return soa.AddLocalReference(empty_array); } return soa.AddLocalReference(annotations::GetAnnotationsForField(field)); } static jobjectArray Field_getSignatureAnnotation(JNIEnv* env, jobject javaField) { ScopedFastNativeObjectAccess soa(env); ArtField* field = soa.Decode(javaField)->GetArtField(); if (field->GetDeclaringClass()->IsProxyClass()) { return nullptr; } return soa.AddLocalReference(annotations::GetSignatureAnnotationForField(field)); } static jboolean Field_isAnnotationPresentNative(JNIEnv* env, jobject javaField, jclass annotationType) { ScopedFastNativeObjectAccess soa(env); StackHandleScope<1> hs(soa.Self()); ArtField* field = soa.Decode(javaField)->GetArtField(); if (field->GetDeclaringClass()->IsProxyClass()) { return false; } Handle klass(hs.NewHandle(soa.Decode(annotationType))); return annotations::IsFieldAnnotationPresent(field, klass); } static JNINativeMethod gMethods[] = { FAST_NATIVE_METHOD(Field, get, "(Ljava/lang/Object;)Ljava/lang/Object;"), FAST_NATIVE_METHOD(Field, getBoolean, "(Ljava/lang/Object;)Z"), FAST_NATIVE_METHOD(Field, getByte, "(Ljava/lang/Object;)B"), FAST_NATIVE_METHOD(Field, getChar, "(Ljava/lang/Object;)C"), FAST_NATIVE_METHOD(Field, getAnnotationNative, "(Ljava/lang/Class;)Ljava/lang/annotation/Annotation;"), FAST_NATIVE_METHOD(Field, getArtField, "()J"), FAST_NATIVE_METHOD(Field, getDeclaredAnnotations, "()[Ljava/lang/annotation/Annotation;"), FAST_NATIVE_METHOD(Field, getSignatureAnnotation, "()[Ljava/lang/String;"), FAST_NATIVE_METHOD(Field, getDouble, "(Ljava/lang/Object;)D"), FAST_NATIVE_METHOD(Field, getFloat, "(Ljava/lang/Object;)F"), FAST_NATIVE_METHOD(Field, getInt, "(Ljava/lang/Object;)I"), FAST_NATIVE_METHOD(Field, getLong, "(Ljava/lang/Object;)J"), FAST_NATIVE_METHOD(Field, getNameInternal, "()Ljava/lang/String;"), FAST_NATIVE_METHOD(Field, getShort, "(Ljava/lang/Object;)S"), FAST_NATIVE_METHOD(Field, isAnnotationPresentNative, "(Ljava/lang/Class;)Z"), FAST_NATIVE_METHOD(Field, set, "(Ljava/lang/Object;Ljava/lang/Object;)V"), FAST_NATIVE_METHOD(Field, setBoolean, "(Ljava/lang/Object;Z)V"), FAST_NATIVE_METHOD(Field, setByte, "(Ljava/lang/Object;B)V"), FAST_NATIVE_METHOD(Field, setChar, "(Ljava/lang/Object;C)V"), FAST_NATIVE_METHOD(Field, setDouble, "(Ljava/lang/Object;D)V"), FAST_NATIVE_METHOD(Field, setFloat, "(Ljava/lang/Object;F)V"), FAST_NATIVE_METHOD(Field, setInt, "(Ljava/lang/Object;I)V"), FAST_NATIVE_METHOD(Field, setLong, "(Ljava/lang/Object;J)V"), FAST_NATIVE_METHOD(Field, setShort, "(Ljava/lang/Object;S)V"), }; void register_java_lang_reflect_Field(JNIEnv* env) { REGISTER_NATIVE_METHODS("java/lang/reflect/Field"); } } // namespace art