net.bytebuddy.utility

Class JavaModule

java.lang.Object

net.bytebuddy.utility.JavaModule

All Implemented Interfaces:

NamedElement, NamedElement.WithOptionalName

public class JavaModule
extends Object
implements NamedElement.WithOptionalName

Type-safe representation of a java.lang.reflect.Module. On platforms that do not support the module API, modules are represented by null.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	JavaModule.Dispatcher A dispatcher for accessing the java.lang.reflect.Module API if it is available on the current VM.

Nested classes/interfaces inherited from interface net.bytebuddy.description.NamedElement

NamedElement.WithGenericName, NamedElement.WithOptionalName, NamedElement.WithRuntimeName

Field Summary

Fields

Modifier and Type	Field and Description
static JavaModule	UNSUPPORTED Canonical representation of a Java module on a JVM that does not support the module API.

Fields inherited from interface net.bytebuddy.description.NamedElement

EMPTY_NAME, NO_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JavaModule(Object module) Creates a new Java module representation.

Method Summary

Modifier and Type	Method and Description
void	addReads(Instrumentation instrumentation, JavaModule module) Adds a read-edge to this module to the supplied module using the instrumentation API.
boolean	canRead(JavaModule module) Checks if this module can read the exported packages of the supplied module.
boolean	equals(Object object)
String	getActualName() Returns the name of this element as it is found in the source code.
ClassLoader	getClassLoader() Returns the class loader of this module.
InputStream	getResourceAsStream(String name) Returns a resource stream for this module for a resource of the given name or null if such a resource does not exist.
int	hashCode()
boolean	isNamed() Returns true if this element has an explicit name.
static boolean	isSupported() Checks if the current VM supports the java.lang.reflect.Module API.
static JavaModule	of(Object module) Represents the supplied java.lang.reflect.Module as an instance of this class and validates that the supplied instance really represents a Java Module.
static JavaModule	ofType(Class<?> type) Returns a representation of the supplied type's java.lang.reflect.Module or null if the current VM does not support modules.
String	toString()
Object	unwrap() Unwraps this instance to a java.lang.reflect.Module.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

UNSUPPORTED

public static final JavaModule UNSUPPORTED

Canonical representation of a Java module on a JVM that does not support the module API.

Constructor Detail

JavaModule

protected JavaModule(Object module)

Creates a new Java module representation.

Parameters:

module - The java.lang.reflect.Module instance this wrapper represents.

Method Detail

ofType

public static JavaModule ofType(Class<?> type)

Returns a representation of the supplied type's java.lang.reflect.Module or null if the current VM does not support modules.

Parameters:

type - The type for which to describe the module.

Returns:

A representation of the type's module or null if the current VM does not support modules.

of

public static JavaModule of(Object module)

Represents the supplied java.lang.reflect.Module as an instance of this class and validates that the supplied instance really represents a Java Module.

Parameters:

module - The module to represent.

Returns:

A representation of the supplied Java module.

isSupported

public static boolean isSupported()

Checks if the current VM supports the java.lang.reflect.Module API.

Returns:

true if the current VM supports modules.

isNamed

public boolean isNamed()

Description copied from interface: NamedElement.WithOptionalName

Returns true if this element has an explicit name.

Specified by:

isNamed in interface NamedElement.WithOptionalName

Returns:

true if this element has an explicit name.

getActualName

public String getActualName()

Description copied from interface: NamedElement

Returns the name of this element as it is found in the source code. If no such name exists, an empty string is returned.

Specified by:

getActualName in interface NamedElement

Returns:

The name of this element as given in a Java program's source code.

getResourceAsStream

public InputStream getResourceAsStream(String name)

Returns a resource stream for this module for a resource of the given name or null if such a resource does not exist.

Parameters:

name - The name of the resource.

Returns:

An input stream for the resource or null if it does not exist.

getClassLoader

public ClassLoader getClassLoader()

Returns the class loader of this module.

Returns:

The class loader of the represented module.

unwrap

public Object unwrap()

Unwraps this instance to a java.lang.reflect.Module.

Returns:

The represented java.lang.reflect.Module.

canRead

public boolean canRead(JavaModule module)

Checks if this module can read the exported packages of the supplied module.

Parameters:

module - The module to check for its readability by this module.

Returns:

true if this module can read the supplied module.

addReads

public void addReads(Instrumentation instrumentation,
                     JavaModule module)

Adds a read-edge to this module to the supplied module using the instrumentation API.

Parameters:

instrumentation - The instrumentation instance to use for adding the edge.

module - The module to add as a read dependency to this module.

equals

public boolean equals(Object object)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object