org.apache.jmeter.save
Class CSVSaveService

java.lang.Object
  org.apache.jmeter.save.CSVSaveService

public final class CSVSaveService
extends java.lang.Object

This class provides a means for saving/reading test results as CSV files.

Field Summary

static char

QUOTING_CHAR

Method Summary

static java.lang.String[]	csvReadFile(java.io.BufferedReader infile, char delim) Reads from file and splits input into strings according to the delimiter, taking note of quoted strings.
static java.lang.String[]	csvSplitString(java.lang.String line, char delim) Reads from String and splits into strings according to the delimiter, taking note of quoted strings.
static SampleSaveConfiguration	getSampleSaveConfiguration(java.lang.String headerLine, java.lang.String filename) Parse a CSV header line
static SampleEvent	makeResultFromDelimitedString(java.lang.String inputLine, SampleSaveConfiguration saveConfig, long lineNumber) Deprecated. Does not handle quoted strings; use processSamples(String, Visualizer, ResultCollector) instead
static java.lang.String	printableFieldNamesToString() Generates the field names for the output file
static java.lang.String	printableFieldNamesToString(SampleSaveConfiguration saveConfig) Generates the field names for the output file
static void	processSamples(java.lang.String filename, Visualizer visualizer, ResultCollector resultCollector) Read Samples from a file; handles quoted strings.
static java.lang.String	resultToDelimitedString(SampleEvent event) Convert a result into a string, where the fields of the result are separated by the default delimiter.
static java.lang.String	resultToDelimitedString(SampleEvent event, java.lang.String delimiter) Convert a result into a string, where the fields of the result are separated by a specified String.
static void	saveCSVStats(javax.swing.table.DefaultTableModel model, java.io.FileWriter writer) Method saves aggregate statistics as CSV from a table model.
static void	saveCSVStats(java.util.Vector data, java.io.FileWriter writer) Method will save aggregate statistics as CSV.
static void	saveCSVStats(java.util.Vector data, java.io.FileWriter writer, java.lang.String[] headers) Method will save aggregate statistics as CSV.

Methods inherited from class java.lang.Object

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

Field Detail

QUOTING_CHAR

public static final char QUOTING_CHAR

See Also:

Constant Field Values

Method Detail

processSamples

public static void processSamples(java.lang.String filename,
                                  Visualizer visualizer,
                                  ResultCollector resultCollector)
                           throws java.io.IOException

Read Samples from a file; handles quoted strings.

Parameters:

filename - input file

visualizer - where to send the results

resultCollector - the parent collector

Throws:

java.io.IOException

makeResultFromDelimitedString

public static SampleEvent makeResultFromDelimitedString(java.lang.String inputLine,
                                                        SampleSaveConfiguration saveConfig,
                                                        long lineNumber)

Deprecated. Does not handle quoted strings; use processSamples(String, Visualizer, ResultCollector) instead

Make a SampleResult given a delimited string.

Parameters:

inputLine - - line from CSV file

saveConfig - - configuration

lineNumber - - line number for error reporting

Returns:

SampleResult

Throws:

JMeterError

printableFieldNamesToString

public static java.lang.String printableFieldNamesToString()

Generates the field names for the output file

Returns:

the field names as a string

printableFieldNamesToString

public static java.lang.String printableFieldNamesToString(SampleSaveConfiguration saveConfig)

Generates the field names for the output file

Returns:

the field names as a string

getSampleSaveConfiguration

public static SampleSaveConfiguration getSampleSaveConfiguration(java.lang.String headerLine,
                                                                 java.lang.String filename)

Parse a CSV header line

Parameters:

headerLine - from CSV file

filename - name of file (for log message only)

Returns:

config corresponding to the header items found or null if not a header line

saveCSVStats

public static void saveCSVStats(java.util.Vector data,
                                java.io.FileWriter writer)
                         throws java.io.IOException

Method will save aggregate statistics as CSV. For now I put it here. Not sure if it should go in the newer SaveService instead of here. if we ever decide to get rid of this class, we'll need to move this method to the new save service.

Parameters:

data - vector of data rows

writer - output file

Throws:

java.io.IOException

saveCSVStats

public static void saveCSVStats(java.util.Vector data,
                                java.io.FileWriter writer,
                                java.lang.String[] headers)
                         throws java.io.IOException

Method will save aggregate statistics as CSV. For now I put it here. Not sure if it should go in the newer SaveService instead of here. if we ever decide to get rid of this class, we'll need to move this method to the new save service.

Parameters:

data - vector of data rows

writer - output file

headers - header names (if non-null)

Throws:

java.io.IOException

saveCSVStats

public static void saveCSVStats(javax.swing.table.DefaultTableModel model,
                                java.io.FileWriter writer)
                         throws java.io.IOException

Method saves aggregate statistics as CSV from a table model. Same as saveCSVStats(Vector, FileWriter, String[]) except that there is no need to create a Vector containing the data.

Parameters:

model - table model containing the data

writer - output file

Throws:

java.io.IOException

resultToDelimitedString

public static java.lang.String resultToDelimitedString(SampleEvent event)

Convert a result into a string, where the fields of the result are separated by the default delimiter.

Parameters:

event - the sample event to be converted

Returns:

the separated value representation of the result

resultToDelimitedString

public static java.lang.String resultToDelimitedString(SampleEvent event,
                                                       java.lang.String delimiter)

Convert a result into a string, where the fields of the result are separated by a specified String.

Parameters:

event - the sample event to be converted

delimiter - the separation string

Returns:

the separated value representation of the result

csvReadFile

public static java.lang.String[] csvReadFile(java.io.BufferedReader infile,
                                             char delim)
                                      throws java.io.IOException

Reads from file and splits input into strings according to the delimiter, taking note of quoted strings.

Handles DOS (CRLF), Unix (LF), and Mac (CR) line-endings equally.

N.B. a blank line is returned as a zero length array, whereas "" is returned as an empty string. This is inconsistent.

Parameters:

infile - input file - must support mark(1)

delim - delimiter (e.g. comma)

Returns:

array of strings

Throws:

java.io.IOException - also for unexpected quote characters

csvSplitString

public static java.lang.String[] csvSplitString(java.lang.String line,
                                                char delim)
                                         throws java.io.IOException

Reads from String and splits into strings according to the delimiter, taking note of quoted strings. Handles DOS (CRLF), Unix (LF), and Mac (CR) line-endings equally.

Parameters:

line - input line

delim - delimiter (e.g. comma)

Returns:

array of strings

Throws:

java.io.IOException - also for unexpected quote characters