borland Packages  Class Hierarchy  jbcl.dataset Package  Index 

DataSetView component

java.lang.Object
   +----borland.jbcl.dataset.ReadRow
           +----borland.jbcl.dataset.ReadWriteRow
                   +----borland.jbcl.dataset.DataSet
                           +----borland.jbcl.dataset.DataSetView

About the DataSetView component

Constructors  Properties  Methods  Event Listeners

Implements AccessListener, MasterNavigateListener, StatusListener, Serializable, EventListener

The DataSetView component extends DataSet functionality by presenting an alternate view of the data in the DataSet. The DataSetView itself has no storage of data but sees all the unfiltered data contained in its storageDataSet property to which you can apply a different sort order and filter criterion than the original StorageDataSet. The navigation of the DataSetView data is separate from that of its StorageDataSet.

The use of a DataSetView component is optional. If you only need a single sort or filter criterion at a time in your application, you may apply those settings directly on the QueryDataSet, ProcedureDataSet, or TableDataSet. If however you wish to present the data in the DataSet in multiple "views", the DataSetView provides that capability without the need for multiple objects that each store data.

When a DataSetView shares the data storage of a DataSet with another DataSetView, each DataSetView sees edits that both make to the data. Calling the saveChanges() method saves changes that were made to both. Both also share column properties such as edit and display masks, and so on. You cannot, however, display the DataSetView component's columns in the JBuilder UI Designer nor set its column properties (including persistent) through the UI or programmatically. This is because the DataSetView component doesn't have its own data storage.

The DataSetView component also allows for an additional level of indirection which provides for greater flexibility when changing the binding of your UI components. If you anticipate the need to rebind your UI components and have several of them, bind the components to a DataSetView instead of directly to the StorageDataSet. When you need to rebind, change the DataSetView component to the appropriate StorageDataSet, thereby making a single change that affects all UI components connected to the DataSetView as well.

The DataSetView component extends the functionality provided by its superclass (DataSet). The close() method is inherited by DataSetView and has particular importance with this component as it must be called to ensure that the component is garbage collected. Otherwise, a DataSetView component cannot be garbage collected until its associated StorageDataSet is garbage collected.


DataSetView constructors

DataSetView properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in borland.jbcl.dataset.DataSet

Properties implemented in borland.jbcl.dataset.ReadRow

Properties implemented in borland.jbcl.dataset.ReadWriteRow

Properties implemented in java.lang.Object

DataSetView methods

Methods implemented in borland.jbcl.dataset.DataSet

Methods implemented in borland.jbcl.dataset.ReadWriteRow

Methods implemented in java.lang.Object

DataSetView event listeners


DataSetView constructors

DataSetView()

  public DataSetView()
Creates a DataSetView component.

DataSetView properties

masterLink

 public final MasterLinkDescriptor getMasterLink()
 public synchronized void setMasterLink(borland.jbcl.dataset.MasterLinkDescriptor descriptor)
Specifies the MasterLinkDescriptor object that describes the relationship between this DataSetView and another DataSet.

storageDataSet

 public synchronized void setStorageDataSet(borland.jbcl.dataset.StorageDataSet dataSetStore)
Write-only property that specifies the StorageDataSet object that contains the data storage that the DataSetView component accesses. Use the storageDataSet property of the DataSet class to set this property.

DataSetView event listeners

This component is a source for the following event sets. For information on the JBCL event sets, see Events in JBCL.

access

 public final void addAccessListener(borland.jbcl.dataset.AccessListener listener)
 public final void removeAccessListener(borland.jbcl.dataset.AccessListener listener)

dataChange

 public final void addDataChangeListener(borland.jbcl.dataset.DataChangeListener listener)
 public final void removeDataChangeListener(borland.jbcl.dataset.DataChangeListener listener)

masterNavigate

 public final void addMasterNavigateListener(borland.jbcl.dataset.MasterNavigateListener listener)
 public final void removeMasterNavigateListener(borland.jbcl.dataset.MasterNavigateListener listener)

navigation

 public final void addNavigationListener(borland.jbcl.dataset.NavigationListener listener)
 public final void removeNavigationListener(borland.jbcl.dataset.NavigationListener listener)

open

 public final void addOpenListener(borland.jbcl.dataset.OpenListener listener)
 public final void removeOpenListener(borland.jbcl.dataset.OpenListener listener)

rowFilter

 public final void addRowFilterListener(borland.jbcl.dataset.RowFilterListener listener)
 public final void removeRowFilterListener(borland.jbcl.dataset.RowFilterListener listener)

status

 public final void addStatusListener(borland.jbcl.dataset.StatusListener listener)
 public final void removeStatusListener(borland.jbcl.dataset.StatusListener listener)