ucar.nc2.iosp.bufr

Class Message

java.lang.Object

ucar.nc2.iosp.bufr.Message

public class Message
extends java.lang.Object

Encapsolates a complete BUFR message. A message has a DataDescriptor and one or more "datasets" aka "data subsets" aka "observations" aka "obs". Table lookup is done through getLookup().

Since:

May 9, 2008

Field Summary

Fields

Modifier and Type	Field and Description
BufrDataSection	dataSection
BufrDataDescriptionSection	dds
BufrIdentificationSection	ids
BufrIndicatorSection	is

Constructor Summary

Constructors

Constructor and Description
Message(RandomAccessFile raf, BufrIndicatorSection is, BufrIdentificationSection ids, BufrDataDescriptionSection dds, BufrDataSection dataSection)

Method Summary

Modifier and Type	Method and Description
int	calcTotalBits(java.util.Formatter out)
void	close()
boolean	containsBufrTable() Check if this message contains a BUFR table
void	dump(java.util.Formatter out)
void	dumpHeader(java.util.Formatter out)
void	dumpHeaderShort(java.util.Formatter out)
boolean	equals(java.lang.Object obj) BufrMessage is equal if they have the same dds.
java.lang.String	extractWMO()
BitCounterUncompressed	getBitCounterUncompressed(int obsOffsetInMessage) Get the offset of this obs from the start of the message data.
int	getCountedDataBits()
int	getCountedDataBytes()
int	getDDShashcode()
java.lang.String	getHeader()
BufrTableLookup	getLookup()
long	getMessageSize() Get the byte length of the entire BUFR record.
int	getNumberDatasets() Get number of datasets in this message.
byte[]	getRawBytes()
CalendarDate	getReferenceTime()
DataDescriptor	getRootDataDescriptor() Get the root of the DataDescriptor tree.
long	getStartPos()
int	getTotalBits() This is the total number of bits taken by the data in the data section of the message.
int	hashCode() Override hashcode to be consistent with equals.
boolean	isBitCountOk()
boolean	isTablesComplete() Check if all descriptors were found in the tables.
void	setHeader(java.lang.String header)
void	setRawBytes(byte[] raw)
void	setStartPos(long startPos)
void	showMissingFields(java.util.Formatter out)
boolean	usesLocalTable()

Methods inherited from class java.lang.Object

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

Field Detail

is

public BufrIndicatorSection is

ids

public BufrIdentificationSection ids

dds

public BufrDataDescriptionSection dds

dataSection

public BufrDataSection dataSection

Constructor Detail

Message

public Message(RandomAccessFile raf,
               BufrIndicatorSection is,
               BufrIdentificationSection ids,
               BufrDataDescriptionSection dds,
               BufrDataSection dataSection)
        throws java.io.IOException

Throws:

java.io.IOException

Method Detail

close

public void close()
           throws java.io.IOException

Throws:

java.io.IOException

getNumberDatasets

public int getNumberDatasets()

Get number of datasets in this message.

Returns:

number of datasets in this message

getReferenceTime

public CalendarDate getReferenceTime()

setHeader

public void setHeader(java.lang.String header)

getHeader

public java.lang.String getHeader()

setStartPos

public void setStartPos(long startPos)

getStartPos

public long getStartPos()

setRawBytes

public void setRawBytes(byte[] raw)

getRawBytes

public byte[] getRawBytes()

extractWMO

public java.lang.String extractWMO()

getMessageSize

public long getMessageSize()

Get the byte length of the entire BUFR record.

Returns:

length in bytes of BUFR record

getRootDataDescriptor

public DataDescriptor getRootDataDescriptor()

Get the root of the DataDescriptor tree.

Returns:

root DataDescriptor

usesLocalTable

public boolean usesLocalTable()
                       throws java.io.IOException

Throws:

java.io.IOException

containsBufrTable

public boolean containsBufrTable()
                          throws java.io.IOException

Check if this message contains a BUFR table

Returns:

true if message contains a BUFR table

Throws:

java.io.IOException - on read error

isTablesComplete

public boolean isTablesComplete()
                         throws java.io.IOException

Check if all descriptors were found in the tables.

Returns:

true if all dds were found.

Throws:

java.io.IOException - on read error

getLookup

public BufrTableLookup getLookup()

isBitCountOk

public boolean isBitCountOk()
                     throws java.io.IOException

Throws:

java.io.IOException

getCountedDataBytes

public int getCountedDataBytes()

getCountedDataBits

public int getCountedDataBits()

getBitCounterUncompressed

public BitCounterUncompressed getBitCounterUncompressed(int obsOffsetInMessage)

Get the offset of this obs from the start of the message data. Use only for non compressed data

Parameters:

obsOffsetInMessage - index of obs in the message

Returns:

offset in bits

public int getBitOffset(int obsOffsetInMessage) { if (dds.isCompressed()) throw new IllegalArgumentException("cant call BufrMessage.getBitOffset() on compressed message");

if (!root.isVarLength) return root.total_nbits * obsOffsetInMessage;

getTotalBits(); // make sure its been set return nestedTableCounter[obsOffsetInMessage].getStartBit(); }

getTotalBits

public int getTotalBits()

This is the total number of bits taken by the data in the data section of the message. This is the counted number.

Returns:

total number of bits

calcTotalBits

public int calcTotalBits(java.util.Formatter out)

hashCode

public int hashCode()

Override hashcode to be consistent with equals.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code of dds.getDescriptors()

getDDShashcode

public int getDDShashcode()

equals

public boolean equals(java.lang.Object obj)

BufrMessage is equal if they have the same dds.

Overrides:

equals in class java.lang.Object

Parameters:

obj - other BufrMessage

Returns:

true if equals

showMissingFields

public void showMissingFields(java.util.Formatter out)
                       throws java.io.IOException

Throws:

java.io.IOException

dump

public void dump(java.util.Formatter out)

dumpHeader

public void dumpHeader(java.util.Formatter out)

dumpHeaderShort

public void dumpHeaderShort(java.util.Formatter out)