Class RJavaClassLoader

java.lang.Object
  java.lang.ClassLoader
      java.security.SecureClassLoader
          java.net.URLClassLoader
              RJavaClassLoader

public class RJavaClassLoader
extends URLClassLoader

Class loader used internally by rJava The class manages the class paths and the native libraries (jri, ...)

Field Summary

static RJavaClassLoader	primaryLoader singleton
boolean	useSystem Should the system class loader be used to resolve classes as well as this class loader
static boolean	verbose Print debug messages if is set to true

Constructor Summary

RJavaClassLoader(String path, String libpath)
Constructor.

Method Summary

void	addClassPath(String cp) adds an entry to the class path
void	addClassPath(String[] cp) adds several entries to the class path
void	addRLibrary(String name, String path) add a library to path mapping for a native library
void	bootClass(String cName, String mName, String[] args) Boots the specified method of the specified class
protected Class	findClass(String name)
protected String	findLibrary(String name)
URL	findResource(String name)
String[]	getClassPath()
static RJavaClassLoader	getPrimaryLoader() Returns the singleton instance of RJavaClassLoader
static void	main(String[] args) main method This uses the system properties: rjava.path : path of the rJava package rjava.lib : lib sub directory of the rJava package main.class : main class to "boot", assumes Main if not specified rjava.class.path : set of paths to populate the initiate the class path and boots the "main" method of the specified main.class, passing the args down to the booted class This makes sure R and rJava are known by the class loader
static void	setDebug(int level) Set the debug level.
static byte[]	toByte(Object object) Serialize an object to a byte array.
Object	toObject(byte[] byteArray) Deserialize an object from a byte array.
static Object	toObjectPL(byte[] byteArray) converts the byte array into an Object using the primary RJavaClassLoader
static String	u2w(String fn) Utility to convert paths for windows.

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findResources, getPermissions, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLoadedClass, findSystemClass, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

primaryLoader

public static RJavaClassLoader primaryLoader

singleton

verbose

public static boolean verbose

Print debug messages if is set to true

useSystem

public boolean useSystem

Should the system class loader be used to resolve classes as well as this class loader

Constructor Detail

RJavaClassLoader

public RJavaClassLoader(String path,
                        String libpath)

Constructor. The first time an RJavaClassLoader is created, it is cached as the primary loader.

Parameters:

path - path of the rJava package

libpath - lib sub directory of the rJava package

Method Detail

getPrimaryLoader

public static RJavaClassLoader getPrimaryLoader()

Returns the singleton instance of RJavaClassLoader

findClass

protected Class findClass(String name)
                   throws ClassNotFoundException

Overrides:

findClass in class URLClassLoader

Throws:

ClassNotFoundException

findResource

public URL findResource(String name)

Overrides:

findResource in class URLClassLoader

addRLibrary

public void addRLibrary(String name,
                        String path)

add a library to path mapping for a native library

addClassPath

public void addClassPath(String cp)

adds an entry to the class path

addClassPath

public void addClassPath(String[] cp)

adds several entries to the class path

getClassPath

public String[] getClassPath()

Returns:

the array of class paths used by this class loader

findLibrary

protected String findLibrary(String name)

Overrides:

findLibrary in class ClassLoader

bootClass

public void bootClass(String cName,
                      String mName,
                      String[] args)
               throws IllegalAccessException,
                      InvocationTargetException,
                      NoSuchMethodException,
                      ClassNotFoundException

Boots the specified method of the specified class

Parameters:

cName - class to boot

mName - method to boot (typically main). The method must take a String[] as parameter

args - arguments to pass to the method

Throws:

IllegalAccessException

InvocationTargetException

NoSuchMethodException

ClassNotFoundException

setDebug

public static void setDebug(int level)

Set the debug level. At the moment, there is only verbose (level>0) or quiet

Parameters:

level - debug level. verbose (>0), quiet otherwise

u2w

public static String u2w(String fn)

Utility to convert paths for windows. Converts / to the path separator in use

Parameters:

fn - file name

main

public static void main(String[] args)

main method

This uses the system properties:

• rjava.path : path of the rJava package
• rjava.lib : lib sub directory of the rJava package
• main.class : main class to "boot", assumes Main if not specified
• rjava.class.path : set of paths to populate the initiate the class path

and boots the "main" method of the specified main.class, passing the args down to the booted class

This makes sure R and rJava are known by the class loader

toByte

public static byte[] toByte(Object object)
                     throws Exception

Serialize an object to a byte array. (code by CB)

Parameters:

object - object to serialize

Returns:

byte array that represents the object

Throws:

Exception

toObject

public Object toObject(byte[] byteArray)
                throws Exception

Deserialize an object from a byte array. (code by CB)

Parameters:

byteArray -

Returns:

the object that is represented by the byte array

Throws:

Exception

toObjectPL

public static Object toObjectPL(byte[] byteArray)
                         throws Exception

converts the byte array into an Object using the primary RJavaClassLoader

Throws:

Exception