NativeConstructorAccessorImpl.java

/*
 * Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package jdk.internal.reflect;

import java.lang.reflect.*;
import sun.reflect.misc.ReflectUtil;

/**
 * Used only for the first few invocations of a Constructor;
 * afterward, switches to bytecode-based implementation
 */
/*
 * 基于JNI的构造器访问器。
 * 仅用于反射操作的前几次调用，之后，切换到基于字节码(纯Java)的实现。
 */
class NativeConstructorAccessorImpl extends ConstructorAccessorImpl {
    private final Constructor<?> constructor;           // 待访问构造器
    private DelegatingConstructorAccessorImpl parent;   // 当前类的代理
    private int numInvocations;                         // 记录待访问构造器被反射调用的次数
    
    NativeConstructorAccessorImpl(Constructor<?> constructor) {
        this.constructor = constructor;
    }
    
    public Object newInstance(Object[] args) throws InstantiationException, IllegalArgumentException, InvocationTargetException {
        // 获取当前待访问构造器constructor被基于JNI的反射调用的次数
        int threshold = ReflectionFactory.inflationThreshold();
        
        /*
         * We can't inflate a constructor belonging to a vm-anonymous class because that kind of class can't be referred to by name,
         * hence can't be found from the generated bytecode.
         *
         * 如果当前待访问构造器被反射调用的次数已经超过指定的阈值，且该构造器所在的类不是虚拟机匿名类(这与Java语言中的匿名内部类不同)，
         * 此时需要从基于JNI的反射调用切换为基于纯Java的反射调用
         */
        if(++numInvocations>threshold && !ReflectUtil.isVMAnonymousClass(constructor.getDeclaringClass())) {
            MethodAccessorGenerator accessor = new MethodAccessorGenerator();
            ConstructorAccessorImpl acc = (ConstructorAccessorImpl) accessor.generateConstructor(constructor.getDeclaringClass(), constructor.getParameterTypes(), constructor.getExceptionTypes(), constructor.getModifiers());
            
            // 将代理中被代理的访问器更新为基于纯Java的构造器访问器，下次从代理中发起调用时，就不会再使用当前基于JNI的构造器访问器了
            parent.setDelegate(acc);
        }
        
        // 继续使用基于JNI的反射调用
        return newInstance0(constructor, args);
    }
    
    void setParent(DelegatingConstructorAccessorImpl parent) {
        this.parent = parent;
    }
    
    // 基于JNI的反射构造器调用
    private static native Object newInstance0(Constructor<?> c, Object[] args) throws InstantiationException, IllegalArgumentException, InvocationTargetException;
}