Class BasicDataset
- java.lang.Object
- 
- com.inductiveautomation.ignition.common.AbstractDataset
- 
- com.inductiveautomation.ignition.common.BasicDataset
 
 
- 
- All Implemented Interfaces:
- Dataset,- java.io.Serializable
 - Direct Known Subclasses:
- ColumnAttributesDataSet,- JsonDataset
 
 public class BasicDataset extends AbstractDataset - See Also:
- Serialized Form
 
- 
- 
Field SummaryFields Modifier and Type Field Description protected java.lang.Object[][]dataprotected static XMLReaderPoolxmlReaderPoolXML Reader pool used for deserializing xml serialized data- 
Fields inherited from class com.inductiveautomation.ignition.common.AbstractDataset_columnNamesLowercase, columnNames, columnTypes, qualityCodes
 
- 
 - 
Constructor SummaryConstructors Constructor Description BasicDataset()BasicDataset(Dataset copy)BasicDataset(java.lang.String[] columnNames, java.lang.Class<?>[] columnTypes, java.lang.Object[][] data)BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes)BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, Dataset copy)BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data)Constructor that takes all of the information needed to create a populated dataset.BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data, QualityCode[][] quality)BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data, DataQuality[][] quality)Deprecated.
 - 
Method SummaryAll Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description intbinarySearch(int column, java.lang.Object key)Performs a binary search on the specified column, looking for the specified key.booleancolumnContainsNulls(int col)booleandatasetContainsNulls()java.lang.Object[][]getData()intgetRowCount()Return the number of rows in this datasetjava.lang.ObjectgetValueAt(int row, int col)Returns the value in the dataset at the given location.voidsetAllDirectly(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data)This function was added in 1.5.5 to solve a dataset serialization problem.voidsetColumnNames(java.util.List<java.lang.String> list)voidsetColumnTypes(java.util.List<java.lang.Class<?>> list)voidsetData(java.lang.Object[][] list)Deprecated.voidsetDataDirectly(java.lang.Object[][] list)Sets the data array, and fires a change event.voidsetFromXML(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.String encodedData, int rowCount)voidsetValueAt(int row, int col, java.lang.Object value)Not part of the public Dataset APIjava.lang.StringtoString()- 
Methods inherited from class com.inductiveautomation.ignition.common.AbstractDatasetconvertToQualityCodes, getAsXML, getBulkQualityCodes, getColumnCount, getColumnIndex, getColumnName, getColumnNames, getColumnType, getColumnTypes, getPrimitiveValueAt, getQualityAt, getValueAt, hasQualityData, setDirty
 - 
Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 - 
Methods inherited from interface com.inductiveautomation.ignition.common.DatasetgetColumnAsList
 
- 
 
- 
- 
- 
Field Detail- 
xmlReaderPoolprotected static XMLReaderPool xmlReaderPool XML Reader pool used for deserializing xml serialized data
 - 
dataprotected java.lang.Object[][] data 
 
- 
 - 
Constructor Detail- 
BasicDatasetpublic BasicDataset() 
 - 
BasicDatasetpublic BasicDataset(java.lang.String[] columnNames, java.lang.Class<?>[] columnTypes, java.lang.Object[][] data)
 - 
BasicDatasetpublic BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data)Constructor that takes all of the information needed to create a populated dataset.- Parameters:
- columnNames- The column names of the dataset. Must match the length of columnTypes and data.length
- columnTypes- The types of each column. Must match the length of columnNames and data.length
- data- The raw data. An array of columns of data. (NOT rows.)
 
 - 
BasicDataset@Deprecated public BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data, DataQuality[][] quality)Deprecated.Needed for deserialization backwards compatibility. Do not use this method for new code.
 - 
BasicDatasetpublic BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes)
 - 
BasicDatasetpublic BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data, QualityCode[][] quality)
 - 
BasicDatasetpublic BasicDataset(@Nonnull Dataset copy)
 - 
BasicDatasetpublic BasicDataset(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, Dataset copy)
 
- 
 - 
Method Detail- 
getValueAtpublic java.lang.Object getValueAt(int row, int col)Description copied from interface:DatasetReturns the value in the dataset at the given location.
 - 
getRowCountpublic int getRowCount() Description copied from interface:DatasetReturn the number of rows in this dataset
 - 
setValueAtpublic void setValueAt(int row, int col, java.lang.Object value) throws java.lang.ClassCastExceptionNot part of the public Dataset API- Throws:
- java.lang.ClassCastException
 
 - 
binarySearchpublic int binarySearch(int column, java.lang.Object key)Performs a binary search on the specified column, looking for the specified key. Column MUST be sorted in ascending order with NULL values LAST- Returns:
- index of the search key, if it is contained in the list; otherwise, (-(insertion point) - 1). The insertion point is defined as the point at which the key would be inserted into the list: the index of the first element greater than the key, or list.size(), if all elements in the list are less than the specified key. Note that this guarantees the return value will be greater than or equal to 0, but only if the key is found.
 
 - 
setFromXMLpublic void setFromXML(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.String encodedData, int rowCount)
 - 
getDatapublic java.lang.Object[][] getData() 
 - 
setDataDirectlypublic void setDataDirectly(java.lang.Object[][] list) Sets the data array, and fires a change event. The data array of a Dataset is a double object array, with the first index indicating column, and the second indicating row.Returns: 
 - 
setData@Deprecated public void setData(java.lang.Object[][] list) Deprecated.This setter function should ONLY BE CALLED DURING DE-SERIALIZATION, which means that you should NEVER CALL THIS FUNCTION DIRECTLY.- See Also:
- setDataDirectly(Object[][])
 
 - 
setAllDirectlypublic void setAllDirectly(java.util.List<java.lang.String> columnNames, java.util.List<java.lang.Class<?>> columnTypes, java.lang.Object[][] data)This function was added in 1.5.5 to solve a dataset serialization problem. On a component that starts out with a non-null dataset, during de-serialization, the three set functions were called on that dataset. This caused three fireChange()s, with the first two causing the dataset to be in an inconsistent state. See the DataSetPersistenceDelegate.
 - 
columnContainsNullspublic boolean columnContainsNulls(int col) 
 - 
datasetContainsNullspublic boolean datasetContainsNulls() 
 - 
toStringpublic java.lang.String toString() - Overrides:
- toStringin class- java.lang.Object
 
 - 
setColumnNamespublic void setColumnNames(java.util.List<java.lang.String> list) - Overrides:
- setColumnNamesin class- AbstractDataset
 
 - 
setColumnTypespublic void setColumnTypes(java.util.List<java.lang.Class<?>> list) - Overrides:
- setColumnTypesin class- AbstractDataset
 
 
- 
 
-