org.jruby.runtime.load

Class ClassExtensionLibrary

java.lang.Object

org.jruby.runtime.load.ClassExtensionLibrary

All Implemented Interfaces:

Library

public class ClassExtensionLibrary
extends java.lang.Object
implements Library

The ClassExtensionLibrary wraps a class which implements BasicLibraryService, and when asked to load the service, does a basicLoad of the BasicLibraryService. When the time comes to add other loading mechanisms for loading a class, this is the place where they will be added. The load method will check interface you can load a class with, and do the right thing.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	name
private java.lang.Class	theClass

Constructor Summary

Constructors

Constructor and Description
ClassExtensionLibrary(java.lang.String name, java.lang.Class extension)

Method Summary

Modifier and Type	Method and Description
private static void	buildClassName(java.lang.StringBuilder nameBuilder, java.lang.StringBuilder fileBuilder, java.lang.String[] all, int i, java.lang.String serviceName)
private static java.lang.String	buildServiceName(java.lang.String jarName)
java.lang.String	getName()
void	load(Ruby runtime, boolean wrap)
(package private) static ClassExtensionLibrary	tryFind(Ruby runtime, java.lang.String searchName) Try to locate an extension service in the current classloader resources.

Methods inherited from class java.lang.Object

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

Field Detail

theClass

private final java.lang.Class theClass

name

private final java.lang.String name

Constructor Detail

ClassExtensionLibrary

public ClassExtensionLibrary(java.lang.String name,
                             java.lang.Class extension)

Method Detail

tryFind

static ClassExtensionLibrary tryFind(Ruby runtime,
                                     java.lang.String searchName)

Try to locate an extension service in the current classloader resources. This happens after the jar has been added to JRuby's URLClassLoader (JRubyClassLoader) and is how extensions can magically load. The basic logic is to use the require name (@param searchName) to build the name of a class ending in "Service", and then invoke that class to boot the extension. The looping logic here was in response to a RubyGems change that started absolutizing the path to the extension jar under some circumstances, leading to an incorrect package/class name for the service contained therein. The new logic will try successively more trailing elements until one of them is not a valid package name or all elements have been exhausted.

Parameters:

runtime - the current JRuby runtime

searchName - the name passed to `require`

Returns:

a ClassExtensionLibrary that will boot the ext, or null if none was found

buildClassName

private static void buildClassName(java.lang.StringBuilder nameBuilder,
                                   java.lang.StringBuilder fileBuilder,
                                   java.lang.String[] all,
                                   int i,
                                   java.lang.String serviceName)

buildServiceName

private static java.lang.String buildServiceName(java.lang.String jarName)

getName

public java.lang.String getName()

load

public void load(Ruby runtime,
                 boolean wrap)

Specified by:

load in interface Library