//
// UML TOOLKIT CD-ROM
//
// readme.txt
//
Contents
========
- What's on the CD-ROM
- Directory structure
- How to install the case study application
- How to install Rational Rose demo version
- How to edit and compile the Java source code
- Internet links
- Contacts
What's on the CD-ROM ?
======================
* Demo version of Rational Rose 4.0 (Windows95/NT)
* UML analysis model of the case study as a Rose file.
* UML design model of the case study as a Rose file.
* The Java source code to the case study
* Compiled case study application in Java 1.0.2 format.
* Compiled case study application in Java 1.1 format.
Directory structure
===================
\----
-Case Study----- : Files covering the case study
- -
- Analysis : Analysis Rational Rose model
- -
- App1.0.2 : Executable version Java 1.0.2 format
- -
- App1.1 : Executable version Java 1.1 format
- -
- Construction : Java source code
- -
- Design : Design Rational Rose model
-
Rational : Rational Rose demo version
How to install the case study application
=========================================
a) Copy the entire directory structure from the directory "\Case Study"
to a directory on your hard disk. The application can't run from the CD,
it must be able to write to its current directory.
b) Run the application by running the "run.bat" file (in either the "\Case
Study\App1.0.2" or the "\Case Study\App1.1" directory depending on what
version of the Java virtual machine is installed on your system).
The "run.bat" expects the directory of the Java virtual machine
(program "java") to be in your PATH.
Note that the application requires a Java virtual machine to run. Such a
machine is present in the Symantec Visual Cafe trial version which can be
downloaded from Symantec's web site at:
http://www.symantec.com/trialware/dlvcafewin10.html
By installing that environment you can also edit the source files, compile
them, and run the application from within the environment. The Symantec
Visual Cafe trial version available as of 9/3/97 generates 1.0.2 Java code.
Currently, there are as mentioned two different versions of the Java virtual
machine (1.0.* and 1.1.*). Java byte-code files (.class-files) compiled in
one version has problems running on a virtual machine of the other version
(the application hangs).
You must compile and run the Java code using the same version on the
compiler and the virtual machine. The source code on the CD-ROM can be
compiled for both Java 1.0.2 and Java 1.1.
If you want to view the UML models and modify the Java code, you must
install the Rational Rose demo version and get the Symantec Visual Cafe
Trial version from the Symantec web site.
How to install Rational Rose demo version (Windows95/NT)
========================================================
a) Move the files from the Rational directory on the CD-ROM
to a temporary directory on your hard disk.
b) Click on the filename "Rosecppd.exe"
c) Follow the instructions.
The Rational Rose demo version doesn't allow a model to be saved if
it contains more than 30 classes and actors, 3 logical packages,
10 use cases, 30 modules, 3 component packages and 10 states. The case
study is larger than that and can only be viewed.
Please note that this version of Rational Rose does not fully support all
of the UML language. Check at Rationals Web site for updates. The version
of Rational Rose is for Windows95/NT only.
How to edit and compile the Java source code
============================================
The files in the case study are read-only on the CD-ROM, and when copied
onto a local disc they will remain read-only. In order to edit them (e.g.
change the models or edit the source code), the permissions must be
changed (read-only permission switched off).
The application is divided into four different projects, one project for
each package in the application (bo = business object package, db = database
package, ui = user interface package, util = utility package).
To edit a package start Symantec Visual Cafe and open the appropriate Visual
Cafe project file with the File-Open command (the project files are named:
bopack, dbpack, uipack and utilpack).
The classes in the package are shown in the Project window. To edit a class,
select it, click on the right mouse button, and select "Edit Source". An
editor window is opened and the code can be edited.
To compile all classes in a package, execute the "Project-Build Application"
command.
All packages must have been compiled to run the application.
The application is run from within the Symantec environment by executing the
"Project-Execute" command with the UI package (uipack) as the current project
(IMPORTANT: currently, it must be started with the UI package selected as the
current project!).
For further instructions about using the Visual Cafe environment see the
"Help Topics" menu in the environment.
Internet links
==============
The file "UML_links.html" contains Internet links to Rational and Symantec
to get upgraded versions of their demo versions and for instructions how
to buy their commercial versions.
The file also contain a link to the UML Toolkit book homepage, where news,
upgrades, and additional information connected to the book will be available.
It also contain mail links to send mail to the authors.
Contacts
========
{ The software accompanying this book is being provided as is without
warranty or support of any kind. Should you require basic installation
assistance, or if your media is defective, please call our product
support number at (212) 850-6194 weekdays between 9 am and 4 pm Eastern
Standard Time. Or, we can be reached via e-mail at: wprtusw@jwiley.com
To place additional orders or to request information about other Wiley
products, please call (800) 879-4539 }
You may contact the authors at the following e-mail addresses:
hanserik@objektteknik.se magnus.penker@astrakan.se