Configure Visual Studio 8.0 Projects to Build Clients

Contents

Method 1: Copy Sample Project Files
Method 2: New or Existing Project

To build StreamBase C++ clients for Windows using Visual C++ 8.0 (Visual Studio 2005), configure your Visual C++ projects as described on this page.

Alternate Project Types

  • To build C++ functions for 32-bit Windows, you must use Visual C++ 7.1 and must configure your projects as described in Configure VC 7.1 for Functions.

  • To build C++ functions for 64-bit Windows, you must use Visual C++ 8.0 and must configure your projects as described in Configure VC 8.0 for Functions.

To configure Visual C++ 8.0 projects to build StreamBase clients, you can either:

  • Method 1: Copy the project files from the StreamBase client sample and edit them.

  • Method 2: Create a new project from scratch or modify an existing Visual Studio project.

Method 1: Copy Sample Project Files

  1. Copy the streambase-install-dir\sample\client folder to your Visual C++ workspace. For clarity, keep your Visual C++ workspace in a separate location from your StreamBase Studio workspace.

    Note

    You must copy this folder from the StreamBase installation directory. Do not make a copy of the client sample in your StreamBase Studio workspace, because the Studio workspace sample does not have the Visual Studio .sln and .vcproj files.

  2. Optional. You can remove unnecessary files from the copied project folder. These files are part of the Java and Python client samples and are not used by the C++ client. Remove the java-src folder and all files with the following extensions: .classpath, .project, .html, .txt, .exe, .launch, .csv, .sbapp, .sbfs, .py.

  3. Locate the client-vc8.sln file. You can optionally rename this file before opening it the first time. Preserve the .sln extension, and choose a basename that reflects the purpose of the intended client. For example, rename client-vc8.sln to AcctDeptLoader.sln.

  4. Start Visual C++ 8.0. Use File → Open → Project to load client-vc8.sln (or your renamed solution file).

  5. Copy or rename one of the existing projects in the Solution Explorer. For example, if you are creating an enqueuing client, rename SimpleEnqueuer to AcctDeptLoader.

  6. In your renamed project folder, rename SimpleEnqueuer.cpp as appropriate for your project (such as AcctDeptLoader.cpp).

  7. Remove the other two projects from your solution.

  8. Right-click your project in the Solution Explorer and select Properties from the context menu.

  9. Locate the places in the project properties that use ${STREAMBASE_HOME} and replace those with the absolute path to your top-level StreamBase installation directory. In general, do this by clicking in the specified setting row, then click the button with three dots to open the Additional Directories dialog. Select a row in this dialog and use the second three-dot button to navigate to your StreamBase installation's directory.

    On the Configuration drop-down menu, select All Configurations.

    Make sure the following settings are in place:

    Property Folder Property Page Property Row Setting
    C/C++ General Additional Include Directories Replace the path that uses ${STREAMBASE_HOME} with the absolute path to the include directory of your StreamBase installation: streambase-install-dir\include
    Linker General Additional Library Directories Replace the path that uses ${STREAMBASE_HOME} with the absolute path to the lib\$(ConfigurationName) directory of your StreamBase installation. The macro $(ConfigurationName) is replaced at runtime with either debug or release to match the current Solution Configuration setting: streambase-install-dir\lib\$(ConfigurationName)

  10. Build your project and verify that a working client executable is generated.

  11. Begin customizing the source file for your client.

Method 2: New or Existing Project

Whether using an existing Visual C++ project or starting with a new one, make sure the project's settings match those described in the following steps. All project settings not listed here are optional, and can be changed to match the requirements of your project.

  1. In Visual C++ Studio, select File → New → Project.

    1. In the New Project dialog, select Visual C++ Projects → Win32, then select either Win32 Console Application or Win32 Project, depending the type of client you are creating.

    2. In the Name field, enter a name for your project.

    3. In the Win32 Application Wizard dialog, select Application Settings.

    4. Under Application Type, select Console application or Windows application, depending on the type of client you are creating.

    5. If you already have a C++ file that contains your function, then under Additional options, select Empty project. If you are starting from scratch, leave this check box cleared.

    6. Under Additional options, clear the Precompiled header check box.

    7. Click Finish. If you have a project already open, click Yes to close that project and open your new project.

  2. If you already have a C++ file for your client, use Windows Explorer to drag that file to the newly created project folder.

  3. Back in Visual C++ Studio, if you dragged a file into the project in step 2, right-click Source Files and select Add to add the new file.

  4. In the Solution Explorer panel, right-click the project just created and select Properties from the context menu.

  5. In Visual C++ Studio, in the Solution Explorer panel, right-click the project that contains your StreamBase custom client code and select Properties from the context menu.

  6. On the Configuration drop-down menu, select All Configurations.

    Make sure the following settings are in place:

    Configuration Properties Folder Property Page Property Row Setting
    Configuration Properties General Configuration Type From the drop-down menu, select Application (.exe).
    Configuration Properties General Use of MFC From the drop-down menu, select Use Standard Windows Libraries.
    Configuration Properties General Use of ATL From the drop-down menu, select Not Using ATL.
    C/C++ General Additional Include Directories Path to the include directory of your StreamBase installation.

    streambase-install-dir\include

    Do not use the environment variable STREAMBASE_HOME to define this path (unless you have applied this variable globally as described in StreamBase Command Prompt). If there is already an entry in this row that uses ${STREAMBASE_HOME}, replace that entry.

    Instead, click in the row and use the button with three dots on the right side to open the Additional Include Directories dialog. Select a row in this dialog and use the second three-dot button to navigate to your StreamBase installation's include directory.

    C/C++ Preprocessor Preprocessor Definitions Add the following definitions:

    WIN32; STREAMBASE_PTHREAD_DLL

    Linker Input Additional Dependencies

    Fill in the Additional Dependencies row with the following entries:

    LibsbClient-vc8.lib
    LibsbUtil-vc8.lib
    pthreads-vc8.lib
    WS2_32.lib
    xercesLib-vc8.lib
    Dbghelp.lib

    In the Additional Dependencies dialog, make sure the Inherit from project defaults check box is selected.

  7. On the Configuration drop-down menu, select the Debug configuration.

    Make sure the following settings are in place:

    Property Folder Property Page Property Row Setting
    C/C++ Code Generation Runtime Library From the drop-down menu, select Multi-threaded Debug DLL (/MDd).
    Linker General Additional Library Directories Append the following path to the entries in that row:

    streambase-install-dir\lib\Debug

    As described above, do not use STREAMBASE_HOME to define this path. If there is already an entry in this row that uses ${STREAMBASE_HOME}, replace that entry.

    Click in the row and use the button with three dots on the right side to open the Additional Library Directories dialog. Select a row in this dialog and use the second three-dot button to navigate to your StreamBase installation's lib\Debug subdirectory.

  8. On the Configuration drop-down menu, select the Release configuration.

    Make sure the following settings are in place:

    Property Folder Property Page Property Row Setting
    C/C++ Code Generation Runtime Library From the drop-down menu, select Multi-threaded DLL (/MD).
    Linker General Additional Library Directories Append the following path to the entries in that row:

    streambase-install-dir\lib\Release

    As described above, do not use STREAMBASE_HOME to define this path. If there is already an entry in this row that uses ${STREAMBASE_HOME}, replace that entry.

    Click in the row and use the button with three dots on the right side to open the Additional Library Directories dialog. Select a row in this dialog and use the second three-dot button to navigate to your StreamBase installation's lib\Release subdirectory.

Now customize the source file for your client, then build and test it.