com.crystaldecisions.sdk.occa.report.data
Class DataSet

java.lang.Object
  extended by com.crystaldecisions.sdk.occa.report.data.DataSet
All Implemented Interfaces:
IDataSet, IClone

public class DataSet
extends java.lang.Object
implements IDataSet, IClone

The DataSet object is a runtime data source that determines the set of data that is displayed by a report. You can create a data set by adding tables, as well as the rowset data that correspond to these tables, to the DataSet object. Once the data set has been created, you can add it to the report with the DatabaseController object’s addDataSource method, and set it with the setDataSource method. The setDataSource method can also be used to replace one data set with another. The only restriction is that the fields in the new data set match the fields originally used to design the report.

If you create a report based on a data set, the data that is used is not saved with the report. To populate the report with data the next time you open it, you must either re-apply the data source to see current data, or access a saved version of the data source for preview.

Use the IDataSet interface to manipulate this object.


Constructor Summary
DataSet()
           
DataSet(IDataSet src)
           
 
Method Summary
 java.lang.Object clone(boolean deepClone)
           
 void copyTo(java.lang.Object destObject, boolean deepCopy)
           
 java.lang.Object createMember(java.lang.String eleName, org.xml.sax.Attributes attrs, XMLSerializationContext ctxt, java.util.Map objState, boolean[] bLoaded)
           
 void endElement(java.lang.String eleName, java.util.Map objState)
           
 Rowsets getRowsets()
           Gets the collection of rowsets corresponding to the data set tables.
 TableJoins getTableJoins()
           
 Tables getTables()
           Gets the collection of database tables that are used as the source of the data set.
 boolean hasContent(java.lang.Object srcDataSet)
           
 void readElement(java.lang.String eleName, java.lang.String sVal, org.xml.sax.Attributes attrs, java.util.Map objState)
           
 void save(XMLWriter writer, java.lang.String sTag, XMLSerializationContext ctxt)
           
 void save(XMLWriter writer, XMLSerializationContext ctxt)
           
 void saveContents(XMLWriter writer, XMLSerializationContext ctxt)
           
 void setRowsets(Rowsets rowsets)
           Sets the collection of rowsets corresponding to the data set tables.
 void setTableJoins(TableJoins tableJoins)
           Sets the information about the linking between the tables in the data set.
 void setTables(Tables tables)
           Sets the collection of database tables that are used as the source of the data set.
 void startElement(java.lang.String eleName, java.util.Map objState, org.xml.sax.Attributes attrs)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DataSet

public DataSet(IDataSet src)

DataSet

public DataSet()
Method Detail

clone

public java.lang.Object clone(boolean deepClone)

copyTo

public void copyTo(java.lang.Object destObject,
                   boolean deepCopy)

createMember

public java.lang.Object createMember(java.lang.String eleName,
                                     org.xml.sax.Attributes attrs,
                                     XMLSerializationContext ctxt,
                                     java.util.Map objState,
                                     boolean[] bLoaded)

endElement

public void endElement(java.lang.String eleName,
                       java.util.Map objState)

getRowsets

public Rowsets getRowsets()
Description copied from interface: IDataSet

Gets the collection of rowsets corresponding to the data set tables.

Specified by:
getRowsets in interface IDataSet
Returns:
Rowsets the Rowsets collection

getTableJoins

public TableJoins getTableJoins()
Specified by:
getTableJoins in interface IDataSet

getTables

public Tables getTables()
Description copied from interface: IDataSet

Gets the collection of database tables that are used as the source of the data set.

Specified by:
getTables in interface IDataSet
Returns:
the Tables collection

hasContent

public boolean hasContent(java.lang.Object srcDataSet)

readElement

public void readElement(java.lang.String eleName,
                        java.lang.String sVal,
                        org.xml.sax.Attributes attrs,
                        java.util.Map objState)

save

public void save(XMLWriter writer,
                 XMLSerializationContext ctxt)
          throws java.io.IOException
Throws:
java.io.IOException

save

public void save(XMLWriter writer,
                 java.lang.String sTag,
                 XMLSerializationContext ctxt)
          throws java.io.IOException
Throws:
java.io.IOException

saveContents

public void saveContents(XMLWriter writer,
                         XMLSerializationContext ctxt)
                  throws java.io.IOException
Throws:
java.io.IOException

setRowsets

public void setRowsets(Rowsets rowsets)
Description copied from interface: IDataSet

Sets the collection of rowsets corresponding to the data set tables.

Specified by:
setRowsets in interface IDataSet
Parameters:
rowsets - the Rowsets collection

setTableJoins

public void setTableJoins(TableJoins tableJoins)
Description copied from interface: IDataSet

Sets the information about the linking between the tables in the data set.

Specified by:
setTableJoins in interface IDataSet
Parameters:
tableJoins - the TableJoins collection

setTables

public void setTables(Tables tables)
Description copied from interface: IDataSet

Sets the collection of database tables that are used as the source of the data set.

Specified by:
setTables in interface IDataSet
Parameters:
tables - the Tables collection

startElement

public void startElement(java.lang.String eleName,
                         java.util.Map objState,
                         org.xml.sax.Attributes attrs)