matlabcontrol.internal

Class MatlabRMIClassLoaderSpi

java.lang.Object

java.rmi.server.RMIClassLoaderSpi

matlabcontrol.internal.MatlabRMIClassLoaderSpi

public class MatlabRMIClassLoaderSpi
extends RMIClassLoaderSpi

Internal Use Only

This class must be public so that it can be created via reflection by RemoteClassLoader. If it were package private it would result in an IllegalAccessError because only classes in the same package as a package private class may construct it (even via reflection). It has been placed in the matlabcontrol.internal package to make it clear it is not intended for use by users of matlabcontrol.

A custom service provider for the RMI class loader. Allows for loading classes sent from the external JVM and providing annotations so that the external JVM may load classes defined only in the MATLAB JVM. Loading classes from the external JVM could be accomplished by setting java.rmi.server.codebase property in the external JVM but that could interfere with other uses of RMI in the application. There is no way to always sending the correct annotations without this custom rmi class loader spi. While the java.rmi.server.codebase property could be set in the MATLAB JVM, the property is checked only at load time. This would mean that class definitions added dynamically with javaaddpath could not be sent.

Since:

4.0.0

Constructor Summary

Constructors

Constructor and Description
MatlabRMIClassLoaderSpi()

Method Summary

Modifier and Type	Method and Description
String	getClassAnnotation(Class<?> clazz) The returned annotation becomes the codebase argument in loadClass(java.lang.String, java.lang.String, java.lang.ClassLoader) when the RMIClassLoaderSpi in the receiving JVM attempts to load clazz.
ClassLoader	getClassLoader(String codebase)
Class<?>	loadClass(String codebase, String name, ClassLoader defaultLoader)
Class<?>	loadProxyClass(String codebase, String[] interfaces, ClassLoader defaultLoader)
static void	setCodebase(String remoteCodebase) Sets the codebase of the currently connected external JVM.

Methods inherited from class java.lang.Object

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

Constructor Detail

MatlabRMIClassLoaderSpi

public MatlabRMIClassLoaderSpi()

Method Detail

setCodebase

public static void setCodebase(String remoteCodebase)

Sets the codebase of the currently connected external JVM. This should be called only once per connection to an external JVM and should occur before users of the API can send objects over RMI.

Parameters:

remoteCodebase -

loadClass

public Class<?> loadClass(String codebase,
                          String name,
                          ClassLoader defaultLoader)
                   throws MalformedURLException,
                          ClassNotFoundException

Specified by:

loadClass in class RMIClassLoaderSpi

Throws:

MalformedURLException

ClassNotFoundException

loadProxyClass

public Class<?> loadProxyClass(String codebase,
                               String[] interfaces,
                               ClassLoader defaultLoader)
                        throws MalformedURLException,
                               ClassNotFoundException

Specified by:

loadProxyClass in class RMIClassLoaderSpi

Throws:

MalformedURLException

ClassNotFoundException

getClassLoader

public ClassLoader getClassLoader(String codebase)
                           throws MalformedURLException

Specified by:

getClassLoader in class RMIClassLoaderSpi

Throws:

MalformedURLException

getClassAnnotation

public String getClassAnnotation(Class<?> clazz)

The returned annotation becomes the codebase argument in loadClass(java.lang.String, java.lang.String, java.lang.ClassLoader) when the RMIClassLoaderSpi in the receiving JVM attempts to load clazz. This allows for classes defined in MATLAB but not in the receiving JVM to find and load the class definition.

Specified by:

getClassAnnotation in class RMIClassLoaderSpi

Parameters:

clazz -

Returns: