| java.lang.Object com.mockrunner.jdbc.StringValuesTable
StringValuesTable | public class StringValuesTable (Code) | | A data structure providing tabular (row and column) access semantics to
items within. While applicable to several usages, the primary purpose is
(in conjunction with ArrayResultSetFactory ) to provide for easy
set up of unit test fixtures and assertion of outcomes with the same data
structures, without any need for external sources of test data.
author: Erick G. Reid |
Constructor Summary | |
public | StringValuesTable(String name, String[][] stringMatrix) Creates a new StringValuesTable with the given name,
columns and string matrix.
Parameters: name - the table name. | public | StringValuesTable(String name, String[] columnNames, String[][] stringMatrix) Creates a new StringValuesTable with the given name,
columns and string matrix.
Parameters: name - the table name. |
Method Summary | |
public String[] | getColumn(String columnName) Returns the contents of the given column.
Parameters: columnName - the name of the desired column. | public String[] | getColumn(int columnNumber) Returns the contents of the given column.
Parameters: columnNumber - the index of the desired column (1 -based).This argument must be a valid column index for thisStringValuesTable . | public String[] | getColumnNames() Returns the column names. | public String | getItem(int rowNumber, String columnName) Returns the item found in the string matrix at the given coordinate.
Parameters: rowNumber - the number of the desired row (1 -based). | public String | getItem(int rowNumber, int columnNumber) Returns the item found in the string matrix at the given coordinate.
Parameters: rowNumber - the number of the desired row (1 -based). | public String | getName() Returns the table name. | public int | getNumberOfColumns() Returns the number of columns found in the string matrix for this
StringValuesTable . | public int | getNumberOfRows() Returns the number of rows found in the string matrix for this
StringValuesTable . | public String[] | getRow(int rowNumber) Returns the elements of the given row.
Parameters: rowNumber - the number of the desired row (1 -based). | public String[][] | getStringMatrix() Returns the tabular data for this StringValuesTable . | public boolean | isValidColumnName(String columnName) Returns true if the given column name is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: columnName - the column name to verify. | public boolean | isValidColumnNumber(int columnNumber) Returns true if the given column number is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: columnNumber - the column number to verify. | public boolean | isValidRowNumber(int row) Returns true if the given row number is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: row - the row number to verify. | public static synchronized String[] | verifyColumnNames(String[] columnNames, String[][] stringMatrix) Returns the given array if it is found to indeed be valid according to
the published contract. | public static synchronized String[][] | verifyStringMatrix(String[][] stringMatrix) Returns the given matrix if it is found to indeed be valid according to
the published contract. |
StringValuesTable | public StringValuesTable(String name, String[][] stringMatrix)(Code) | | Creates a new StringValuesTable with the given name,
columns and string matrix.
Parameters: name - the table name. This argument cannot be null and must contain at least 1 non-blank character. Parameters: stringMatrix - the string matrix. This argument cannot be null ,must not contain any null values, and each array in the matrixmust contain the same number of elements as the first (stringMatrix[0].length == stringMatrix[n].length for any given valid row number, n ). Further,this matrix must, at a minimum represent 1 rowand 1 column of items (stringMatrix.length >= 1 ,and stringMatrix[0].length >= 1 ). |
StringValuesTable | public StringValuesTable(String name, String[] columnNames, String[][] stringMatrix)(Code) | | Creates a new StringValuesTable with the given name,
columns and string matrix.
Parameters: name - the table name. This argument cannot be null and must contain at least 1 non-blank character. Parameters: columnNames - the names for the columns in this StringValuesTable . This argument may be null if no column namesare desired, but if a non-null array referenceis given, the array cannot contain any null norduplicate elements, and must have the same number of elementsas there are columns in the given string matrix (stringMatrix[n] for any given valid row number, n ). Parameters: stringMatrix - the string matrix. This argument cannot be null ,must not contain any null values, and each array in the matrixmust contain the same number of elements as the first (stringMatrix[0].length == stringMatrix[n].length for any given valid row number, n ). Further,this matrix must, at a minimum represent 1 rowand 1 column of items (stringMatrix.length >= 1 ,and stringMatrix[0].length >= 1 ). |
getColumn | public String[] getColumn(String columnName)(Code) | | Returns the contents of the given column.
Parameters: columnName - the name of the desired column. This argument cannot benull and must be a valid column for thisStringValuesTable . the contents of the given column. |
getColumn | public String[] getColumn(int columnNumber)(Code) | | Returns the contents of the given column.
Parameters: columnNumber - the index of the desired column (1 -based).This argument must be a valid column index for thisStringValuesTable . the contents of the given column. |
getColumnNames | public String[] getColumnNames()(Code) | | Returns the column names. This array may be empty if column names are not
being used.
the column names. |
getItem | public String getItem(int rowNumber, String columnName)(Code) | | Returns the item found in the string matrix at the given coordinate.
Parameters: rowNumber - the number of the desired row (1 -based). Thisargument must be a valid row number for thisStringValuesTable . Parameters: columnName - the name of the desired column. This argument cannot benull and must be a valid column for thisStringValuesTable . the item found in the string matrix at the given coordinate. |
getItem | public String getItem(int rowNumber, int columnNumber)(Code) | | Returns the item found in the string matrix at the given coordinate.
Parameters: rowNumber - the number of the desired row (1 -based). Thisargument must be a valid row number for thisStringValuesTable . Parameters: columnNumber - the index of the desired column (1 -based).This argument must be a valid column index for thisStringValuesTable . the item found in the string matrix at the given coordinate. |
getName | public String getName()(Code) | | Returns the table name.
the table name. |
getNumberOfColumns | public int getNumberOfColumns()(Code) | | Returns the number of columns found in the string matrix for this
StringValuesTable .
the number of columns found in the string matrix for thisStringValuesTable . |
getNumberOfRows | public int getNumberOfRows()(Code) | | Returns the number of rows found in the string matrix for this
StringValuesTable .
the number of rows found in the string matrix for thisStringValuesTable . |
getRow | public String[] getRow(int rowNumber)(Code) | | Returns the elements of the given row.
Parameters: rowNumber - the number of the desired row (1 -based). Thisargument must be a valid row number for thisStringValuesTable . the elements of the given row. |
getStringMatrix | public String[][] getStringMatrix()(Code) | | Returns the tabular data for this StringValuesTable .
the tabular data for this StringValuesTable . |
isValidColumnName | public boolean isValidColumnName(String columnName)(Code) | | Returns true if the given column name is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: columnName - the column name to verify. true if the given column name is valid for thisStringValuesTable . |
isValidColumnNumber | public boolean isValidColumnNumber(int columnNumber)(Code) | | Returns true if the given column number is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: columnNumber - the column number to verify. true if the given column number is valid for thisStringValuesTable . |
isValidRowNumber | public boolean isValidRowNumber(int row)(Code) | | Returns true if the given row number is valid for this
StringValuesTable ; returns false
otherwise.
Parameters: row - the row number to verify. true if the given index is valid for thisStringValuesTable . |
verifyColumnNames | public static synchronized String[] verifyColumnNames(String[] columnNames, String[][] stringMatrix)(Code) | | Returns the given array if it is found to indeed be valid according to
the published contract.
|
verifyStringMatrix | public static synchronized String[][] verifyStringMatrix(String[][] stringMatrix)(Code) | | Returns the given matrix if it is found to indeed be valid according to
the published contract.
|
|
|