rhapsody in c++ tool training "essential" © i-logix 1999-2003 v4.1 01/01/2003 e1-1...

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

Essential Rhapsody in C++

Part OneBasic Rhapsody


Part One: Basic Rhapsody

• Setting up Rhapsody in C++

• Example : Hello world

• Example : Count down

• Properties

• Example : Dishwasher


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”


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”.


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


Part One : Example 1

Basic RhapsodyHello World


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.


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

ObjectModel

Diagram


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”.


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.


The Features Window

• Right-click on the constructor and display the Features.


Adding some code

• Select the Implementation tab and enter the following:

std::cout << "Hello World" << std::endl;


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.


The Test Component

• Now expand the Configurations and rename the DefaultConfig to Release


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.


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


Renaming our OMD

• Expand the Object Model Diagrams in the browser and use the features dialog to rename the diagram from Model1 to Overview.


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:


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.


The generated files

• The generated files will be in the directory C:\Work\Hello\Test\Release

executable

main

make file

Display class


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


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!


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.


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 :


Project Files

Generated files for the Test component

AutoSave

The model

ReverseEngineering Log(appeared when we

roundtripped)

Event History List(Will be used later when we animate)

RhapsodyWork Space

Visual BasicMacros


Part One : Example 2

Basic RhapsodyCount Down


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.


3המשך בתרגיל • עד אז!countdownתשמור את תקיה של •שמירה ברשת:•

תעתיק את התקיה הראשית של הפרויקט החדש –לרשת. תפתח הפרויקט ברשת לוודא שהקבצים לא

השתבשו.ליתר ביטחון תשמור את הפרויקט במדיה נשלפת –

.disk on keyכמו , ליתר ביטחון תעשה את disk on keyאם אין לך –

וכדומה ותעתיר אותו zipהפרויקט החדש קובץ לרשת

בשום פנים ואופן אל תעבוד בפרויקט ברשת. –תעתיק אותו לדיסק המקומי, ורק בסוף תשמור אותו

ברשת.

rhapsody in c++ tool training "essential" © i-logix 1999-2003 v4.1 01/01/2003 e1-1...

Documents