com.crankuptheamps.client

Class NVFIXBuilder

java.lang.Object

com.crankuptheamps.client.NVFIXBuilder

public class NVFIXBuilder
extends java.lang.Object

Used to build up message strings for NVFIX. Example Usage:

 
   // Create a string for the topic
   String topic = "messages";

   // Create a builder with 1024 bytes of initial capacity,
   // using the default 0x01 delimiter.
   NVFIXBuilder builder = new NVFIXBuilder(1024, (byte)1);

   // Example publishing loop reusing the builder.
   for (int i = 1; 1 <= 100; ++i) {
      // Add fields for message.
      builder.append(0, "" + i);
      builder.append(1, "Here's another field");
      builder.append(3, "1234567890");

      client.publish(topic.getBytes(), 0, topic.length(),
          builder.getBytes(), 0, builder.getSize());

      // Reuse the builder for the next message by clearing it.
      builder.clear();

 
 

Constructor Summary

Constructors

Constructor and Description
NVFIXBuilder(int capacity, byte fieldSeparator)

Method Summary

Modifier and Type	Method and Description
NVFIXBuilder	append(java.lang.String tag, byte[] value, int offset, int length) Appends a tag and value pair contained within a byte buffer to the FIX message.
NVFIXBuilder	append(java.lang.String tag, java.lang.String value) Appends a tag and value pair to the FIX message.
void	clear() Clears the current builder, resetting it to empty.
byte[]	getBytes() Returns the byte array containing the NVFIX message.
int	getSize() Returns the number of bytes in the byte array containing the NVFIX message.

Methods inherited from class java.lang.Object

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

Constructor Detail

NVFIXBuilder

public NVFIXBuilder(int capacity,
                    byte fieldSeparator)

Method Detail

clear

public void clear()

Clears the current builder, resetting it to empty.

getSize

public int getSize()

Returns the number of bytes in the byte array containing the NVFIX message.

Returns:

number of valid bytes in the byte array

getBytes

public byte[] getBytes()

Returns the byte array containing the NVFIX message. The number of valid bytes within the buffer is returned from getSize().

Returns:

byte array containing the NVFIX message

append

public NVFIXBuilder append(java.lang.String tag,
                           byte[] value,
                           int offset,
                           int length)
                    throws CommandException

Appends a tag and value pair contained within a byte buffer to the FIX message.

Parameters:

tag - The String NVFIX tag to append

value - The byte buffer containing the FIX value to append.

offset - The starting location of the value inside the byte buffer.

length - The length of the value inside the byte buffer.

Returns:

A reference to this object.

Throws:

CommandException - If the tag or value argument is not convertible to ISO-8859-1.

append

public NVFIXBuilder append(java.lang.String tag,
                           java.lang.String value)
                    throws CommandException

Appends a tag and value pair to the FIX message.

Parameters:

tag - The string FIX tag to append

value - The FIX value for the tag to append. The value will be converted to an ISO-8859-1 byte array for writing.

Returns:

A reference to this object.

Throws:

CommandException - If the tag or value argument is not convertible to ISO-8859-1.