provided.rmiUtils.classServer

Class ClassFileServer

java.lang.Object

provided.rmiUtils.classServer.ClassServer

provided.rmiUtils.classServer.ClassFileServer

All Implemented Interfaces:

java.lang.Runnable

public class ClassFileServer
extends ClassServer

The ClassFileServer implements a ClassServer that reads class files from the file system. See the doc for the "Main" method for how to run this server.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	classpath path to the default package.

Constructor Summary

Constructors

Constructor and Description
ClassFileServer(int port, java.lang.String classpath) Constructs a ClassFileServer.
ClassFileServer(int port, java.lang.String classpath, java.util.function.Consumer<java.lang.String> infoMsgStrategy, java.util.function.Consumer<java.lang.String> errMsgStrategy) Constructs a ClassFileServer.

Method Summary

Modifier and Type	Method and Description
byte[]	getBytes(java.lang.String path) Returns an array of bytes containing the bytecodes for the class represented by the argument path.
static void	main(java.lang.String[] args) This method is for testing purposes only.

Methods inherited from class provided.rmiUtils.classServer.ClassServer

run, showErrorMsg, showInfoMsg, stop

Methods inherited from class java.lang.Object

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

Field Detail

classpath

private java.lang.String classpath

path to the default package.

Constructor Detail

ClassFileServer

public ClassFileServer(int port,
                       java.lang.String classpath)
                throws java.io.IOException

Constructs a ClassFileServer. Info and error messages are sent to System.out.println() and System.err.println() respectively.

Parameters:

port - The port to use for the server

classpath - The classpath where the server locates classes

Throws:

java.io.IOException - if cannot listen on specified port

ClassFileServer

public ClassFileServer(int port,
                       java.lang.String classpath,
                       java.util.function.Consumer<java.lang.String> infoMsgStrategy,
                       java.util.function.Consumer<java.lang.String> errMsgStrategy)
                throws java.io.IOException

Constructs a ClassFileServer. The given infoMsgStrategy and errMsgStrategy are augmented to first send messages to System.out.println() and System.err.println() respectively.

Parameters:

port - The port to use for the server

classpath - The classpath where the server locates classes

infoMsgStrategy - Strategy to display an info message.

errMsgStrategy - Strategy to display an error message.

Throws:

java.io.IOException - If there is an error creating the server.

Method Detail

getBytes

public byte[] getBytes(java.lang.String path)
                throws java.io.IOException,
                       java.lang.ClassNotFoundException

Returns an array of bytes containing the bytecodes for the class represented by the argument path. The path is a dot separated class name with the ".class" extension removed.

Specified by:

getBytes in class ClassServer

Parameters:

path - fully qualified classname of the desired class

Returns:

the bytecodes for the class

Throws:

java.lang.ClassNotFoundException - if the class corresponding to path could not be loaded.

java.io.IOException - if error occurs reading the class

main

public static void main(java.lang.String[] args)

This method is for testing purposes only. In general, an application will instantiate its own ClassFileServer instance. Main method to create the class server that reads class files. This takes two command line arguments, the port on which the server accepts requests and the root of the classpath. To start up the server:

java ClassFileServer <port> <classpath>

The codebase of an RMI server using this webserver would simply contain a URL with the host and port of the web server (if the webserver's classpath is the same as the RMI server's classpath):

java -Djava.rmi.server.codebase=http://zaphod:2001/ RMIServer

You can create your own class server inside your RMI server application instead of running one separately. In your server main simply create a ClassFileServer:

new ClassFileServer(port, classpath);

Parameters:

args - args[0] = port number, args[1] = classpath