Java tutorial
/* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch licenses this file to you 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 org.elasticsearch.painless; import org.apache.lucene.search.Scorer; import org.elasticsearch.search.lookup.LeafDocLookup; import org.objectweb.asm.Handle; import org.objectweb.asm.Opcodes; import org.objectweb.asm.Type; import org.objectweb.asm.commons.Method; import java.lang.invoke.CallSite; import java.lang.invoke.LambdaMetafactory; import java.lang.invoke.MethodHandle; import java.lang.invoke.MethodHandles; import java.lang.invoke.MethodType; import java.util.BitSet; import java.util.Iterator; import java.util.Map; import java.util.Objects; import java.util.regex.Matcher; import java.util.regex.Pattern; /** * General pool of constants used during the writing phase of compilation. */ public final class WriterConstants { public static final int CLASS_VERSION = Opcodes.V1_8; public static final int ASM_VERSION = Opcodes.ASM5; public static final String BASE_CLASS_NAME = Executable.class.getName(); public static final Type BASE_CLASS_TYPE = Type.getType(Executable.class); public static final String CLASS_NAME = BASE_CLASS_NAME + "$Script"; public static final Type CLASS_TYPE = Type.getObjectType(CLASS_NAME.replace('.', '/')); public static final Method CONSTRUCTOR = getAsmMethod(void.class, "<init>", String.class, String.class, BitSet.class); public static final Method CLINIT = getAsmMethod(void.class, "<clinit>"); public static final Method EXECUTE = getAsmMethod(Object.class, "execute", Map.class, Scorer.class, LeafDocLookup.class, Object.class); public static final Type PAINLESS_ERROR_TYPE = Type.getType(PainlessError.class); public static final Type NEEDS_SCORE_TYPE = Type.getType(NeedsScore.class); public static final Type SCORER_TYPE = Type.getType(Scorer.class); public static final Method SCORER_SCORE = getAsmMethod(float.class, "score"); public static final Type MAP_TYPE = Type.getType(Map.class); public static final Method MAP_GET = getAsmMethod(Object.class, "get", Object.class); public static final Type ITERATOR_TYPE = Type.getType(Iterator.class); public static final Method ITERATOR_HASNEXT = getAsmMethod(boolean.class, "hasNext"); public static final Method ITERATOR_NEXT = getAsmMethod(Object.class, "next"); public static final Type UTILITY_TYPE = Type.getType(Utility.class); public static final Method STRING_TO_CHAR = getAsmMethod(char.class, "StringTochar", String.class); public static final Method CHAR_TO_STRING = getAsmMethod(String.class, "charToString", char.class); public static final Type METHOD_HANDLE_TYPE = Type.getType(MethodHandle.class); public static final Type AUGMENTATION_TYPE = Type.getType(Augmentation.class); /** * A Method instance for {@linkplain Pattern#compile}. This isn't available from Definition because we intentionally don't add it there * so that the script can't create regexes without this syntax. Essentially, our static regex syntax has a monopoly on building regexes * because it can do it statically. This is both faster and prevents the script from doing something super slow like building a regex * per time it is run. */ public static final Method PATTERN_COMPILE = getAsmMethod(Pattern.class, "compile", String.class, int.class); public static final Method PATTERN_MATCHER = getAsmMethod(Matcher.class, "matcher", CharSequence.class); public static final Method MATCHER_MATCHES = getAsmMethod(boolean.class, "matches"); public static final Method MATCHER_FIND = getAsmMethod(boolean.class, "find"); /** dynamic callsite bootstrap signature */ static final MethodType DEF_BOOTSTRAP_TYPE = MethodType.methodType(CallSite.class, MethodHandles.Lookup.class, String.class, MethodType.class, int.class, int.class, Object[].class); static final Handle DEF_BOOTSTRAP_HANDLE = new Handle(Opcodes.H_INVOKESTATIC, Type.getInternalName(DefBootstrap.class), "bootstrap", DEF_BOOTSTRAP_TYPE.toMethodDescriptorString(), false); public static final Type DEF_UTIL_TYPE = Type.getType(Def.class); public static final Method DEF_TO_BOOLEAN = getAsmMethod(boolean.class, "DefToboolean", Object.class); public static final Method DEF_TO_BYTE_IMPLICIT = getAsmMethod(byte.class, "DefTobyteImplicit", Object.class); public static final Method DEF_TO_SHORT_IMPLICIT = getAsmMethod(short.class, "DefToshortImplicit", Object.class); public static final Method DEF_TO_CHAR_IMPLICIT = getAsmMethod(char.class, "DefTocharImplicit", Object.class); public static final Method DEF_TO_INT_IMPLICIT = getAsmMethod(int.class, "DefTointImplicit", Object.class); public static final Method DEF_TO_LONG_IMPLICIT = getAsmMethod(long.class, "DefTolongImplicit", Object.class); public static final Method DEF_TO_FLOAT_IMPLICIT = getAsmMethod(float.class, "DefTofloatImplicit", Object.class); public static final Method DEF_TO_DOUBLE_IMPLICIT = getAsmMethod(double.class, "DefTodoubleImplicit", Object.class); public static final Method DEF_TO_BYTE_EXPLICIT = getAsmMethod(byte.class, "DefTobyteExplicit", Object.class); public static final Method DEF_TO_SHORT_EXPLICIT = getAsmMethod(short.class, "DefToshortExplicit", Object.class); public static final Method DEF_TO_CHAR_EXPLICIT = getAsmMethod(char.class, "DefTocharExplicit", Object.class); public static final Method DEF_TO_INT_EXPLICIT = getAsmMethod(int.class, "DefTointExplicit", Object.class); public static final Method DEF_TO_LONG_EXPLICIT = getAsmMethod(long.class, "DefTolongExplicit", Object.class); public static final Method DEF_TO_FLOAT_EXPLICIT = getAsmMethod(float.class, "DefTofloatExplicit", Object.class); public static final Method DEF_TO_DOUBLE_EXPLICIT = getAsmMethod(double.class, "DefTodoubleExplicit", Object.class); /** invokedynamic bootstrap for lambda expression/method references */ public static final MethodType LAMBDA_BOOTSTRAP_TYPE = MethodType.methodType(CallSite.class, MethodHandles.Lookup.class, String.class, MethodType.class, Object[].class); public static final Handle LAMBDA_BOOTSTRAP_HANDLE = new Handle(Opcodes.H_INVOKESTATIC, Type.getInternalName(LambdaMetafactory.class), "altMetafactory", LAMBDA_BOOTSTRAP_TYPE.toMethodDescriptorString(), false); /** dynamic invokedynamic bootstrap for indy string concats (Java 9+) */ public static final Handle INDY_STRING_CONCAT_BOOTSTRAP_HANDLE; static { Handle bs; try { final Class<?> factory = Class.forName("java.lang.invoke.StringConcatFactory"); final String methodName = "makeConcat"; final MethodType type = MethodType.methodType(CallSite.class, MethodHandles.Lookup.class, String.class, MethodType.class); // ensure it is there: MethodHandles.publicLookup().findStatic(factory, methodName, type); bs = new Handle(Opcodes.H_INVOKESTATIC, Type.getInternalName(factory), methodName, type.toMethodDescriptorString(), false); } catch (ReflectiveOperationException e) { // not Java 9 - we set it null, so MethodWriter uses StringBuilder: bs = null; } INDY_STRING_CONCAT_BOOTSTRAP_HANDLE = bs; } public static final int MAX_INDY_STRING_CONCAT_ARGS = 200; public static final Type STRING_TYPE = Type.getType(String.class); public static final Type STRINGBUILDER_TYPE = Type.getType(StringBuilder.class); public static final Method STRINGBUILDER_CONSTRUCTOR = getAsmMethod(void.class, "<init>"); public static final Method STRINGBUILDER_APPEND_BOOLEAN = getAsmMethod(StringBuilder.class, "append", boolean.class); public static final Method STRINGBUILDER_APPEND_CHAR = getAsmMethod(StringBuilder.class, "append", char.class); public static final Method STRINGBUILDER_APPEND_INT = getAsmMethod(StringBuilder.class, "append", int.class); public static final Method STRINGBUILDER_APPEND_LONG = getAsmMethod(StringBuilder.class, "append", long.class); public static final Method STRINGBUILDER_APPEND_FLOAT = getAsmMethod(StringBuilder.class, "append", float.class); public static final Method STRINGBUILDER_APPEND_DOUBLE = getAsmMethod(StringBuilder.class, "append", double.class); public static final Method STRINGBUILDER_APPEND_STRING = getAsmMethod(StringBuilder.class, "append", String.class); public static final Method STRINGBUILDER_APPEND_OBJECT = getAsmMethod(StringBuilder.class, "append", Object.class); public static final Method STRINGBUILDER_TOSTRING = getAsmMethod(String.class, "toString"); public static final Type OBJECTS_TYPE = Type.getType(Objects.class); public static final Method EQUALS = getAsmMethod(boolean.class, "equals", Object.class, Object.class); private static Method getAsmMethod(final Class<?> rtype, final String name, final Class<?>... ptypes) { return new Method(name, MethodType.methodType(rtype, ptypes).toMethodDescriptorString()); } private WriterConstants() { } }