Класс StringConcatFactory

public static final int MAX_INDY_CONCAT_ARG_SLOTS

Максимальное количество слотов аргументов в вызове String Concat. Хотя максимальное количество слотов аргументов, которые может обработать вызов indy, равно 253, мы не используем все эти слоты, чтобы позволить стратегиям с комбинаторами MethodHandle использовать некоторые аргументы.

public static CallSite makeConcat(MethodHandles.Lookup lookup, String name, MethodType concatType) throws StringConcatException

Обеспечивает создание оптимизированных методов конкатенации строк, которые могут использоваться для эффективной конкатенации известного числа аргументов известных типов, возможно, после адаптации типов и частичной оценки аргументов. Обычно используется как метод-оболочка для invokedynamic мест вызова, чтобы поддерживать функцию конкатенации строк языка программирования Java.

При вызове целевого метода CallSite, возвращаемого этим методом, он возвращает результат конкатенации строк, принимая все аргументы функции, переданные методу связи, в качестве входных данных для конкатенации. Подпись целевого метода задается concatType. Для целевого метода, принимающего:

• ноль входных данных, конкатенация приводит к пустой строке;
• один входной параметр, конкатенация приводит к единственному входному значению, преобразованному в соответствии с JLS 5.1.11 «Преобразование строки»; в противном случае
• два или более входных данных, входные данные конкатенируются в соответствии с требованиями, изложенными в JLS 15.18.1 «Оператор конкатенации строк +». Входные данные преобразуются в соответствии с JLS 5.1.11 «Преобразование строки» и объединяются слева направо.

Предположим, что аргументы связи следующие:

• concatType, описывающий подпись CallSite

Тогда должны выполняться следующие инварианты связи:

• Количество слотов параметров в concatType меньше или равно 200
• Тип возвращаемого значения в concatType присваивается из String

public static CallSite makeConcatWithConstants(MethodHandles.Lookup lookup, String name, MethodType concatType, String recipe, Object... constants) throws StringConcatException

Обеспечивает создание оптимизированных методов конкатенации строк, которые могут использоваться для эффективной конкатенации известного числа аргументов известных типов, возможно, после адаптации типов и частичной оценки аргументов. Обычно используется как метод-оболочка для invokedynamic мест вызова, чтобы поддерживать функцию конкатенации строк языка программирования Java.

При вызове целевого метода CallSite, возвращаемого этим методом, он возвращает результат конкатенации строк, принимая все аргументы функции и константы, переданные методу связи, в качестве входных данных для конкатенации. Подпись целевого метода задается concatType, и не включает константы. Для целевого метода, принимающего:

• ноль входных данных, конкатенация приводит к пустой строке;
• один входной параметр, конкатенация приводит к единственному входному значению, преобразованному в соответствии с JLS 5.1.11 «Преобразование строки»; в противном случае
• два или более входных данных, входные данные конкатенируются в соответствии с требованиями, изложенными в JLS 15.18.1 «Оператор конкатенации строк +». Входные данные преобразуются в соответствии с JLS 5.1.11 «Преобразование строки» и объединяются слева направо.

Рецепт конкатенации — это строковое описание способа построения конкатенированной строки из аргументов и констант. Рецепт обрабатывается слева направо, и каждый символ представляет вход для конкатенации. Символы рецепта означают:

• \1 (Unicode point 0001): обычный аргумент. Этот вход передается через динамический аргумент и предоставляется при вызове метода конкатенации. Этот вход может быть null.
• \2 (Unicode point 0002): константа. Этот вход передается через статический аргумент оболочки. Эта константа может быть любым значением, представимым в пуле констант. При необходимости фабрика вызовет toString для выполнения одноразового преобразования строки.
• Любое другое значение символа: константа-символ.

Предположим, что аргументы связи следующие:

• concatType, описывающий подпись CallSite
• recipe, описывающий строковый рецепт
• constants, массив аргументов-констант

Тогда должны выполняться следующие инварианты связи:

• Количество слотов параметров в concatType меньше или равно 200
• Количество параметров в concatType равно количеству тегов \1 в recipe
• Тип возвращаемого значения в concatType присваивается из String, и соответствует типу возвращаемого значения MethodHandle
• Количество элементов в constants равно количеству тегов \2 в recipe

public static MethodHandle makeConcatWithTemplate(List<String> fragments, List<Class<?>> ptypes) throws StringConcatException

Упрощенный метод конкатенации для облегчения конкатенации StringTemplate^{ПРЕДПРОСМОТР}. Этот метод возвращает один метод конкатенации, который чередует фрагменты и значения. fragment|value|fragment|value|...|value|fragment. Количество фрагментов должно быть на один больше, чем количество типов ptypes. Общее количество слотов, используемых типами ptypes, должно быть меньше или равно MAX_INDY_CONCAT_ARG_SLOTS^{ПРЕДПРОСМОТР}.

public static List<MethodHandle> makeConcatWithTemplateCluster(List<String> fragments, List<Class<?>> ptypes, int maxSlots) throws StringConcatException

Этот метод разбивает большие конкатенации на отдельные MethodHandles на основе количества слотов, требуемых каждым MethodHandle. Каждый MethodHandle после первого будет иметь дополнительный слот String для результата от предыдущего MethodHandle. makeConcatWithTemplate(java.util.List<java.lang.String>, java.util.List<java.lang.Class<?>>)^{ПРЕДПРОСМОТР} используется для построения MethodHandles. Общее количество слотов, используемых типами ptypes, не ограничено. Однако необходимо учитывать сочетание MethodHandles, чтобы их суммарное количество не превысило 255 слотов.

public static MethodHandle makeConcatWithTemplateGetters(List<String> fragments, List<MethodHandle> getters, int maxSlots) throws StringConcatException

Этот метод создает MethodHandle, ожидающий один вход — получатель предоставленных методов получения. Этот метод использует makeConcatWithTemplateCluster(java.util.List<java.lang.String>, java.util.List<java.lang.Class<?>>, int)^{ПРЕДПРОСМОТР} для создания промежуточного MethodHandles.