|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jrobin.core.RrdDbPool
public class RrdDbPool
This class should be used to synchronize access to RRD files in a multithreaded environment. This class should be also used to prevent openning of too many RRD files at the same time (thus avoiding operating system limits)
Field Summary | |
---|---|
static int |
INITIAL_CAPACITY
Initial capacity of the pool i.e. |
Method Summary | |
---|---|
int |
getCapacity()
Returns the maximum number of simultaneously open RRD files. |
static RrdDbPool |
getInstance()
Creates a single instance of the class on the first call, or returns already existing one. |
int |
getOpenFileCount()
Returns the number of open RRD files. |
java.lang.String[] |
getOpenFiles()
Returns an array of open file names. |
void |
release(RrdDb rrdDb)
Releases RrdDb reference previously obtained from the pool. |
RrdDb |
requestRrdDb(RrdDef rrdDef)
Requests a RrdDb reference for the given RRD file definition object. |
RrdDb |
requestRrdDb(java.lang.String path)
Requests a RrdDb reference for the given RRD file path. |
RrdDb |
requestRrdDb(java.lang.String path,
java.lang.String sourcePath)
Requests a RrdDb reference for the given path. |
void |
setCapacity(int capacity)
Sets the maximum number of simultaneously open RRD files. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int INITIAL_CAPACITY
Method Detail |
---|
public static RrdDbPool getInstance() throws RrdException
RrdException
- Thrown if the default RRD backend is not derived from the RrdFileBackendFactory
public RrdDb requestRrdDb(java.lang.String path) throws java.io.IOException, RrdException
INITIAL_CAPACITY
, the file will be open and a new RrdDb reference will be returned.
If the file is not already open and the number of already open RRD files is equal to
INITIAL_CAPACITY
, the method blocks until some RRD file is closed.
path
- Path to existing RRD file
java.io.IOException
- Thrown in case of I/O error
RrdException
- Thrown in case of JRobin specific errorpublic RrdDb requestRrdDb(RrdDef rrdDef) throws java.io.IOException, RrdException
INITIAL_CAPACITY
, a new RRD file will be created and a its RrdDb reference will be returned.
If the file is not already open and the number of already open RRD files is equal to
INITIAL_CAPACITY
, the method blocks until some RRD file is closed.
rrdDef
- Definition of the RRD file to be created
java.io.IOException
- Thrown in case of I/O error
RrdException
- Thrown in case of JRobin specific errorpublic RrdDb requestRrdDb(java.lang.String path, java.lang.String sourcePath) throws java.io.IOException, RrdException
INITIAL_CAPACITY
, a new RRD file will be created and a its RrdDb reference will be returned.
If the file is not already open and the number of already open RRD files is equal to
INITIAL_CAPACITY
, the method blocks until some RRD file is closed.
path
- Path to RRD file which should be createdsourcePath
- Path to external data which is to be converted to JRobin's native RRD file format
java.io.IOException
- Thrown in case of I/O error
RrdException
- Thrown in case of JRobin specific errorpublic void release(RrdDb rrdDb) throws java.io.IOException, RrdException
rrdDb
- RrdDb reference to be returned to the pool
java.io.IOException
- Thrown in case of I/O error
RrdException
- Thrown in case of JRobin specific errorpublic int getCapacity()
public void setCapacity(int capacity)
capacity
- Maximum number of simultaneously open RRD files.public java.lang.String[] getOpenFiles()
public int getOpenFileCount()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |