1 / 33

Design Recovery

Learn about the process of design recovery and how to recreate design abstractions from code and existing documentation. Discover the benefits, techniques, and tools for design recovery.

ngivens
Download Presentation

Design Recovery

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript


  1. Design Recovery

  2. Today’s Lecture Reverse engineering Assignment 3 Benumbered design continued (if time)

  3. Reverse Engineering • Recreating design abstractions from: • Code • Existing design documentation (if available) • Personal experience / general knowledge about problem and application domains • Talking to people (Biggerstaff, 1989)

  4. Design Recovery • We might need • Formal specifications • Dataflows • Underlying patterns • Informal knowledge • We want to understand • What • How • Why • This might be more than just re-creating…

  5. Why do we have to do this?

  6. Why do we have to do this? • Working with others’ code… • Debugging • Maintenance • Modification • Reuse • Working with your own code • You will work with code in the absence of a complete design

  7. Why do we have to do this? • No design • Lost design • Build-and-fixed • Agile methodologies • Design drift • Common! • Incomprehensible design

  8. Design Recovery’s Goals Recover lost information Cope with complexity Generate alternate views Detect side effects Facilitate Reuse (Chikofsky and Cross, 1990)

  9. Design Recovery Tips

  10. Object Orientation • Something of an advantage • Class names, function names • Established relationships (inheritance, members, etc.) • High cohesion helps • A holistic sense of purpose

  11. Finding the structure • Entities • Classes • Methods • Variables • Relationships • Inheritance • Member Objects • Method calls

  12. Approaches • Reverse engineering tools • E.g. Omondo • Running the program • Eclipse’s References and Declarations • Reading documentation • Reading class names • Talking to people • Code reading

  13. Also, remember • Existing artifacts, but also • Personal experience • Knowledge about problem • Knowledge about the context • Knowledge about solution

  14. A (Small) Example addAllPixels(Image image){ for(int i = 0; i < image.getWidth(); i++){ for(int j = 0; j < image.getHeight(); j++){ Color c = image.getColor(i, j); addPixel(new Pixel(i, j, c)); addToColumn(i, new Pixel(i, j, c)); updateColorTotals(c); }}}

  15. We might be able to guess that: • Need for a pixel class • Different instances for • addPixel • addToColumn • Concerned about speed • Not so much about space • Concerned about changability? • Or just following convention

  16. Could have just been addAllValues(ImageNumber n){ for(int i = 0; i < image.height; i++){ for(int j = 0; j < image.height; j++){ colorArray[n][i][j] = image.colorAt(i, j); }}}

  17. Assignment 3 – Design Recovery • Recover the design of Calico (surprise!) • Tool for electronic whiteboard software design developed at UC Irvine • You may use any tools you like • Do not ask anyone about it (despite that normally being a good resource) • Get the Calico code from the subversion repository, detailed instructions follow

  18. Assignment 3 – Design Recovery • Each group must turn in: • A complete UML (-ish) Diagram • At least 1 additional diagram of your choice (might be informal)‏ • A document describing the design of Calico (at least 4 pages)‏ • Your audience is someone unfamiliar with Calico who needs to make very significant changes to it • The code may not compile • Your submission graded on completeness, clarity, accuracy • Each person also needs to submit a team evaluation (forms available on class webpage)‏ • Paper copy due Thursday, February 4th, at start of class

  19. Suggestions for Group Work • Everyone start by taking their own look at the whole system • Multiple perspectives will be very useful • Work out the high level architecture • Understand program flows • Look out for subtle details

  20. Further tips • There are papers available on Calico on André's website; feel free to consult them • Use representations of classes to organize • Rote completeness is not the answer, will need to be elegant

  21. Team Assignments Team 1 • Warren Applebaum • Stacey Dao • Sam Kaufman • Kyle Lutze • Ryan Nissenbaum Team 2 • James Benson • Hunter Gillane • Garrett Kim • Francesco Mantovani • Hiroe Ono Team 3 • Alex Chung • Sohrab Hejazi • Tae Kim • Michael Merchant • Matthew Palmer Team 4 • Andrew Ziming • Ryan Hsu • Frank Morales • Joshua Papa • Jordaniel Wolk Team 5 • Jessie Danielson • Simon Huynh • Patrick Lu • Kyle Musler • Sean Tsusaki • Leo Zen

  22. Detailed Checkout Instructions Two Steps: 1) Install Subclipse plugin for Eclipse 2) Check out the Calico repository NB: this assumes that you're using Eclipse and are otherwise comfortable with it.

  23. Detailed Checkout Instructions 1. In Eclipse, go to Help > Software Updates > “Available Software” tab

  24. Detailed Checkout Instructions 2. Hit “add site”, enter location: http://subclipse.tigris.org/update_1.4.x

  25. Detailed Checkout Instructions 3. Hit “OK” => Check the Subclipse main box => hit “Install”

  26. Detailed Checkout Instructions 4. Make sure everything is checked off and hit “Finish”

  27. Detailed Checkout Instructions 5. Let the libraries download => hit “Yes” at this dialogue box

  28. Detailed Checkout Instructions 6. Make a new Project (NOT Java Project) and choose this

  29. Detailed Checkout Instructions 7. Make a new repository location

  30. Detailed Checkout Instructions 8. Enter https://calico.ics.uci.edu/svn/calico3client/tags/inf122/ and hit “next”

  31. Detailed Checkout Instructions 9. Select the root of the tree => hit “Next” (NOT “Finish”)‏

  32. Detailed Checkout Instructions 10. Check out in the workspace => give it a name => hit “Finish”

  33. Server Checkout To checkout the server version, you will need to repeat steps 6 through 10. Just replace the SVN URL with: https://calico.ics.uci.edu/svn/calico3server/tags/inf122 Note: You will need to login with your ICS username and password. (If you receive any SSL certificate errors, you can safely ignore them) If you have any problems, please feel free to email mitch.dempsey@uci.edu or stop by my office (ICS2 room 110)

More Related