/* * Copyright (c) 2018, 2019, 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 java.lang.constant; import java.lang.invoke.MethodHandle; import java.lang.invoke.MethodHandles; import java.lang.invoke.MethodType; import java.util.Objects; import static java.lang.constant.ConstantDescs.CD_void; import static java.lang.constant.ConstantUtils.validateClassOrInterface; import static java.lang.constant.ConstantUtils.validateMemberName; import static java.lang.constant.DirectMethodHandleDesc.Kind.CONSTRUCTOR; import static java.util.Objects.requireNonNull; /** * A nominal descriptor for a direct * {@link MethodHandle}. A {@linkplain DirectMethodHandleDescImpl} corresponds to * a {@code Constant_MethodHandle_info} entry in the constant pool of a classfile. */ final class DirectMethodHandleDescImpl implements DirectMethodHandleDesc { private final Kind kind; private final ClassDesc owner; private final String name; private final MethodTypeDesc invocationType; /** * Constructs a {@linkplain DirectMethodHandleDescImpl} for a method or field * from a kind, owner, name, and type * * @param kind the kind of the method handle * @param owner the declaring class or interface for the method * @param name the unqualified name of the method (ignored if {@code kind} is {@code CONSTRUCTOR}) * @param type the lookup type of the method * @throws NullPointerException if any non-ignored argument is null * @throws IllegalArgumentException if {@code kind} describes a field accessor, * and {@code type} is not consistent with that kind of field accessor, or if * {@code kind} describes a constructor, and the return type of {@code type} * is not {@code void} * @jvms 4.2.2 Unqualified Names */ DirectMethodHandleDescImpl(Kind kind, ClassDesc owner, String name, MethodTypeDesc type) { if (kind == CONSTRUCTOR) name = ""; requireNonNull(kind); validateClassOrInterface(requireNonNull(owner)); validateMemberName(requireNonNull(name), true); requireNonNull(type); switch (kind) { case CONSTRUCTOR: validateConstructor(type); break; case GETTER: validateFieldType(type, false, true); break; case SETTER: validateFieldType(type, true, true); break; case STATIC_GETTER: validateFieldType(type, false, false); break; case STATIC_SETTER: validateFieldType(type, true, false); break; } this.kind = kind; this.owner = owner; this.name = name; if (kind.isVirtualMethod()) this.invocationType = type.insertParameterTypes(0, owner); else if (kind == CONSTRUCTOR) this.invocationType = type.changeReturnType(owner); else this.invocationType = type; } private static void validateFieldType(MethodTypeDesc type, boolean isSetter, boolean isVirtual) { boolean isVoid = type.returnType().descriptorString().equals("V"); int expectedParams = (isSetter ? 1 : 0) + (isVirtual ? 1 : 0); if (isVoid != isSetter || type.parameterCount() != expectedParams || (isVirtual && type.parameterType(0).isPrimitive())) { String expectedType = String.format("(%s%s)%s", (isVirtual ? "R" : ""), (isSetter ? "T" : ""), (isSetter ? "V" : "T")); throw new IllegalArgumentException(String.format("Expected type of %s for getter, found %s", expectedType, type)); } } private static void validateConstructor(MethodTypeDesc type) { if (!type.returnType().descriptorString().equals("V")) { throw new IllegalArgumentException(String.format("Expected type of (T*)V for constructor, found %s", type)); } } @Override public Kind kind() { return kind; } @Override public int refKind() { return kind.refKind; } @Override public boolean isOwnerInterface() { return kind.isInterface; } @Override public ClassDesc owner() { return owner; } @Override public String methodName() { return name; } @Override public MethodTypeDesc invocationType() { return invocationType; } @Override public String lookupDescriptor() { switch (kind) { case VIRTUAL: case SPECIAL: case INTERFACE_VIRTUAL: case INTERFACE_SPECIAL: return invocationType.dropParameterTypes(0, 1).descriptorString(); case STATIC: case INTERFACE_STATIC: return invocationType.descriptorString(); case CONSTRUCTOR: return invocationType.changeReturnType(CD_void).descriptorString(); case GETTER: case STATIC_GETTER: return invocationType.returnType().descriptorString(); case SETTER: return invocationType.parameterType(1).descriptorString(); case STATIC_SETTER: return invocationType.parameterType(0).descriptorString(); default: throw new IllegalStateException(kind.toString()); } } public MethodHandle resolveConstantDesc(MethodHandles.Lookup lookup) throws ReflectiveOperationException { Class resolvedOwner = (Class) owner.resolveConstantDesc(lookup); MethodType invocationType = (MethodType) this.invocationType().resolveConstantDesc(lookup); switch (kind) { case STATIC: case INTERFACE_STATIC: return lookup.findStatic(resolvedOwner, name, invocationType); case INTERFACE_VIRTUAL: case VIRTUAL: return lookup.findVirtual(resolvedOwner, name, invocationType.dropParameterTypes(0, 1)); case SPECIAL: case INTERFACE_SPECIAL: return lookup.findSpecial(resolvedOwner, name, invocationType.dropParameterTypes(0, 1), lookup.lookupClass()); case CONSTRUCTOR: return lookup.findConstructor(resolvedOwner, invocationType.changeReturnType(void.class)); case GETTER: return lookup.findGetter(resolvedOwner, name, invocationType.returnType()); case STATIC_GETTER: return lookup.findStaticGetter(resolvedOwner, name, invocationType.returnType()); case SETTER: return lookup.findSetter(resolvedOwner, name, invocationType.parameterType(1)); case STATIC_SETTER: return lookup.findStaticSetter(resolvedOwner, name, invocationType.parameterType(0)); default: throw new IllegalStateException(kind.name()); } } /** * Returns {@code true} if this {@linkplain DirectMethodHandleDescImpl} is * equal to another {@linkplain DirectMethodHandleDescImpl}. Equality is * determined by the two descriptors having equal kind, owner, name, and type * descriptor. * @param o a {@code DirectMethodHandleDescImpl} to compare to this * {@code DirectMethodHandleDescImpl} * @return {@code true} if the specified {@code DirectMethodHandleDescImpl} is * equal to this {@code DirectMethodHandleDescImpl}. */ @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; DirectMethodHandleDescImpl desc = (DirectMethodHandleDescImpl) o; return kind == desc.kind && Objects.equals(owner, desc.owner) && Objects.equals(name, desc.name) && Objects.equals(invocationType, desc.invocationType); } @Override public int hashCode() { return Objects.hash(kind, owner, name, invocationType); } @Override public String toString() { return String.format("MethodHandleDesc[%s/%s::%s%s]", kind, owner.displayName(), name, invocationType.displayDescriptor()); } }