Binary File Reader/Writer Adapter Sample

Contents

Importing This Sample into StreamBase Studio
Sample Location
Running This Sample in StreamBase Studio
Running This Sample in Terminal Windows

This sample demonstrates the use of the StreamBase Binary File Reader and Writer Adapters.

Importing This Sample into StreamBase Studio

In StreamBase Studio, import this sample with the following steps:

  • From the top menu, click File → Load StreamBase Sample.

  • Select this sample from the Embedded Input Adapters list.

  • Click OK.

StreamBase Studio creates a project for this sample.

Sample Location

By default, the sample files are installed in:

On Windows

C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\adapter\embedded\binaryrw\

On UNIX

/opt/streambase/sample/adapter/embedded/binaryrw/

When you load the sample into StreamBase Studio, Studio copies the sample project's files to your Studio workspace. StreamBase Systems recommends that you use the workspace copy of the sample, especially on UNIX, where you may not have write access to /opt/streambase. In the default installation, the path to this sample in your Studio workspace is: 

UNIX:       
  ~/streambase-studio-n.m-workspace/
      sample_adapter_embedded_binaryrw
Windows XP:
  C:\Documents and Settings\username\My Documents\
      StreamBase Studio n.m Workspace\sample_adapter_embedded_binaryrw
Windows 7 and Windows Vista:
  C:\Users\username\Documents\StreamBase Studio n.m Workspace\
      sample_adapter_embedded_binaryrw

Running This Sample in StreamBase Studio

  1. In the Package Explorer view, double-click myfile.csv to see the CSV records that will be converted to binary.

  2. Double-click to open the sample application, binaryrw.sbapp.

  3. Click the Run button. This opens the Test/Debug perspective and starts the application.

  4. In the Manual Input view, select the DoWrite input stream and and press Send Data.

  5. Look for tuples emitted on the BinaryDataWritten output stream and observe they contain the values from myfile.csv.

  6. Select the DoRead input stream and and press Send Data.

  7. Look for tuples emitted on the BinaryDataRead output stream and observe they contain the values from myfile.csv.

  8. When done, press F9 or click the Stop Running Application button.

Running This Sample in Terminal Windows

This section describes how to run the sample in UNIX terminal windows or Windows command prompt windows. On Windows, be sure to use the StreamBase Command Prompt from the Start menu as described in the Test/Debug Guide, not the default command prompt.

  1. Open three terminal windows on UNIX, or three StreamBase Command Prompt s on Windows. In each window, navigate to your workspace copy of the sample, as described above.

  2. In window 1, type:

    sbd binaryrw.sbapp

  3. In window 2, type:

    sbc dequeue -v

    This window will display the tuples dequeued from the adapter's output port.

  4. In window 3, type the following command to cause the sample application to write the CSV file contents to a binary file:

    echo null | sbc enqueue DoWrite

  5. Observe in window 2 that tuples are emitted from the BinaryDataWritten stream.

  6. In window 3, type the following command to cause the sample application to read the read and display the contents of the binary file:

    echo null | sbc enqueue DoRead

  7. Observe in window 2 that tuples are emitted from the BinaryDataRead stream.

  8. In window 3, type the following command to terminate the server and dequeuer:

    sbadmin shutdown