com.sun.dtv.filtering
Class CircularFilter

java.lang.Object
  com.sun.dtv.filtering.DataSectionFilter
      com.sun.dtv.filtering.CircularFilter

All Implemented Interfaces:

Cloneable

public class CircularFilter
extends DataSectionFilter

This class defines a section filter intended to be used to capture a continuous stream of data sections without needing to continually restart the filter.

A DataSectionAvailableEvent will be generated each time a DataSection is captured. A CircularFilter object has a preset number of DataSection objects defined at construction time. Successfully filtered section data is loaded into available DataSection objects sequentially.

Filtering will stop only when a timeout is reached since the last successfully filtered section, or if no more DataSection objects are available for writing.

Applications wishing filtering to proceed indefinitely must use the release method of the DataSection in order for them to be re-used for new section filtering matches.

See Also:

DataSection, DataSection.release(), DataSectionFilter

Method Summary

DataSection[]

getSections() This method returns the DataSection array for the CircularFilter The application needs to verify which objects contain valid data.

Methods inherited from class com.sun.dtv.filtering.DataSectionFilter

addSectionFilterListener, clearGreaterThanFilter, clearLessThanFilter, clearPositiveFilter, clearTableId, clearXorFilter, removeSectionFilterListener, setGreaterThanFilter, setLessThanFilter, setPid, setPositiveFilter, setTableId, setTimeOut, setXorFilter, startFiltering, stopFiltering

Methods inherited from class java.lang.Object

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

Method Detail

getSections

public DataSection[] getSections()

This method returns the DataSection array for the CircularFilter The application needs to verify which objects contain valid data.

Returns:

The array of DataSection objects