Record class

Record class

Data is converted between byte arrays containing the server data and Java objects. Methods are provided in the record class to do the following:

• Retrieve the contents of a field, by index or by name, as a Java object.
• Retrieve the number of fields in the record.
• Set the contents of a field, by index or by name, with a Java object.
• Retrieve the contents of the record as server data into a byte array or output stream.
• Set the contents of the record from a byte array or an input stream.
• Convert the contents of the record to a String.

Example: Reading a record

The following example uses the record format created in the record format example:

     // Assume data queue setup work has already been done. Now read a
     // record from the data queue.
     DataQueueEntry dqe = dq.read();

     // The data from the data queue is now in a data queue entry. Get
     // the data out of the data queue entry and put it in the record.
     // We obtain a default record from the record format object and
     // initialize it with the data from the data queue entry.
     Record dqRecord = rf.getNewRecord(dqe.getData());

     // Now that the data is in the record, pull the data out one
     // field at a time, converting the data as it is removed. The result
     // is data in a Java object that the program can now process.
     Integer msgNumber = (Integer) dqRecord.getField("msgNumber");
     String  msgTime   = (String)  dqRecord.getField("msgTime");
     String  msgText   = (String)  dqRecord.getField("msgText");