com.chemaxon.descriptors.common.reflect

Class Reflect

java.lang.Object

com.chemaxon.descriptors.common.reflect.Reflect

public final class Reflect
extends Object

Reflection based utilities for the descriptors package.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Reflect.MetricFactory Name of metric factory method to use.
static interface	Reflect.Proxied Can provide proxied implementation.

Method Summary

Modifier and Type	Method and Description
static <MI extends IF,AI extends IF,IF> MI	asInstanceOf(Class<MI> markerInterface, AI implementation) Hide actual implementation and type parameters by proxying to a marker interface.
static <R extends B,B extends Descriptor,T extends Serializable,G extends DescriptorGenerator<B>,C extends DescriptorComparator<B>> G	createSweetenedGenerator(Object guardObject, Class<G> generatorClass, Class<C> comparatorClass, Function<Molecule,R> generateFunction, String generatorToString, Function bareRetrieverFunction, DescriptorSerializer<B> descriptorSerializer, ComparisonContextFactory<DescriptorComparator<B>,B,T> comparisonContextFactory, DescriptorParameters descriptorParameters) Put together a type system sweetened DescriptorGenerator proxy from its components.
static <DC extends DescriptorComparator<D>,D extends Descriptor> DC	descriptorComparatorWithOtherContext(DC base, UnguardedContext<D,?> context) Delegate a DescriptorComparator with a new UnguardedContext.
static void	ensureSerializable(Object o) Ensure that serializable.
static void	ensureSerializable(String name, Object o) Ensure that serializable.
static Function<Object,Object>	getBaseWhenProxied() Get base object for a proxied.
static <T> T	throwingUnsupportedOperationException(Class<T> type, String message) Proxy throwing UnsupportedOperationException for all invocations.
static <T extends Guarded> T	throwingUnsupportedOperationExceptionGuarded(Class<T> type, Object guardObject, String message) Proxy throwing UnsupportedOperationException for all invocations except guard object check.

Methods inherited from class java.lang.Object

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

Method Detail

descriptorComparatorWithOtherContext

public static <DC extends DescriptorComparator<D>,D extends Descriptor> DC descriptorComparatorWithOtherContext(DC base,
                                                                                                                UnguardedContext<D,?> context)

Delegate a DescriptorComparator with a new UnguardedContext.

Type Parameters:

DC - Exposed DescriptorComparator

D - Descriptor bare type

Parameters:

base - Comparator to delegate

context - Replacement context

Returns:

Proxy with replacement

throwingUnsupportedOperationException

public static <T> T throwingUnsupportedOperationException(Class<T> type,
                                                          String message)

Proxy throwing UnsupportedOperationException for all invocations.

Type Parameters:

T - Type to implement

Parameters:

type - Type to implement

message - Message for the exception

Returns:

Proxy instance

throwingUnsupportedOperationExceptionGuarded

public static <T extends Guarded> T throwingUnsupportedOperationExceptionGuarded(Class<T> type,
                                                                                 Object guardObject,
                                                                                 String message)

Proxy throwing UnsupportedOperationException for all invocations except guard object check.

Type Parameters:

T - Type to implement

Parameters:

type - Type to implement

guardObject - Guard object to return

message - Message for the exception

Returns:

Proxy instance

asInstanceOf

public static <MI extends IF,AI extends IF,IF> MI asInstanceOf(Class<MI> markerInterface,
                                                               AI implementation)

Hide actual implementation and type parameters by proxying to a marker interface.

Type Parameters:

IF - A common base interface

AI - An actual implementation of the base interface

MI - A marker interface hiding the common interface

Parameters:

markerInterface - marker interface type

implementation - Actual implementation to proxy

Returns:

Proxy for the actual implementation. Interface Reflect.Proxied is also implemented and its Reflect.Proxied.getProxiedImplementation() returns the implementation object

getBaseWhenProxied

public static Function<Object,Object> getBaseWhenProxied()

Get base object for a proxied.

Returns:

Getter function

createSweetenedGenerator

public static <R extends B,B extends Descriptor,T extends Serializable,G extends DescriptorGenerator<B>,C extends DescriptorComparator<B>> G createSweetenedGenerator(Object guardObject,
                                                                                                                                                                      Class<G> generatorClass,
                                                                                                                                                                      Class<C> comparatorClass,
                                                                                                                                                                      Function<Molecule,R> generateFunction,
                                                                                                                                                                      String generatorToString,
                                                                                                                                                                      Function bareRetrieverFunction,
                                                                                                                                                                      DescriptorSerializer<B> descriptorSerializer,
                                                                                                                                                                      ComparisonContextFactory<DescriptorComparator<B>,B,T> comparisonContextFactory,
                                                                                                                                                                      DescriptorParameters descriptorParameters)

Put together a type system sweetened DescriptorGenerator proxy from its components.

Type Parameters:

R - Rich form of generated descriptors

B - Bare form of generated descriptors

T - Unguarded form exposed by the comparison context factory

G - Type system sweetened DescriptorGenerator

C - Type system sweetened DescriptorComparator

Parameters:

guardObject - Associated guard object

generatorClass - Type system sweetened generator type to return.

comparatorClass - Type system sweetened comparator type to return. Comparator factory methods of the generator will return proxies of the comparator class

generateFunction - Generator for the rich form, method DescriptorGenerator.generateDescriptor(chemaxon.struc.Molecule) will delegate to this function

generatorToString - String representation of the generator, method toString() will return the given String

bareRetrieverFunction - Function to retrieve bare form. Note that guard object check is ensured by the proxy. Method DescriptorGenerator.getBareDescriptor(com.chemaxon.descriptors.common.Descriptor) will delegate

descriptorSerializer - Serializer to expose.

comparisonContextFactory - Comparison context to expose by DescriptorGenerator.comparisonContextFactory(). Will also be used for comparator factory methods.

descriptorParameters - Parameters object to return by DescriptorGenerator.getParameters()

Returns:

Composed Descriptor

ensureSerializable

public static void ensureSerializable(Object o)

Ensure that serializable.

Parameters:

o - Object to check

Throws:

IllegalArgumentException - when not serializable

ensureSerializable

public static void ensureSerializable(String name,
                                      Object o)

Ensure that serializable.

Parameters:

name - Name to display in exception message

o - Object to check

Throws:

IllegalArgumentException - when not serializable