Introduction

This User’s Manual documents Rogue Wave® Server, a large-scale object engine combining business objects with real-time business event notification to implement multi-tier client/server applications.

In Part I, Modeling Services, you will learn how to use the API of the modeling classes to build the object model of your Rogue Wave® Server application.

Chapter 1, Basic Features, explains Server objects and relations. It also describes smart pointers, reference counting and Rogue Wave Server dictionaries.

Chapter 2, Relations, presents all the types of relations that you can establish between Server objects. It explains how to define these relations and how to invert them.

Chapter 3, Entry and Derived Data Members, describes the two kinds of special data members that Rogue Wave Server lets you declare in the classes of your application: entry data members and derived data members.

Chapter 4, Context-Sensitive Features, covers the cut function, which was designed to maintain the referential integrity of an object structure automatically and transparently.

Chapter 5, Dynamic Modeling Services, tells you how to describe a reactive object model dynamically instead of coding it using the Rogue Wave Server modeling classes.

Chapter 6, Rogue Wave Script Integration, explains how you can use Rogue Wave Script on the Server side of your Rogue Wave Server application.

In Part II, Dynamic View Services, you will learn what view services are, how notification works, how to make your Server model accessible at runtime, and how to implement a representation model and specify the dynamic-view types to interact with components.

Chapter 7, View and Notification Services presents the basic concepts and mechanisms on which view services rely.

Chapter 8, Defining Runtime Access to the Server Model, describes how to declare the Server model classes, functions, attributes, and relations to the dynamic-view interpreter for runtime access.

Chapter 9, Implementing a Representation Model, explains how to implement a Tree representation model and a Table representation model.

Chapter 10, Specifying Dynamic View Types, describes how to specify dynamic view types and gives you information about references, hyper-references, collectors, representation attributes, and conditions you can set for propagation and on representations.

Chapter 11, Implementing a Dynamic View Server and its Components, explains how to implement the view servers and components making up a linked or distributed Rogue Wave Server application.

In Part III, Rogue Wave Server/Rogue Wave Views Integration, you will learn about the specific mapping that allows you to define dynamic views to represent your server object model as a set of Rogue Wave Views data sources.

Chapter 12, Overview of the Server/Views Integration, outlines both the design and the dynamics of the Server/Views integration.

In Chapter 13, Server/Views Mapping, you will learn more about the mapping mechanism, including the Server- and Views data sources, the Server/Views representation model, multiple-row-type tables.

Chapter 14, The Rogue Wave Views Component, gives you general information about the swcomp demonstration and briefly outlines how to design your own Views component.

Part IV, Rogue Wave Server Studio, gives you reference information about Rogue Wave Server Studio, the GUI-builder tool for the Server/Views mapping.

Chapter 15, Rogue Wave Server Studio Advanced Features, helps you go beyond the basics with your Studio environment.

Chapter 16, Server Data Source Inspector Reference, provides a systematic description of the SDS inspector user interface.

Part V, Java Data Sources, includes the following chapters:

Chapter 17, Overview of Java Data Sources, introduces you to the mechanism of the predefined Server/JavaTM mapping.

Chapter 18, API of the Server/Java Mapping, describes the corresponding Java packages and classes.

Chapter 19, Working with the Server/Java Mapping, presents the mechanism of the mapping that associates Rogue Wave Server with Java data sources, as well as the corresponding API.

Chapter 20, Java Data Source Adapters, explains how to use the adapters that enable each Server/java data source to be represented graphically.

Part VI, Appendices, covers various complementary subjects.

Appendix A, Portable Thread Library, explains how to create and synchronize threads using the classes from the portable thread library.

Appendix B, Using Rogue Wave Server on Windows, describes the features that are specific to Rogue Wave Server on Windows® platforms.

Appendix C, Floating Reference Cycles, explains how to avoid floating reference cycles.

Appendix D, Internationalization in Rogue Wave Server, explains what you should do to develop an Rogue Wave Server-based internationalized application.

Appendix E, The MvTCP Communication Layer, gives you basic information about the default communication layer.

Glossary: Most of the terms used in this manual are defined in a glossary at the end of this manual.