Creating a Server

In this Lesson

You will learn how to create a server definition.


The Soiree Server is called SxServer.

SxServer is one of two book-ends in the Soiree framework; the Scene is the other. Scenes are what people see and SxServer is what brings them to life. Everything in between is minor stuff – at least that is how those two braggarts look at it. (Of course, they are wrong. The bits in between are important and fabulous things – just don’t tell these two – they would not understand.).

SxServer comes in two configurations

  • A development server.
    It is integrated into the Soiree workbench and makes it easy to test and debug solutions. The entire party takes place inside of Eclipse.
  • A production server.
    It runs in a JVM on a Linux server.
  • SxServer has the following characteristics

    • SxServer is the same regardless of where it runs. There is a single code base for SxServer; the servers differ only in how they are invoked and configured.
    • SxServer can run anywhere you can run Java SE. It has been run on the largest IBM mainframes, Raspberry Pi, and many things in between.
    • We currently only provide configuration assistance for Linux. This is a deployment/support choice and not a restriction of the framework.
    • SxServer provides a performance monitor that can be enabled via server configuration. It allows you to observe the performance characteristics of the system in general and for your business processes and queries in particular.
    • SxServer requires the presence of a relational database containing tables needed for certain services offered by the server. You will learn more about the tables and which services they support in later lessons.

    Create a Server

    In this exercise you will create a Server configuration that will be used in a later lesson to start a development server.

    1. Open the Server wizard.
      Left click on the package in the src folder to select it. Then press Command + N (OS X) or CTRL + N (Win). Select Server from the Soiree section.
    2. Packages
      Notice how the wizard defaulted the package name to the package that was selected when the wizard was started. All item wizards work this way.
      You might prefer creating the desired package before creating an item. You may then select the package before starting the wizard so that full package name is defaulted for you.
    3. Enter the following information into the Server wizard
      Name: PartyServer
      Description: Party server

    4. The default values are appropriate for most servers. You do not need to change anything in the server definition. We will not be discussing the details of the server configuration in this lesson, however, you should take a look at the configuration settings to acquaint yourself with it.

    That’s all for this lesson.