Essential Rhapsody in C++ Part One Basic Rhapsody Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Part One: Basic Rhapsody Setting up Rhapsody in C++ Example : Hello world Example : Count down Properties Example : Dishwasher Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Setting Up Rhapsody Install Visual C++ 6.0 (or alternatively Visual Studio .NET or Borland bcc55) Install Rhapsody in C++ V4.1 Install license (License.dat) Create a work directory ex: “C:\Work” Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Before We Start Rhapsody uses C++ which is CASE sensitive. Most of the errors that occur during the training are generally due to entering text incorrectly. During this training, all classes will start with an upper case ex: “Training”. Often during the training course, students take differing lengths of time for completing the exercises. For those students who finish early, there is often an “Extended Exercise”. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

C++ Refresher The following concepts (possibly unfamiliar to C users) will be used during the training: Constructor Constructor initializer Operator overloading Destructor New & Delete Inheritance Virtual operations Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Basic Rhapsody Hello World Part One : Example 1 Basic Rhapsody Hello World Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Creating a Project Start up Rhapsody in C++ (development edition) Within Rhapsody, use the icon or file->new to create a new project called Hello in directory c:\work Click Yes to create project. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

The Browser The browser showing everything in the model is automatically started on opening a project. An Object Model Diagram has also been created and displayed. Browser Object Model Diagram Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Drawing a Class In this Object Model Diagram, use the class icon to draw a class named Display. There are two ways of deleting a class. It can be deleted from just the view “Remove from View” or deleted from the entire model “Delete from Model”. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Adding a constructor Expand the browser to see the class that we have just added. Right-click on this class and “Add New ►Constructor” We don’t need any arguments for our constructor so just click OK. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

The Features Window Right-click on the constructor and display the Features. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Adding some code Select the Implementation tab and enter the following: std::cout << "Hello World" << std::endl; Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Renaming a Component In order to generate code, we must first create a component. Expand the Components in the browser and rename the existing component called DefaultComponent to Test Note that this component will generate an executable. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

The Test Component Now expand the Configurations and rename the DefaultConfig to Release Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Initial Instance Select the Initialization tab, expand the Default package and select the Display class. This will now create an initial instance of the Display class We will explain the difference between Explicit and Derived later. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Settings We need to select an environment so that Rhapsody knows how to create an appropriate make file. Since we have Microsoft Visual C++ as our compiler, we’ll use the default setting which is Microsoft. We’ll explain later the other settings such as instrumentation Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Renaming our OMD Expand the Object Model Diagrams in the browser and use the features dialog to rename the diagram from Model1 to Overview. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Generating Code We’re now ready to generate code. First close the Features window (click OK) Save the model then Generate/Make/Run Answer Yes to the question: Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Hello World You should see the following: Stop the executable by either closing the console window or by using the command If during compilation, there is a problem, then simply double-click on the error to go directly to the diagram or the part of the browser where the error occurred. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

The generated files The generated files will be in the directory C:\Work\Hello\Test\Release Display class main make file executable Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Editing the Code We can edit the generated files from within Rhapsody. Select the class Display in the browser, right-click and select Edit Class Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Modifying the Code We can modify the generated code In the Display.cpp file change: std::cout << “Hello World” << std::endl; to: std::cout << “Constructed” << std::endl; Transfer the focus to another window to roundtrip the modifications back into the model. Note that the model has been automatically updated. In general the roundtripping works pretty well, but beware not everything can be roundtripped! Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Why doesn’t the constructor show up on the OMD? It doesn’t show up simply because we added it from the browser To display it on our diagram we can select the class on the Overview OMD, right-click and select Display Options … Select to display All or explicitly select the operation and it will appear. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Displaying the Main and Make The Main and Make files can be displayed from within Rhapsody by simply right-clicking on the configuration and selecting edit : Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Project Files Generated files for the Test component AutoSave The model Visual Basic Macros ReverseEngineering Log (appeared when we roundtripped) Event History List (Will be used later when we animate) Rhapsody Work Space Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Basic Rhapsody Count Down Part One : Example 2 Basic Rhapsody Count Down Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

Copying a Project Select File -> Save As Press to select the Work folder Press to create a new folder Rename “new folder” to “CountDown” Select the new folder “CountDown” Save the project as CountDown.rpy The new CountDown project is opened in Rhapsody with the previous project workspace preserved Each time there is an auto-save, Rhapsody will only save just what has changed since the last auto-save. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003

תשמור את תקיה של countdown עד אז! שמירה ברשת: המשך בתרגיל 3 תשמור את תקיה של countdown עד אז! שמירה ברשת: תעתיק את התקיה הראשית של הפרויקט החדש לרשת. תפתח הפרויקט ברשת לוודא שהקבצים לא השתבשו. ליתר ביטחון תשמור את הפרויקט במדיה נשלפת כמו disk on key. אם אין לך disk on key, ליתר ביטחון תעשה את הפרויקט החדש קובץ zip וכדומה ותעתיר אותו לרשת בשום פנים ואופן אל תעבוד בפרויקט ברשת. תעתיק אותו לדיסק המקומי, ורק בסוף תשמור אותו ברשת. Rhapsody in C++ Tool Training "Essential" © I-Logix 1999-2003 v4.1 01/01/2003