Java_UML_library

// // 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