gololang

Class AdapterFabric

java.lang.Object

gololang.AdapterFabric

public final class AdapterFabric
extends java.lang.Object

An adapter fabric can provide instance makers of adapter objects defined at runtime.

An adapter object inherits from a parent class or java.lang.Object, implements a set of specified interfaces, and provides method implementation / overrides defined by Golo closures.

Adapter instance makers are created based on a configuration that is defined by a simple collections-based representation where the root is a java.util.Map instance with keys:

• extends: a string for the parent class, java.lang.Object if not specified,
• interfaces: a java.lang.Iterable of strings specifying which interfaces to implement,
• implements: points to a map where keys are strings of method names to implement, and values are the implementation closures,
• overrides: same as a implements to provides overrides.

The signature for closures is as follows:

• implementations: |receiver, argument1, argument2| (and so on),
• overrides: |handle_in_superclass, receiver, argument1, argument2| (and so on).

Star implementations or overrides can also be provided, in which case any unimplemented or not overridden method is dispatched to the provided closure. Note that both a star implementation and a star override cannot be defined. The signatures are as follows.

• *-implementation: |method_name, arguments_array|,
• *-overrides: |handle_in_superclass, method_name, arguments_array|.

It is important to note that adapters are useful for interoperability with 3rd-party Java code, as that allow passing adequate objects from Golo to such libraries. Their usage for pure Golo code is discouraged.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AdapterFabric.Maker An adapter maker can produce instances of Golo adapter objects.

Constructor Summary

Constructors

Constructor and Description
AdapterFabric() Makes an adapter fabric whose parent is the current thread context classloader.
AdapterFabric(java.lang.ClassLoader classLoader) Makes an adapter fabric using a classloader.

Method Summary

Modifier and Type	Method and Description
AdapterFabric.Maker	maker(java.util.Map<java.lang.String,java.lang.Object> configuration) Provides an instance maker based on an adapter definition.
static AdapterFabric	withParentClassLoader(java.lang.ClassLoader parentClassLoader) Makes an adapter fabric whose parent classloader is provided.

Methods inherited from class java.lang.Object

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

Constructor Detail

AdapterFabric

public AdapterFabric(java.lang.ClassLoader classLoader)

Makes an adapter fabric using a classloader.

Parameters:

classLoader - the classloader to use.

AdapterFabric

public AdapterFabric()

Makes an adapter fabric whose parent is the current thread context classloader.

Method Detail

withParentClassLoader

public static AdapterFabric withParentClassLoader(java.lang.ClassLoader parentClassLoader)

Makes an adapter fabric whose parent classloader is provided.

Parameters:

parentClassLoader - the parent classloader.

Returns:

an adapter fabric.

maker

public AdapterFabric.Maker maker(java.util.Map<java.lang.String,java.lang.Object> configuration)

Provides an instance maker based on an adapter definition.

Parameters:

configuration - the adapter configuration.

Returns:

an adapter maker for that configuration.