org.jruby.ext.jruby

Class JRubyUtilLibrary

java.lang.Object

org.jruby.ext.jruby.JRubyUtilLibrary

All Implemented Interfaces:

Library

public class JRubyUtilLibrary
extends java.lang.Object
implements Library

Utilities library for all those methods that don't need the full 'java' library to be loaded. This is done mostly for performance reasons. For example, for those who only need to enable the object space, not loading 'java' might save 200-300ms of startup time, like in case of jirb.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JRubyUtilLibrary.StringUtils Deprecated.

Field Summary

Fields inherited from interface org.jruby.runtime.load.Library

DUMMY

Constructor Summary

Constructors

Constructor and Description
JRubyUtilLibrary()

Method Summary

Modifier and Type	Method and Description
static IRubyObject	cache_stats(ThreadContext context, IRubyObject self) Provide stats on how many method and constant invalidations have occurred globally.
static IRubyObject	class_loader_resources(ThreadContext context, IRubyObject recv, IRubyObject... args)
static IRubyObject	classpath_launcher(ThreadContext context, IRubyObject recv)
static IRubyObject	extra_gem_paths(ThreadContext context, IRubyObject recv)
static IRubyObject	gc(ThreadContext context, IRubyObject recv)
static IRubyObject	getClassLoaderResources(IRubyObject recv, IRubyObject name) Deprecated.
static IRubyObject	getObjectSpaceEnabled(IRubyObject recv)
static RubyArray	internal_libraries(ThreadContext context, IRubyObject self) Return a list of files and extensions that JRuby treats as internal (or "built-in"), skipping load path and filesystem search.
static IRubyObject	load_ext(ThreadContext context, IRubyObject recv, IRubyObject klass) Preffered way to boot-up JRuby extensions (available as >JRuby.load_ext).
void	load(Ruby runtime, boolean wrap)
static IRubyObject	native_posix_p(ThreadContext context, IRubyObject self)
static IRubyObject	set_meta_class(ThreadContext context, IRubyObject recv, IRubyObject obj, IRubyObject klass)
static IRubyObject	setObjectSpaceEnabled(IRubyObject recv, IRubyObject arg)

Methods inherited from class java.lang.Object

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

Constructor Detail

JRubyUtilLibrary

public JRubyUtilLibrary()

Method Detail

load

public void load(Ruby runtime,
                 boolean wrap)
          throws java.io.IOException

Specified by:

load in interface Library

Throws:

java.io.IOException

gc

public static IRubyObject gc(ThreadContext context,
                             IRubyObject recv)

getObjectSpaceEnabled

public static IRubyObject getObjectSpaceEnabled(IRubyObject recv)

setObjectSpaceEnabled

public static IRubyObject setObjectSpaceEnabled(IRubyObject recv,
                                                IRubyObject arg)

native_posix_p

public static IRubyObject native_posix_p(ThreadContext context,
                                         IRubyObject self)

getClassLoaderResources

@Deprecated
public static IRubyObject getClassLoaderResources(IRubyObject recv,
                                                              IRubyObject name)

Deprecated.

class_loader_resources

public static IRubyObject class_loader_resources(ThreadContext context,
                                                 IRubyObject recv,
                                                 IRubyObject... args)

Parameters:

context -

recv -

args - (name, raw: false, path: false)

Returns:

an enumerable of class-loader resources

classpath_launcher

public static IRubyObject classpath_launcher(ThreadContext context,
                                             IRubyObject recv)

extra_gem_paths

public static IRubyObject extra_gem_paths(ThreadContext context,
                                          IRubyObject recv)

set_meta_class

public static IRubyObject set_meta_class(ThreadContext context,
                                         IRubyObject recv,
                                         IRubyObject obj,
                                         IRubyObject klass)

load_ext

public static IRubyObject load_ext(ThreadContext context,
                                   IRubyObject recv,
                                   IRubyObject klass)

Preffered way to boot-up JRuby extensions (available as >JRuby.load_ext).

Parameters:

context -

recv -

klass -

Returns:

loading outcome

cache_stats

public static IRubyObject cache_stats(ThreadContext context,
                                      IRubyObject self)

Provide stats on how many method and constant invalidations have occurred globally. This was added for Pry in https://github.com/jruby/jruby/issues/4384

internal_libraries

public static RubyArray internal_libraries(ThreadContext context,
                                           IRubyObject self)

Return a list of files and extensions that JRuby treats as internal (or "built-in"), skipping load path and filesystem search. This was added for Bootsnap in https://github.com/Shopify/bootsnap/issues/162