/* * 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 "jni_internal.h" #include "class_linker.h" #include "class_loader.h" #include "object.h" #include "object_utils.h" #include "ScopedLocalRef.h" #include "ScopedUtfChars.h" #include "JniConstants.h" // Last to avoid problems with LOG redefinition. namespace art { namespace { // "name" is in "binary name" format, e.g. "dalvik.system.Debug$1". jclass Class_classForName(JNIEnv* env, jclass, jstring javaName, jboolean initialize, jobject javaLoader) { ScopedThreadStateChange tsc(Thread::Current(), Thread::kRunnable); ScopedUtfChars name(env, javaName); if (name.c_str() == NULL) { return NULL; } // We need to validate and convert the name (from x.y.z to x/y/z). This // is especially handy for array types, since we want to avoid // auto-generating bogus array classes. if (!IsValidBinaryClassName(name.c_str())) { Thread::Current()->ThrowNewExceptionF("Ljava/lang/ClassNotFoundException;", "Invalid name: %s", name.c_str()); return NULL; } std::string descriptor(DotToDescriptor(name.c_str())); Object* loader = Decode(env, javaLoader); ClassLoader* class_loader = down_cast(loader); ClassLinker* class_linker = Runtime::Current()->GetClassLinker(); Class* c = class_linker->FindClass(descriptor.c_str(), class_loader); if (c == NULL) { // Convert NoClassDefFoundError to ClassNotFoundException // TODO: chain exceptions? DCHECK(env->ExceptionCheck()); env->ExceptionClear(); Thread::Current()->ThrowNewException("Ljava/lang/ClassNotFoundException;", name.c_str()); return NULL; } if (initialize) { class_linker->EnsureInitialized(c, true); } return AddLocalReference(env, c); } jint Class_getAnnotationDirectoryOffset(JNIEnv* env, jclass javaClass) { Class* c = Decode(env, javaClass); if (c->IsPrimitive() || c->IsArrayClass() || c->IsProxyClass()) { return 0; // primitive, array and proxy classes don't have class definitions } const DexFile::ClassDef* class_def = ClassHelper(c).GetClassDef(); if (class_def == NULL) { return 0; // not found } else { return class_def->annotations_off_; } } template jobjectArray ToArray(JNIEnv* env, const char* array_class_name, const std::vector& objects) { jclass array_class = env->FindClass(array_class_name); jobjectArray result = env->NewObjectArray(objects.size(), array_class, NULL); for (size_t i = 0; i < objects.size(); ++i) { ScopedLocalRef object(env, AddLocalReference(env, objects[i])); env->SetObjectArrayElement(result, i, object.get()); } return result; } bool IsVisibleConstructor(Method* m, bool public_only) { if (public_only && !m->IsPublic()) { return false; } if (m->IsStatic()) { return false; } return m->IsConstructor(); } jobjectArray Class_getDeclaredConstructors(JNIEnv* env, jclass javaClass, jboolean publicOnly) { Class* c = Decode(env, javaClass); std::vector constructors; for (size_t i = 0; i < c->NumDirectMethods(); ++i) { Method* m = c->GetDirectMethod(i); if (IsVisibleConstructor(m, publicOnly)) { constructors.push_back(m); } } return ToArray(env, "java/lang/reflect/Constructor", constructors); } bool IsVisibleField(Field* f, bool public_only) { if (public_only && !f->IsPublic()) { return false; } return true; } jobjectArray Class_getDeclaredFields(JNIEnv* env, jclass javaClass, jboolean publicOnly) { Class* c = Decode(env, javaClass); std::vector fields; for (size_t i = 0; i < c->NumInstanceFields(); ++i) { Field* f = c->GetInstanceField(i); if (IsVisibleField(f, publicOnly)) { fields.push_back(f); } if (env->ExceptionOccurred()) { return NULL; } } for (size_t i = 0; i < c->NumStaticFields(); ++i) { Field* f = c->GetStaticField(i); if (IsVisibleField(f, publicOnly)) { fields.push_back(f); } if (env->ExceptionOccurred()) { return NULL; } } return ToArray(env, "java/lang/reflect/Field", fields); } bool IsVisibleMethod(Method* m, bool public_only) { if (public_only && !m->IsPublic()) { return false; } if (m->IsConstructor()) { return false; } return true; } jobjectArray Class_getDeclaredMethods(JNIEnv* env, jclass javaClass, jboolean publicOnly) { Class* c = Decode(env, javaClass); std::vector methods; for (size_t i = 0; i < c->NumVirtualMethods(); ++i) { Method* m = c->GetVirtualMethod(i); if (IsVisibleMethod(m, publicOnly)) { methods.push_back(m); } if (env->ExceptionOccurred()) { return NULL; } } for (size_t i = 0; i < c->NumDirectMethods(); ++i) { Method* m = c->GetDirectMethod(i); if (IsVisibleMethod(m, publicOnly)) { methods.push_back(m); } if (env->ExceptionOccurred()) { return NULL; } } return ToArray(env, "java/lang/reflect/Method", methods); } jboolean Class_desiredAssertionStatus(JNIEnv* env, jobject javaThis) { return JNI_FALSE; } jobject Class_getDex(JNIEnv* env, jobject javaClass) { Class* c = Decode(env, javaClass); DexCache* dex_cache = c->GetDexCache(); if (dex_cache == NULL) { return NULL; } return Runtime::Current()->GetClassLinker()->FindDexFile(dex_cache).GetDexObject(env); } jint Class_getNonInnerClassModifiers(JNIEnv* env, jclass javaClass) { Class* c = Decode(env, javaClass); return c->GetAccessFlags() & kAccJavaFlagsMask; } jobject Class_getClassLoaderNative(JNIEnv* env, jclass javaClass) { Class* c = Decode(env, javaClass); Object* result = c->GetClassLoader(); return AddLocalReference(env, result); } jclass Class_getComponentType(JNIEnv* env, jclass javaClass) { return AddLocalReference(env, Decode(env, javaClass)->GetComponentType()); } bool MethodMatches(MethodHelper* mh, const std::string& name, ObjectArray* arg_array) { if (name != mh->GetName()) { return false; } const DexFile::TypeList* m_type_list = mh->GetParameterTypeList(); uint32_t m_type_list_size = m_type_list == NULL ? 0 : m_type_list->Size(); uint32_t sig_length = arg_array->GetLength(); if (m_type_list_size != sig_length) { return false; } for (uint32_t i = 0; i < sig_length; i++) { if (mh->GetClassFromTypeIdx(m_type_list->GetTypeItem(i).type_idx_) != arg_array->Get(i)) { return false; } } return true; } Method* FindConstructorOrMethodInArray(ObjectArray* methods, const std::string& name, ObjectArray* arg_array) { if (methods == NULL) { return NULL; } Method* result = NULL; MethodHelper mh; for (int32_t i = 0; i < methods->GetLength(); ++i) { Method* method = methods->Get(i); mh.ChangeMethod(method); if (method->IsMiranda() || !MethodMatches(&mh, name, arg_array)) { continue; } result = method; // Covariant return types permit the class to define multiple // methods with the same name and parameter types. Prefer to return // a non-synthetic method in such situations. We may still return // a synthetic method to handle situations like escalated visibility. if (!method->IsSynthetic()) { break; } } return result; } jobject Class_getDeclaredConstructorOrMethod(JNIEnv* env, jclass javaClass, jstring javaName, jobjectArray javaArgs) { Class* c = Decode(env, javaClass); std::string name = Decode(env, javaName)->ToModifiedUtf8(); ObjectArray* arg_array = Decode*>(env, javaArgs); Method* m = FindConstructorOrMethodInArray(c->GetDirectMethods(), name, arg_array); if (m == NULL) { m = FindConstructorOrMethodInArray(c->GetVirtualMethods(), name, arg_array); } if (m != NULL) { return AddLocalReference(env, m); } else { return NULL; } } jobject Class_getDeclaredFieldNative(JNIEnv* env, jclass jklass, jobject jname) { Class* klass = Decode(env, jklass); DCHECK(klass->IsClass()); String* name = Decode(env, jname); DCHECK(name->GetClass()->IsStringClass()); FieldHelper fh; for (size_t i = 0; i < klass->NumInstanceFields(); ++i) { Field* f = klass->GetInstanceField(i); fh.ChangeField(f); if (name->Equals(fh.GetName())) { return AddLocalReference(env, f); } } for (size_t i = 0; i < klass->NumStaticFields(); ++i) { Field* f = klass->GetStaticField(i); fh.ChangeField(f); if (name->Equals(fh.GetName())) { return AddLocalReference(env, f); } } return NULL; } /* * private native String getNameNative() * * Return the class' name. The exact format is bizarre, but it's the specified * behavior: keywords for primitive types, regular "[I" form for primitive * arrays (so "int" but "[I"), and arrays of reference types written * between "L" and ";" but with dots rather than slashes (so "java.lang.String" * but "[Ljava.lang.String;"). Madness. */ jstring Class_getNameNative(JNIEnv* env, jobject javaThis) { Class* c = Decode(env, javaThis); std::string descriptor(ClassHelper(c).GetDescriptor()); if ((descriptor[0] != 'L') && (descriptor[0] != '[')) { // The descriptor indicates that this is the class for // a primitive type; special-case the return value. const char* name = NULL; switch (descriptor[0]) { case 'Z': name = "boolean"; break; case 'B': name = "byte"; break; case 'C': name = "char"; break; case 'S': name = "short"; break; case 'I': name = "int"; break; case 'J': name = "long"; break; case 'F': name = "float"; break; case 'D': name = "double"; break; case 'V': name = "void"; break; default: LOG(FATAL) << "Unknown primitive type: " << PrintableChar(descriptor[0]); } return env->NewStringUTF(name); } // Convert the UTF-8 name to a java.lang.String. The // name must use '.' to separate package components. if (descriptor.size() > 2 && descriptor[0] == 'L' && descriptor[descriptor.size() - 1] == ';') { descriptor.erase(0, 1); descriptor.erase(descriptor.size() - 1); } std::replace(descriptor.begin(), descriptor.end(), '/', '.'); return env->NewStringUTF(descriptor.c_str()); } jclass Class_getSuperclass(JNIEnv* env, jobject javaThis) { Class* c = Decode(env, javaThis); Class* result = c->GetSuperClass(); return AddLocalReference(env, result); } jboolean Class_isAssignableFrom(JNIEnv* env, jobject javaLhs, jclass javaRhs) { ScopedThreadStateChange tsc(Thread::Current(), Thread::kRunnable); Class* lhs = Decode(env, javaLhs); Class* rhs = Decode(env, javaRhs); if (rhs == NULL) { Thread::Current()->ThrowNewException("Ljava/lang/NullPointerException;", "class == null"); return JNI_FALSE; } return lhs->IsAssignableFrom(rhs) ? JNI_TRUE : JNI_FALSE; } jboolean Class_isInstance(JNIEnv* env, jobject javaClass, jobject javaObject) { Class* c = Decode(env, javaClass); Object* o = Decode(env, javaObject); if (o == NULL) { return JNI_FALSE; } return o->InstanceOf(c) ? JNI_TRUE : JNI_FALSE; } jboolean Class_isInterface(JNIEnv* env, jobject javaThis) { Class* c = Decode(env, javaThis); return c->IsInterface(); } jboolean Class_isPrimitive(JNIEnv* env, jobject javaThis) { Class* c = Decode(env, javaThis); return c->IsPrimitive(); } // Validate method/field access. bool CheckMemberAccess(const Class* access_from, Class* access_to, uint32_t member_flags) { // quick accept for public access */ if (member_flags & kAccPublic) { return true; } // quick accept for access from same class if (access_from == access_to) { return true; } // quick reject for private access from another class if (member_flags & kAccPrivate) { return false; } // Semi-quick test for protected access from a sub-class, which may or // may not be in the same package. if (member_flags & kAccProtected) { if (access_from->IsSubClass(access_to)) { return true; } } // Allow protected and private access from other classes in the same return access_from->IsInSamePackage(access_to); } jobject Class_newInstanceImpl(JNIEnv* env, jobject javaThis) { ScopedThreadStateChange tsc(Thread::Current(), Thread::kRunnable); Class* c = Decode(env, javaThis); if (c->IsPrimitive() || c->IsInterface() || c->IsArrayClass() || c->IsAbstract()) { Thread::Current()->ThrowNewExceptionF("Ljava/lang/InstantiationException;", "Class %s can not be instantiated", PrettyDescriptor(ClassHelper(c).GetDescriptor()).c_str()); return NULL; } if (!Runtime::Current()->GetClassLinker()->EnsureInitialized(c, true)) { return NULL; } Method* init = c->FindDirectMethod("", "()V"); if (init == NULL) { Thread::Current()->ThrowNewExceptionF("Ljava/lang/InstantiationException;", "Class %s has no default ()V constructor", PrettyDescriptor(ClassHelper(c).GetDescriptor()).c_str()); return NULL; } // Verify access from the call site. // // First, make sure the method invoking Class.newInstance() has permission // to access the class. // // Second, make sure it has permission to invoke the constructor. The // constructor must be public or, if the caller is in the same package, // have package scope. // TODO: need SmartFrame (Thread::WalkStack-like iterator). Frame frame = Thread::Current()->GetTopOfStack(); frame.Next(); frame.Next(); Method* caller_caller = frame.GetMethod(); Class* caller_class = caller_caller->GetDeclaringClass(); ClassHelper caller_ch(caller_class); if (!caller_class->CanAccess(c)) { Thread::Current()->ThrowNewExceptionF("Ljava/lang/IllegalAccessException;", "Class %s is not accessible from class %s", PrettyDescriptor(ClassHelper(c).GetDescriptor()).c_str(), PrettyDescriptor(caller_ch.GetDescriptor()).c_str()); return NULL; } if (!CheckMemberAccess(caller_class, init->GetDeclaringClass(), init->GetAccessFlags())) { Thread::Current()->ThrowNewExceptionF("Ljava/lang/IllegalAccessException;", "%s is not accessible from class %s", PrettyMethod(init).c_str(), PrettyDescriptor(caller_ch.GetDescriptor()).c_str()); return NULL; } Object* new_obj = c->AllocObject(); if (new_obj == NULL) { DCHECK(Thread::Current()->IsExceptionPending()); return NULL; } // invoke constructor; unlike reflection calls, we don't wrap exceptions jclass jklass = AddLocalReference(env, c); jmethodID mid = EncodeMethod(init); return env->NewObject(jklass, mid); } static JNINativeMethod gMethods[] = { NATIVE_METHOD(Class, classForName, "(Ljava/lang/String;ZLjava/lang/ClassLoader;)Ljava/lang/Class;"), NATIVE_METHOD(Class, desiredAssertionStatus, "()Z"), NATIVE_METHOD(Class, getAnnotationDirectoryOffset, "()I"), NATIVE_METHOD(Class, getClassLoaderNative, "()Ljava/lang/ClassLoader;"), NATIVE_METHOD(Class, getComponentType, "()Ljava/lang/Class;"), NATIVE_METHOD(Class, getDeclaredConstructorOrMethod, "(Ljava/lang/String;[Ljava/lang/Class;)Ljava/lang/reflect/Member;"), NATIVE_METHOD(Class, getDeclaredConstructors, "(Z)[Ljava/lang/reflect/Constructor;"), NATIVE_METHOD(Class, getDeclaredFieldNative, "(Ljava/lang/String;)Ljava/lang/reflect/Field;"), NATIVE_METHOD(Class, getDeclaredFields, "(Z)[Ljava/lang/reflect/Field;"), NATIVE_METHOD(Class, getDeclaredMethods, "(Z)[Ljava/lang/reflect/Method;"), NATIVE_METHOD(Class, getDex, "()Lcom/android/dex/Dex;"), NATIVE_METHOD(Class, getNonInnerClassModifiers, "()I"), NATIVE_METHOD(Class, getNameNative, "()Ljava/lang/String;"), NATIVE_METHOD(Class, getSuperclass, "()Ljava/lang/Class;"), NATIVE_METHOD(Class, isAssignableFrom, "(Ljava/lang/Class;)Z"), NATIVE_METHOD(Class, isInstance, "(Ljava/lang/Object;)Z"), NATIVE_METHOD(Class, isInterface, "()Z"), NATIVE_METHOD(Class, isPrimitive, "()Z"), NATIVE_METHOD(Class, newInstanceImpl, "()Ljava/lang/Object;"), }; } // namespace void register_java_lang_Class(JNIEnv* env) { jniRegisterNativeMethods(env, "java/lang/Class", gMethods, NELEM(gMethods)); } } // namespace art