To load a sample into StreamBase Studio:
-
If you currently have one of the Welcome pages open in Studio, click the Workbench icon to close the Welcome page and open the SB Authoring Perspective. The Workbench icon is circled in red in the following:
-
From Studio's top-level menu, select → .
-
The dialog first opens with all categories collapsed, as shown above.
To locate a sample of interest, you can:
-
Type a search string in the type filter text field.
-
Open the categories of interest and browse each list. (Note that some adapter samples are listed in more than one category.)
-
-
Select one or more samples from the Load Sample Projects dialog. Hold the Ctrl key while clicking to make a multiple selection.
-
Specify whether or not to open the HTML README for the selected samples. Studio remembers your setting of this option.
-
Click .
The samples you load have the following characteristics:
-
The Load Sample Projects dialog remembers the collapsed or expanded state of the category lists.
-
StreamBase Studio creates a separate project for each sample you load.
-
Exception: for the
operatorsample group, Studio creates a single project and all the individual operator's sample applications are imported into the same project folder.
-
-
You can reload any sample any time. If your workspace already has a copy of that sample, Studio creates a new copy, appending a number to the new copy's project folder name. This lets you load several copies of the same sample to experiment in different ways.
-
If a sample contains a custom function or client application, Studio automatically loads those and any specified configuration settings onto StreamBase Server when you run the sample.
-
If Studio loads a JAR file as part of a sample, it automatically adds the StreamBase Client API to the project's Java build path. The usual practice, however, is to provide Java source files in the
java-srcsubfolder, which Studio builds automatically after loading the sample's project.
By default, the StreamBase sample files are installed in:
- On 32-bit Windows
-
C:\Program Files\StreamBase Systems\StreamBase.n.m\sample\... - On 64-bit Windows
-
C:\Program Files (x86)\StreamBase Systems\StreamBase.n.m\sample\... - On UNIX
-
/opt/streambase/sample/...
When you load a sample into StreamBase Studio, Studio creates a project folder in
your Studio workspace and copies the sample project's files there. StreamBase Systems
strongly recommends that you use the workspace copy of the sample, especially on
UNIX, where you may not have write access to /opt/streambase. See Default Installation Directories for the location of your Studio
workspace.
A number of StreamBase samples, such as client and
buffering, have C++ and Java code that can be
modified and rebuilt. In order to rebuild the C++ executables on Windows, you need to
have one of the supported
Microsoft Visual Studio versions installed.