This section is intended to provide a step-by-step walk through of how
to transform a simple RMI application to a BRMI version.
Step 1 - Download BRMI package
Before starting, head over to the Download
section and grab BRMI. There are two parts of it, the first is BatchGen toolkit
used to automatically generate the client batching interface, the second is
BRMI runtime support package.
Step 2 - Using BatchGen
Using BatchGen generator is simple. just download our binary
distribution in jar format, then you can invoke it by typing 'java -jar
BatchGen.jar -batch' + packagename.classname.
Step 3 - Create the batching interface
Firstly let's create a simple interface for our example program. The
code for the legacy RMI program is as follow,
then we can use BatchGen to automatically generate the Batch interface
by invoking it as,
C:\Yang\workspace>java -jar BatchGen.jar conditionalTest.RemoteConditionalTest
two interfaces will be generated, they are
They will be used as the client stub to communicate with BRMI server
Step 4 - Service implementation
In this example, the remote services will be implemented as follows,
Step 5 - Invoking server
The server can be invoked as follows,
Step 6 - Running client
The client can be invoked as follows,
That's it folks! Once you have a legacy RMI application, it's EASY to
rewrite it into BRMI one with a performance gain as much as you can imagine.