HOME
Library
JRobin API
Utilities
Support
About Us
Forum

 

SourceForge.net Logo 

Get Firefox

 

 

Main library

JRobin is distributed as a single tarball named jrobin-{version}.tar.gz. When you unpack it, the following directory structure will be created:

/jrobin-{version}
    /src                           -> full source code
    /doc                           -> HTML documentation
        /javadoc                   -> javadoc
    /res                           -> files used for JRobin MRTG demo development
    /lib                           ->  
        jrobin-{version}.jar       -> main library, JRobin itself
        jrobin-demo-{version}.jar  -> library with demo classes
        mrtg-server-{version}.jar  -> see JRobin MRTG demo 
        mrtg-client-{version}.jar  -> (same as above)        
        xmlrpc.jar                 -> (same as above)        
        snmp.jar                   -> (same as above)
        inspector-{version}.jar    -> check Inspector utility page
        convertor-{version}.jar    -> check Convertor utility page  
    /ant
        build.xml                  -> Jakarta ant build file

To use JRobin in your Java code you'll have to include main JRobin library in the classpath. JRobin library comes in a single JAR file (jrobin-{version}.jar), without external dependencies. This jar consists of two packages:

  • org.jrobin.core.*
    The core library. All classes and methods necessary to create and update your RRD files, or to fetch data from them are here. This package must be imported whenever a create/update/fetch/graph/last operation is to be performed.
  • org.jrobin.graph.*
    JRobin's graphing API. Import this package in your java code only when you want to create RRD graphs with JRobin. Prior to version 1.2.0, JRobin used JFreeChart library to do the hard work (actual graph drawing) but this library is now obsolete and you won't find it in the distribution. Starting from version 1.2.0, JRobin uses no external libraries.

Important: If your JRobin based application should run on a platform without XFree86 system (common situation on many network servers), you have to run your JVM in a headless mode:

java -Djava.awt.headless=true -cp jrobin-{version}.jar ...

Otherwise, you'll end with a nasty looking exception whenever you try to create your custom RRD graphs with JRobin API.

Back to the top

Copyright © 2003, 2004 Sasa Markovic & Arne Vandamme. All Rights Reserved.