org.dynalang.dynalink

Class DefaultBootstrapper

java.lang.Object

org.dynalang.dynalink.DefaultBootstrapper

public class DefaultBootstrapper
extends Object

A convenience default bootstrapper that exposes static bootstrap methods which language runtimes that need the very default behavior can use with minimal setup. When first referenced, it will create a dynamic linker with default settings for the DynamicLinkerFactory, and its bootstrap methods will create MonomorphicCallSite for all call sites. It has two bootstrap methods: one creates call sites that use the MethodHandles.publicLookup() as the lookup for all call sites and disregard the one passed in as the caller, and one that just uses the passed caller as the lookup scope. Using the public lookup one is advised if your language runtime has no concept of interacting with Java visibility scopes, as it results in a more lightweight runtime information.

Author:

Attila Szegedi

Method Summary

Methods

Modifier and Type	Method and Description
static CallSite	bootstrap(MethodHandles.Lookup caller, String name, MethodType type) Use this method as your bootstrap method (see the documentation of the java.lang.invoke package for how to do this).
static CallSite	publicBootstrap(MethodHandles.Lookup caller, String name, MethodType type) Use this method as your bootstrap method (see the documentation of the java.lang.invoke package for how to do this) when your language runtime doesn't have a concept of interaction with Java access scopes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

bootstrap

public static CallSite bootstrap(MethodHandles.Lookup caller,
                 String name,
                 MethodType type)

Use this method as your bootstrap method (see the documentation of the java.lang.invoke package for how to do this). In case your language runtime doesn't have a concept of interaction with Java access scopes, you might want to consider using publicBootstrap(java.lang.invoke.MethodHandles.Lookup, String, MethodType) instead.

Parameters:

caller - the caller's lookup

name - the name of the method at the call site

type - the method signature at the call site

Returns:

a new MonomorphicCallSite linked with the default dynamic linker.

publicBootstrap

public static CallSite publicBootstrap(MethodHandles.Lookup caller,
                       String name,
                       MethodType type)

Use this method as your bootstrap method (see the documentation of the java.lang.invoke package for how to do this) when your language runtime doesn't have a concept of interaction with Java access scopes. If you need to preserve the different caller Lookup objects in the call sites, use bootstrap(java.lang.invoke.MethodHandles.Lookup, String, MethodType) instead

Parameters:

caller - the caller's lookup. It is ignored as the call sites will be created with MethodHandles.publicLookup() instead.

name - the name of the method at the call site

type - the method signature at the call site

Returns:

a new MonomorphicCallSite linked with the default dynamic linker.