|
Java DTV API 1.3 18-Nov-2009 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.sun.dtv.filtering.DataSection
public class DataSection
This class encapsulates a Transport Stream data section
This object is cloneable. Modifying a cloned object in no way affect the original object. Additionally, access to raw section data is also provided through a copy mechanism. Editing such data will not affect any Section object's internal data nor will it affect the contents of a transport or elementary stream.
Method Summary | |
---|---|
Object |
clone()
Create a copy of this DataSection object. |
boolean |
getAvailable()
Retrieve whether a DataSection object contains valid data. |
boolean |
getCurrentNextIndicator()
Retrieve the value of the corresponding field from a data section header. |
int |
getLastSectionNumber()
Retrieve the value of the corresponding field from a data section header. |
boolean |
getPrivateIndicator()
Retrieve the value of the corresponding field from a data section header. |
byte |
getSectionByte(int index)
Retrieve a single data byte at the provided index from the filtered section. |
DataSectionDataBuffer |
getSectionData()
Retrieve the data from the filtered section in the DataSection object. |
DataSectionDataBuffer |
getSectionData(int index,
int length)
Retrieve data from the filtered section using the provided index and length. |
int |
getSectionLength()
Retrieve the value of the corresponding field from a data section header. |
int |
getSectionNumber()
Retrieve the value of the corresponding field from a data section header. |
boolean |
getSectionSyntaxIndicator()
Retrieve the value of the corresponding field from a data section header. |
int |
getTableId()
Retrieve the value of the corresponding field from an data section header. |
int |
getTableIdExtension()
Retrieve the value of the corresponding field from a data section header. |
short |
getVersionNumber()
Retrieve the value of the corresponding field from a data section header. |
void |
release()
This method marks section data object for use because the data is no longer useful or it has been cloned. |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public DataSectionDataBuffer getSectionData() throws DataUnavailableException
DataSection
object.
A new copy of the section data will be created for each call
(i.e. everything after the length field, including the section header and not including a CRC check).
DataSectionDataBuffer
containing the requested data
DataUnavailableException
- if no valid data is available.public DataSectionDataBuffer getSectionData(int index, int length) throws DataUnavailableException, IndexOutOfBoundsException
index
- start index (the first byte of section (the table_id field) has index 1)length
- the length
DataSectionDataBuffer
containing the requested data
DataUnavailableException
- if no valid data is available.
IndexOutOfBoundsException
- if the requested data is not in the range of data in the section.public byte getSectionByte(int index) throws DataUnavailableException, IndexOutOfBoundsException
index
- the index (the first byte of section (the table_id field) has index 1)
DataUnavailableException
- if no valid data is available.
IndexOutOfBoundsException
- if the requested data is not in the range of data in the section.public int getTableId()
Note: No exceptions are thrown as this field should ALWAYS be available.
public boolean getSectionSyntaxIndicator()
Note: No exceptions are thrown as this field should ALWAYS be available.
public boolean getPrivateIndicator()
Note: No exceptions are thrown as this field should ALWAYS be available.
public int getSectionLength()
Note: No exceptions are thrown as this field should ALWAYS be available.
public int getTableIdExtension() throws DataUnavailableException
DataUnavailableException
- if no valid data is available.public short getVersionNumber() throws DataUnavailableException
DataUnavailableException
- if no valid data is available.public boolean getCurrentNextIndicator() throws DataUnavailableException
DataUnavailableException
- if no valid data is available.public int getSectionNumber() throws DataUnavailableException
DataUnavailableException
- if no valid data is available.public int getLastSectionNumber() throws DataUnavailableException
DataUnavailableException
- if no valid data is available.public boolean getAvailable()
DataSection
object contains valid data.
public void release()
RingFilter
objects to re-use
the section data object for a subsequent filter match.
public Object clone()
DataSection
object.
Any modifications to this copied object will not affect the original object that
has been cloned.
clone
in class Object
|
Java DTV API 1.3 18-Nov-2009 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |