RrdDef (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- org.rrd4j.core.RrdDef

```
public class RrdDef
extends Object
```
Class to represent definition of new Round Robin Database (RRD). Object of this class is used to create new RRD from scratch - pass its reference as a RrdDb constructor argument (see documentation for RrdDb class). RrdDef object does not actually create new RRD. It just holds all necessary information which will be used during the actual creation process.
RRD definition (RrdDef object) consists of the following elements:
- path to RRD that will be created
- starting timestamp
- step
- version, 1 for linear disposition of archives, 2 for matrix disposition
- one or more datasource definitions
- one or more archive definitions
RrdDef provides API to set all these elements. For the complete explanation of all RRD definition parameters, see RRDTool's rrdcreate man page.

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DEFAULT_INITIAL_SHIFT` If not specified in constructor, starting timestamp will be set to current timestamp plus DEFAULT_INITIAL_SHIFT seconds (-10).
`static long`	`DEFAULT_STEP` Default RRD step to be used if not specified in constructor (300 seconds).
`static int`	`DEFAULTVERSION` Default RRD file format version.

Constructor Summary

Constructors
Constructor and Description
`RrdDef(String rrdpath)` Creates new RRD definition object with the given path.
`RrdDef(String path, long step)` Creates new RRD definition object with the given path and step.
`RrdDef(String path, long startTime, long step)` Creates new RRD definition object with the given path, starting timestamp and step.
`RrdDef(String path, long startTime, long step, int version)` Creates new RRD definition object with the given path, starting timestamp, step and version.
`RrdDef(URI uri)` Creates new RRD definition object with the given path.
`RrdDef(URI uri, long step)` Creates new RRD definition object with the given path and step.
`RrdDef(URI uri, long startTime, long step)` Creates new RRD definition object with the given path, starting timestamp and step.
`RrdDef(URI uri, long startTime, long step, int version)` Creates new RRD definition object with the given path, starting timestamp, step and version.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addArchive(ArcDef... arcDefs)` Adds archive definitions to RRD definition in bulk.
`void`	`addArchive(ArcDef arcDef)` Adds single archive definition represented with object of class `ArcDef`.
`void`	`addArchive(ConsolFun consolFun, double xff, int steps, int rows)` Adds single archive definition by specifying its consolidation function, X-files factor, number of steps and rows.
`void`	`addArchive(String rrdToolArcDef)` Adds single archive to RRD definition from a RRDTool-like archive definition string.
`void`	`addDatasource(DsDef... dsDefs)` Adds data source definitions to RRD definition in bulk.
`void`	`addDatasource(DsDef dsDef)` Adds single datasource definition represented with object of class `DsDef`.
`void`	`addDatasource(String rrdToolDsDef)` Adds single datasource to RRD definition from a RRDTool-like datasource definition string.
`void`	`addDatasource(String dsName, DsType dsType, long heartbeat, double minValue, double maxValue)` Adds single datasource to RRD definition by specifying its data source name, source type, heartbeat, minimal and maximal value.
`(package private) static long`	`calculateSize(int dsCount, int arcCount, int rowsCount, String[] dsNames)` Calculate estimated storage size
`String`	`dump()` Returns string that represents all specified RRD creation parameters.
`boolean`	`equals(Object obj)`
`String`	`exportXmlTemplate()` Exports RrdDef object to string in XML format.
`String`	`exportXmlTemplate(boolean compatible)` Exports RrdDef object to string in XML format.
`void`	`exportXmlTemplate(OutputStream out)` Exports RrdDef object to output stream in XML format.
`void`	`exportXmlTemplate(OutputStream out, boolean compatible)` Exports RrdDef object to output stream in XML format.
`void`	`exportXmlTemplate(String filePath)` Exports RrdDef object to a file in XML format.
`void`	`exportXmlTemplate(String filePath, boolean compatible)` Exports RrdDef object to a file in XML format.
`void`	`exportXmlTemplate(XmlWriter xml, boolean compatible)` Exports RrdDef object to output stream in XML format.
`(package private) ArcDef`	`findArchive(ConsolFun consolFun, int steps)` Archive.
`int`	`getArcCount()` Returns number of defined archives.
`ArcDef[]`	`getArcDefs()` Returns all archive definition objects specified so far.
`int`	`getDsCount()` Returns number of defined datasources.
`DsDef[]`	`getDsDefs()` Returns all data source definition objects specified so far.
`long`	`getEstimatedSize()` Returns the number of storage bytes required to create RRD from this RrdDef object.
`String`	`getPath()` Returns path for the new RRD.
`(package private) String`	`getRrdToolCommand()` Rrdtool command.
`long`	`getStartTime()` Returns starting time stamp for the RRD that should be created.
`long`	`getStep()` Returns time step for the RRD that will be created.
`URI`	`getUri()` Returns URI for the new RRD
`int`	`getVersion()` Returns the RRD file version
`boolean`	`hasArchives()` hasArchives.
`boolean`	`hasDatasources()` hasDatasources.
`int`	`hashCode()` hashCode.
`(package private) void`	`removeArchive(ConsolFun consolFun, int steps)` Remove archive
`void`	`removeArchives()` Removes all RRA archive definitions.
`(package private) void`	`removeDatasource(String dsName)` Remove datasource
`void`	`removeDatasources()` Removes all datasource definitions.
`(package private) void`	`saveSingleDatasource(String dsName)` Save single datasource
`void`	`setPath(String path)` Sets path to RRD.
`void`	`setPath(URI uri)` Sets URI to RRD.
`void`	`setStartTime(Calendar gc)` Sets RRD's starting timestamp.
`void`	`setStartTime(Date date)` Sets RRD's starting timestamp.
`void`	`setStartTime(long startTime)` Sets RRD's starting timestamp.
`void`	`setStep(long step)` Sets RRD's time step.
`void`	`setVersion(int version)` Sets RRD's file version.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_INITIAL_SHIFT
```
public static final long DEFAULT_INITIAL_SHIFT
```
    If not specified in constructor, starting timestamp will be set to current timestamp plus DEFAULT_INITIAL_SHIFT seconds (-10).
    See Also:
    Constant Field Values
  - DEFAULT_STEP
```
public static final long DEFAULT_STEP
```
    Default RRD step to be used if not specified in constructor (300 seconds).
    See Also:
    Constant Field Values
  - DEFAULTVERSION
```
public static final int DEFAULTVERSION
```
    Default RRD file format version.
    See Also:
    Constant Field Values
- Constructor Detail
  - RrdDef
```
public RrdDef(String rrdpath)
```
    Creates new RRD definition object with the given path. When this object is passed to RrdDb constructor, new RRD will be created using the specified path.
    The will be transformed internally to an URI using the default backend factory.
    Parameters:
    rrdpath - Path to new RRD.
  - RrdDef
```
public RrdDef(String path,
              long step)
```
    Creates new RRD definition object with the given path and step.
    The will be transformed internally to an URI using the default backend factory.
    Parameters:
    path - URI to new RRD.
    step - RRD step.
  - RrdDef
```
public RrdDef(String path,
              long startTime,
              long step)
```
    Creates new RRD definition object with the given path, starting timestamp and step.
    The will be transformed internally to an URI using the default backend factory.
    Parameters:
    path - Path to new RRD.
    startTime - RRD starting timestamp.
    step - RRD step.
  - RrdDef
```
public RrdDef(String path,
              long startTime,
              long step,
              int version)
```
    Creates new RRD definition object with the given path, starting timestamp, step and version.
    The will be transformed internally to an URI using the default backend factory.
    Parameters:
    path - Path to new RRD.
    startTime - RRD starting timestamp.
    step - RRD step.
    version - RRD's file version.
  - RrdDef
```
public RrdDef(URI uri)
```
    Creates new RRD definition object with the given path. When this object is passed to RrdDb constructor, new RRD will be created using the specified path.
    Parameters:
    uri - URI to the new RRD.
  - RrdDef
```
public RrdDef(URI uri,
              long step)
```
    Creates new RRD definition object with the given path and step.
    Parameters:
    uri - URI to new RRD.
    step - RRD step.
  - RrdDef
```
public RrdDef(URI uri,
              long startTime,
              long step)
```
    Creates new RRD definition object with the given path, starting timestamp and step.
    Parameters:
    uri - URI to new RRD.
    startTime - RRD starting timestamp.
    step - RRD step.
  - RrdDef
```
public RrdDef(URI uri,
              long startTime,
              long step,
              int version)
```
    Creates new RRD definition object with the given path, starting timestamp, step and version.
    Parameters:
    uri - URI to new RRD.
    startTime - RRD starting timestamp.
    step - RRD step.
    version - RRD's file version.
- Method Detail
  - addArchive
```
public void addArchive(ArcDef... arcDefs)
```
    Adds archive definitions to RRD definition in bulk.
    Parameters:
    arcDefs - Array of archive definition objects
    Throws:
    IllegalArgumentException - Thrown if RRD definition already contains archive with the same consolidation function and the same number of steps.
  - addArchive
```
public void addArchive(ArcDef arcDef)
```
    Adds single archive definition represented with object of class ArcDef.
    Parameters:
    arcDef - Archive definition.
    Throws:
    IllegalArgumentException - Thrown if archive with the same consolidation function and the same number of steps is already added.
  - addArchive
```
public void addArchive(ConsolFun consolFun,
                       double xff,
                       int steps,
                       int rows)
```
    Adds single archive definition by specifying its consolidation function, X-files factor, number of steps and rows. For the complete explanation of all archive definition parameters see RRDTool's rrdcreate man page.
    Parameters:
    consolFun - Consolidation function.
    xff - X-files factor. Valid values are between 0 and 1.
    steps - Number of archive steps
    rows - Number of archive rows
    Throws:
    IllegalArgumentException - Thrown if archive with the same consolidation function and the same number of steps is already added.
  - addArchive
```
public void addArchive(String rrdToolArcDef)
```
    Adds single archive to RRD definition from a RRDTool-like archive definition string. The string must have five elements separated with colons (:) in the following order:
```
 RRA:consolidationFunction:XFilesFactor:steps:rows
 
```
    For example:
```
 RRA:AVERAGE:0.5:10:1000
 
```
    For more information on archive definition parameters see rrdcreate man page.
    Parameters:
    rrdToolArcDef - Archive definition string with the syntax borrowed from RRDTool.
    Throws:
    IllegalArgumentException - Thrown if invalid string is supplied.
  - addDatasource
```
public void addDatasource(DsDef... dsDefs)
```
    Adds data source definitions to RRD definition in bulk.
    Parameters:
    dsDefs - Array of data source definition objects.
  - addDatasource
```
public void addDatasource(DsDef dsDef)
```
    Adds single datasource definition represented with object of class DsDef.
    Parameters:
    dsDef - Datasource definition.
  - addDatasource
```
public void addDatasource(String rrdToolDsDef)
```
    Adds single datasource to RRD definition from a RRDTool-like datasource definition string. The string must have six elements separated with colons (:) in the following order:
```
 DS:name:type:heartbeat:minValue:maxValue
 
```
    For example:
```
 DS:input:COUNTER:600:0:U
 
```
    For more information on datasource definition parameters see rrdcreate man page.
    Parameters:
    rrdToolDsDef - Datasource definition string with the syntax borrowed from RRDTool.
    Throws:
    IllegalArgumentException - Thrown if invalid string is supplied.
  - addDatasource
```
public void addDatasource(String dsName,
                          DsType dsType,
                          long heartbeat,
                          double minValue,
                          double maxValue)
```
    Adds single datasource to RRD definition by specifying its data source name, source type, heartbeat, minimal and maximal value. For the complete explanation of all data source definition parameters see RRDTool's rrdcreate man page.
    IMPORTANT NOTE: If datasource name ends with '!', corresponding archives will never store NaNs as datasource values. In that case, NaN datasource values will be silently replaced with zeros by the framework.
    Parameters:
    dsName - Data source name.
    dsType - Data source type. Valid types are "COUNTER", "GAUGE", "DERIVE" and "ABSOLUTE" (these string constants are conveniently defined in the DsType class).
    heartbeat - Data source heartbeat.
    minValue - Minimal acceptable value. Use Double.NaN if unknown.
    maxValue - Maximal acceptable value. Use Double.NaN if unknown.
    Throws:
    IllegalArgumentException - Thrown if new datasource definition uses already used data source name.
  - calculateSize
```
static long calculateSize(int dsCount,
                          int arcCount,
                          int rowsCount,
                          String[] dsNames)
```
    Calculate estimated storage size
  - dump
```
public String dump()
```
    Returns string that represents all specified RRD creation parameters. Returned string has the syntax of RRDTool's create command.
    Returns:
    Dumped content of RrdDb object.
  - equals
```
public boolean equals(Object obj)
```
    Compares the current RrdDef with another. RrdDefs are considered equal if:
    - RRD steps match
    - all datasources have exactly the same definition in both RrdDef objects (datasource names, types, heartbeat, min and max values must match)
    - all archives have exactly the same definition in both RrdDef objects (archive consolidation functions, X-file factors, step and row counts must match)
    Overrides:
    equals in class Object
  - exportXmlTemplate
```
public String exportXmlTemplate()
```
    Exports RrdDef object to string in XML format. Generated XML string can be parsed with RrdDefTemplate class.
    It use a format compatible with previous RRD4J's version, using a path, instead of an URI.
    Returns:
    XML formatted string representing this RrdDef object
  - exportXmlTemplate
```
public String exportXmlTemplate(boolean compatible)
```
    Exports RrdDef object to string in XML format. Generated XML string can be parsed with RrdDefTemplate class.
    If compatible is set to true, it returns an XML compatible with previous RRD4J's versions, using a path, instead of an URI.
    Parameters:
    compatible - Compatible with previous versions.
    Returns:
    XML formatted string representing this RrdDef object
  - exportXmlTemplate
```
public void exportXmlTemplate(OutputStream out)
```
    Exports RrdDef object to output stream in XML format. Generated XML code can be parsed with RrdDefTemplate class.
    It use a format compatible with previous RRD4J's version, using a path, instead of an URI.
    Parameters:
    out - Output stream
  - exportXmlTemplate
```
public void exportXmlTemplate(OutputStream out,
                              boolean compatible)
```
    Exports RrdDef object to output stream in XML format. Generated XML code can be parsed with RrdDefTemplate class.
    If compatible is set to true, it returns an XML compatible with previous RRD4J's versions, using a path, instead of an URI.
    Parameters:
    out - Output stream
    compatible - Compatible with previous versions.
  - exportXmlTemplate
```
public void exportXmlTemplate(String filePath)
                       throws IOException
```
    Exports RrdDef object to a file in XML format. Generated XML code can be parsed with RrdDefTemplate class.
    It use a format compatible with previous RRD4J's version, using a path, instead of an URI.
    Parameters:
    filePath - Path to the file
    Throws:
    IOException - if any.
  - exportXmlTemplate
```
public void exportXmlTemplate(String filePath,
                              boolean compatible)
                       throws IOException
```
    Exports RrdDef object to a file in XML format. Generated XML code can be parsed with RrdDefTemplate class.
    If compatible is set to true, it returns an XML compatible with previous RRD4J versions, using a path, instead of an URI.
    Parameters:
    filePath - Path to the file
    compatible - Compatible with previous versions.
    Throws:
    IOException - if any.
  - exportXmlTemplate
```
public void exportXmlTemplate(XmlWriter xml,
                              boolean compatible)
```
    Exports RrdDef object to output stream in XML format. Generated XML code can be parsed with RrdDefTemplate class.
    If compatible is set to true, it returns an XML compatible with previous RRD4J's versions, using a path, instead of an URI.
    Parameters:
    xml - XML writer
    compatible - Compatible with previous versions.
  - findArchive
```
ArcDef findArchive(ConsolFun consolFun,
                   int steps)
```
    Archive.
    Returns:
    the archive
  - getArcCount
```
public int getArcCount()
```
    Returns number of defined archives.
    Returns:
    Number of defined archives.
  - getArcDefs
```
public ArcDef[] getArcDefs()
```
    Returns all archive definition objects specified so far.
    Returns:
    Array of archive definition objects.
  - getDsCount
```
public int getDsCount()
```
    Returns number of defined datasources.
    Returns:
    Number of defined datasources.
  - getDsDefs
```
public DsDef[] getDsDefs()
```
    Returns all data source definition objects specified so far.
    Returns:
    Array of data source definition objects
  - getEstimatedSize
```
public long getEstimatedSize()
```
    Returns the number of storage bytes required to create RRD from this RrdDef object.
    Returns:
    Estimated byte count of the underlying RRD storage.
  - getPath
```
public String getPath()
```
    Returns path for the new RRD. It's extracted from the URI. If it's an opaque URI, it return the scheme specific part.
    It's not a reliable way to resolve an file path. Instead, one should use Paths.get(def.getUri()) when the URI scheme is file.
    Returns:
    path to the new RRD which should be created
  - getRrdToolCommand
```
String getRrdToolCommand()
```
    Rrdtool command.
    Returns:
    the rrdtool command
  - getStartTime
```
public long getStartTime()
```
    Returns starting time stamp for the RRD that should be created.
    Returns:
    RRD starting time stamp
  - getStep
```
public long getStep()
```
    Returns time step for the RRD that will be created.
    Returns:
    RRD step
  - getUri
```
public URI getUri()
```
    Returns URI for the new RRD
    Returns:
    URI to the new RRD which should be created
  - getVersion
```
public int getVersion()
```
    Returns the RRD file version
    Returns:
    the version
  - hasArchives
```
public boolean hasArchives()
```
    hasArchives.
    Returns:
    a boolean.
  - hasDatasources
```
public boolean hasDatasources()
```
    hasDatasources.
    Returns:
    a boolean.
  - hashCode
```
public int hashCode()
```
    hashCode.
    Overrides:
    hashCode in class Object
  - removeArchive
```
void removeArchive(ConsolFun consolFun,
                   int steps)
```
    Remove archive
  - removeArchives
```
public void removeArchives()
```
    Removes all RRA archive definitions.
  - removeDatasource
```
void removeDatasource(String dsName)
```
    Remove datasource
  - removeDatasources
```
public void removeDatasources()
```
    Removes all datasource definitions.
  - saveSingleDatasource
```
void saveSingleDatasource(String dsName)
```
    Save single datasource
  - setPath
```
public void setPath(String path)
```
    Sets path to RRD.
    The will be transformed internally to an URI using the default backend factory.
    Parameters:
    path - path to new RRD.
  - setPath
```
public void setPath(URI uri)
```
    Sets URI to RRD.
    Parameters:
    uri - URI to new RRD.
  - setStartTime
```
public void setStartTime(Calendar gc)
```
    Sets RRD's starting timestamp.
    Parameters:
    gc - starting date
  - setStartTime
```
public void setStartTime(Date date)
```
    Sets RRD's starting timestamp.
    Parameters:
    date - starting date
  - setStartTime
```
public void setStartTime(long startTime)
```
    Sets RRD's starting timestamp.
    Parameters:
    startTime - Starting timestamp.
  - setStep
```
public void setStep(long step)
```
    Sets RRD's time step.
    Parameters:
    step - RRD time step.
  - setVersion
```
public void setVersion(int version)
```
    Sets RRD's file version.
    Parameters:
    version - the version to set

Class RrdDef

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_INITIAL_SHIFT

DEFAULT_STEP

DEFAULTVERSION

Constructor Detail

RrdDef

RrdDef

RrdDef

RrdDef

RrdDef

RrdDef

RrdDef

RrdDef

Method Detail

addArchive

addArchive

addArchive

addArchive

addDatasource

addDatasource

addDatasource

addDatasource

calculateSize

dump

equals

exportXmlTemplate

exportXmlTemplate

exportXmlTemplate

exportXmlTemplate

exportXmlTemplate

exportXmlTemplate

exportXmlTemplate

findArchive

getArcCount

getArcDefs

getDsCount

getDsDefs

getEstimatedSize

getPath

getRrdToolCommand

getStartTime

getStep

getUri

getVersion

hasArchives

hasDatasources

hashCode

removeArchive

removeArchives

removeDatasource

removeDatasources

saveSingleDatasource

setPath

setPath

setStartTime

setStartTime

setStartTime

setStep

setVersion