1 / 109

Software Engineering Refactoring

Software Engineering Refactoring. Software Engineering 2012 Department of Computer Science Ben-Gurion university. Based on slides of: Mira Balaban Department of Computer Science Ben-Gurion university F. Tip. IBM T J Watson Research Center. Jan Vitek , Purdue University.

faye
Download Presentation

Software Engineering Refactoring

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. Software EngineeringRefactoring Software Engineering 2012 Department of Computer Science Ben-Gurion university Based on slides of: Mira Balaban Department of Computer Science Ben-Gurion university F. Tip. IBM T J Watson Research Center. • Jan Vitek, Purdue University.

  2. Refactoring: Improving the Design of Existing Code Martin Fowler Kent Beck John Brant William Opdyke Don Roberts Publisher: Addison Wesley FirstEdition June 11, 1999 ISBN: 0-201-485672, 464 pages “ Computer science is the discipline that believes all problems can be solved with one more level of indirection” Dennis DeBruler (from Fowler’s Refactoring book)

  3. What is refactoring? • refactoring is the process of applying transformations (refactorings) to a program, with the goal of improving its design • goals: • keep program readable, understandable, and maintainable. • by eliminating small problems soon, you can avoid big trouble later. • two key features of refactorings: • behavior-preserving: make sure the program works after each step. • typically small steps

  4. Why refactor? • why does refactoring become necessary? • requirements have changed, and a different design is needed. • design needs to be made more flexible (so new features can be added). • sloppiness by programmers (e.g., cut-and-paste programming when introduction of a new method). • programmers usually don’t come up with the ultimate design right away. • refactoring often has the effect of making a design more flexible. • design patterns are often a target for refactoring.

  5. History • Refactoring is something good programmers have always done. • Especially important in the context of object-oriented languages. • Perhaps because object-oriented features are well-suited to make designs flexible and reusable. • But refactoring is really not specific to OO. • Opdyke’s PhD thesis (1990) describes his research on refactoring tools for Smalltalk. • Various other students of Ralph Johnson have worked on refactoring tools, mostly for Smalltalk. • Refactoring is becoming very popular due to “lightweight” development methodologies such as extreme programming that advocate continuous refactoring.

  6. Preserving program behavior • How to ensure that the program does the same thing before and after applying a refactoring? • Testing: write tests that exercise the parts of the program affected by the refactoring. • In general, no guarantees. • Program analysis: Perform a static analysis of the program using techniques similar to those used in compilers. • Difficult to implement; analysis may be imprecise and say that a refactoring cannot be applied safely. • Some refactoring support is incorporated in Eclipse and IntelliJ.

  7. Fowler’s book: • Martin Fowler (and Kent Beck, John Brant, William Opdyke, Don Roberts), Refactoring- Improving the Design of Existing Code, Addison Wesley, 1999. • Refactoring (noun): a change made to the internal structure of software to make it easier to understand and cheaper to modify without changing its observable behavior. • Refactor (verb): to restructure software by applying a series of refactorings.

  8. Fowler’s book: • Provides a catalogue of refactorings, similar to the catalogue of design patterns in the GoF book. • Catalogues “bad smells” --- indications that refactoring may be needed. • Explains when to apply refactorings: • UML diagrams to illustrate the situation before and after. • Examples of code before and after each refactoring. • Small examples that are representative of larger systems. • Many of Fowler’s refactorings are the inverse of another refactoring. • Often there is not a unique “best” solution. • Discussion of the tradeoffs.

  9. “Bad smells”: An indication that the design may not be optimal • Just a sample: • Duplicated code (cut & paste programming). • Long method. • Large class. • Long parameter list. • Primitive obsession. • Switch statements. • Some of the more controversial ones: • Speculative generality. • Comments. • See also “Anti-Patterns: Refactoring Software, Architectures, and Projects in Crisis”, William H. Brown et al., Wiley, 1998.

  10. Example: Refactorings applied • Straight from the book: • “A program to calculate and print a statement of a customer’s charges at a video store”. • Price depends on how long the movie is rented and the category of the movie. • Also compute frequent renter points.

  11. Example: Refactorings applied • Class diagram of the starting point classes. * a simple data class The rental class represents a customer renting a movie. represents the customer of the store

  12. Example: Movie class public class Movie { public static final int CHILDREN =2; public static final int REGULARS =0; public static final int NEW_RELEASE=1; private String _title; private int _priceCode; public Movie(String title, intpriceCode) { _title=title; _priceCode = priceCode; } public String getTitle() { return _title; } public intgetPriceCode() { return _priceCode; } public void setPriceCode(intarg) { _priceCode = arg; } }

  13. Example: Rental Class public class Rental { private Movie _movie; private int _daysRented; public Rental(Movie movie, intdaysRented) { _movie = movie; _daysRented = daysRented ; } public intgetDaysRented() { return _daysRented ; } public Movie getMovie() { return _movie; } }

  14. Example: Customer Class (1) public class Customer { private String _name; private Vector _rentals = new Vector(); public Customer(String name) { _name = name; } public void addRental(Rental arg) { _rentals.addElement(arg); } public String getName() { return _name; }

  15. Example: Customer Class (2) public class Customer ... public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); // determine amounts for each line switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: thisAmount += 2; if (each.getDaysRented() > 2) thisAmount+= (each.getDaysRented()-2) * 1.5; break;

  16. Example: Customer Class (3) public class Customer public String statement() ... case Movie.NEW_RELEASE: thisAmount += each.getDaysRented() * 3; break; case Movie.CHILDRENS: thisAmount += 1.5; if (each.getDaysRented() > 3) thisAmount+=(each.getDaysRented()-3) * 1.5; break; } // end switch // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE)&& each.getDaysRented() > 1) frequentRenterPoints++;

  17. Example: Customer Class (4) public class Customer public String statement() ... //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(thisAmount) + “\n”; totalAmount += thisAmount; } // end while // add footer lines result += “Amount owed is + String.valueOf(totalAmount) + “\n”; result += “You earned + String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  18. Skeleton of Customer.statement() (5) public class Customer … public String statement(){ // initializations while (rentals.hasMoreElements()) { // initializations // determine amounts for each line switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: … case Movie.NEW_RELEASE: … case Movie.CHILDRENS: … } // end switch // add frequent renter points // add bonus for a two day new release rental //show figures for this rental: result += …; totalAmount += …; } // end while // add footer lines: result += …; return result; }

  19. Example: Customer.statement() • Interaction diagram for Customer.statement(): • Customer does everything!

  20. Changing requirements: A trigger for refactoring: • Add an htmlStatment method which returns a customer statement string containing html tags  requires code duplication. ...and  there will be some changes to the way movies are classified. ...affecting frequent renter points and charging. …developer estimation: they will change it again within six months • NOTE: The code works well! When you find you have to add a feature to a program, and the program's code is not structured in a convenient way to add the feature, first refactor the program to make it easy to add the feature, then add the feature.

  21. Refactoring prerequisite • Write a test suite – recall the TDD development approach! • Make sure: All tests are passed. • Refactoring should not affect the outcome of tests. • The test suite must exercise the published interface of the classes. • Refactoring should not affect the published interface. • So, avoid publishing interfaces too early.

  22. Refactoring: step 1 – extract method • Customer.statement() is too long. • Should be decomposed into smaller pieces. • Find a logical part and use the extract method refactoring: • The switch statement. • Handle local variables and parameters: • each is not modified by the code - can be passed in as a parameter • thisAmountis modified – if unique, can be returned as the result • Local to extracted code – declare in target method.

  23. Refactoring: step 1a – the extracted code public String statement() { … while (rentals.hasMoreElements()) { double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); // determine amounts for each line switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: thisAmount += 2; if (each.getDaysRented() > 2) thisAmount+=(each.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: thisAmount += each.getDaysRented() * 3; break; case Movie.CHILDRENS: thisAmount += 1.5; if (each.getDaysRented() > 3) thisAmount+=(each.getDaysRented()-3) * 1.5; break; } … } }

  24. Refactoring: step 1b – after extraction public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); thisAmount = amountFor(each); // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE)&& each.getDaysRented() > 1) frequentRenterPoints++; //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(thisAmount) + “\n”; totalAmount += thisAmount; } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  25. Refactoring: step 1c – the extracted method public class Customer{ … public intamountFor(Rental each) { intthisAmount = 0; switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: thisAmount += 2; if (each.getDaysRented() > 2) thisAmount+=(each.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: thisAmount += each.getDaysRented() * 3; break; case Movie.CHILDRENS: thisAmount += 1.5; if (each.getDaysRented() > 3) thisAmount+=(each.getDaysRented()-3) * 1.5; break; } return thisAmount; } }

  26. Test: step 1 oops, (double) -> (int) bug! Java compiler won’t catch it! Only a good test case. public doubleamountFor(Rental each) { doublethisAmount = 0; switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: thisAmount += 2; if (each.getDaysRented() > 2) thisAmount+=(each.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: thisAmount += each.getDaysRented() * 3; break; case Movie.CHILDRENS: thisAmount += 1.5; if (each.getDaysRented() > 3) thisAmount+=(each.getDaysRented()-3) * 1.5; break; } return thisAmount; }

  27. Refactoring: step 2 – rename variables Variable names not helpful public double amountFor(Rental each) { double thisAmount= 0; switch (each.getMovie().getPriceCode()) { case Movie.REGULAR: thisAmount += 2; if (each.getDaysRented() > 2) thisAmount+=(each.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: thisAmount += each.getDaysRented() * 3; break; case Movie.CHILDRENS: thisAmount += 1.5; if (each.getDaysRented() > 3) thisAmount+=(each.getDaysRented()-3) * 1.5; break; } return thisAmount; }

  28. Refactoring: step 2 – rename variables public double amountFor(Rental aRental) { double result = 0; switch (aRental.getMovie().getPriceCode()) { case Movie.REGULAR: result+= 2; if (aRental.getDaysRented() > 2) result +=(aRental.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: result += aRental.getDaysRented() * 3; break; case Movie.CHILDRENS: result += 1.5; if (aRental.getDaysRented() > 3) result +=(aRental.getDaysRented()-3) * 1.5; break; } return result ; } Test – all tests are passed! Any fool can write code that a computer can understand. Good programmers write code that humans can understand.

  29. Refactoring: step 3 – Move method Moving amount computation (does not use info from Customer only from Rental) class Customer... public double amountFor(Rental aRental) { double result = 0; switch (aRental.getMovie().getPriceCode()) { case Movie.REGULAR: result += 2; if (aRental.getDaysRented() > 2) result +=(aRental.getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: result += aRental.getDaysRented() * 3; break; case Movie.CHILDRENS: result += 1.5; if (aRental.getDaysRented() > 3) result +=(aRental.getDaysRented()-3) * 1.5; break; } return result ; }

  30. Refactoring: step 3 – Move method • Steps: • Copy code to Rental. • Adjust the copied code: • Remove parameter. • Rename (amountFor getCharge). • Compile and test. • Change references to the old method. • Compile and test. • Remove the old method.

  31. Refactoring: step 3a – the new method is Rental.getCharge() class Rental ... public double getCharge() { double result = 0; switch (getMovie().getPriceCode()) { case Movie.REGULAR: result += 2; if (getDaysRented() > 2) result +=(getDaysRented()-2) * 1.5; break; case Movie.NEW_RELEASE: result += getDaysRented() * 3; break; case Movie.CHILDRENS: result += 1.5; if (getDaysRented() > 3) result +=(getDaysRented()-3) * 1.5; break; } return result ; } aRental.getMovie().getPriceCode() aRental.getDaysRented()

  32. Refactoring: step 3a – the new method is Rental.getCharge() class Customer ... public double amountFor(Rental aRental) { return aRental.getCharge(); } Compile and test! • Note : We could leave the old method to delegate to the new method. This is useful if it is a public method and we don't want to change the interface of the other class.

  33. Step 3b – change references to the old method: public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); thisAmount = amountFor(each); // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE) && each.getDaysRented() > 1) frequentRenterPoints++; //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(thisAmount) + “\n”; totalAmount += thisAmount; } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  34. Step 3b – change references to the old method: public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); thisAmount = each.getCharge(); // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE) && each.getDaysRented() > 1) frequentRenterPoints++; //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(thisAmount) + “\n”; totalAmount += thisAmount; } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  35. Refactoring: After step 3 • State of classes after moving the charge method. • Customer.amountFor() is deleted.

  36. Refactoring: Step 4 – replace temp with query class Customer ... // thisAmount is redundant. public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE) && each.getDaysRented() > 1) frequentRenterPoints++; //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; totalAmount += each.getCharge(); } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; } double thisAmount = 0; Rental each = (Rental) rentals.nextElement(); thisAmount = each.getCharge(); … totalAmount += thisAmount;

  37. Refactoring: step 5 – extract method and move method • Back to Customer.statement(). • Extract frequent renter per movie points. • Handle local variables and parameters: • Used in source method – pass as parameters (each). • Modified – if unique, return as the result (frequentRenterPoints). But here – target does not rely on value of frequentRenterPoints. • Move the extracted method to Rental.

  38. Refactoring: step 5 – the extracted code class Customer ... public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); // add frequent renter points frequentRenterPoints ++; // add bonus for a two day new release rental if ((each.getMovie().getPriceCode() == Movie.NEW_RELEASE) && each.getDaysRented() > 1) frequentRenterPoints++; //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; totalAmount += each.getCharge(); } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  39. Refactoring: step 5b – after extraction class Customer ... public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); frequentRenterPoints += each.getFrequentRenterPoints(); //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; totalAmount += each.getCharge(); } // add footer lines result += “Amount owed is “+String.valueOf(totalAmount) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; }

  40. Refactoring: step 5c – the extracted and moved method class Rental ... public intgetFrequentRenterPoints() { if ((getMovie().getPriceCode() == Movie.NEW_RELEASE) && getDaysRented() > 1) return 2; else return 1; } Compile and test!

  41. Summary of refactoring step 5 • Class diagram before extraction and movement of the frequent renter points calculation • Interaction diagram before extraction and movement of the frequent renter points calculation

  42. Summary of refactoring step 5 • Class diagram after extraction and movement of the frequent renter points calculation • Interaction diagram • after extraction and • movement of the • frequent renter points • calculation getFrequentRenterPoints()

  43. Refactoring: step 6 – replace temp with query class Customer ... //The temporaries make the method complex and force code duplication. public String statement() { double totalAmount = 0; intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); frequentRenterPoints += each.getFrequentRenterPoints(); //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; totalAmount += each.getCharge(); } // add footer lines result += “Amount owed is +String.valueOf(totalAmount) + “\n”; result += “You earned“ +String.valueOf(frequentRenterPoints) + “frequent renter points\n”; return result; } totalAmount was assigned to within the loop

  44. Refactoring: step 6a – replace temp with query class Customer ... public String statement() { intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); frequentRenterPoints += each.getFrequentRenterPoints(); //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; } // add footer lines result += “Amount owed is “+String.valueOf(getTotalCharge()) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints)+ “frequent renter points\n”; return result; }

  45. Refactoring: step 6b – the totalCharge query class Customer ... private double getTotalCharge() { double result = 0; Enumeration rentals = _rentals.elements(); while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); result += each.getCharge(); } return result; } NOTE: This isn't the simplest case of Replace Temp with Query totalAmount was assigned to within the loop, so we had to copy the loop into the query method.

  46. Refactoring: step 6 –replace temp with query class Customer ... public String statement() { intfrequentRenterPoints = 0; Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); frequentRenterPoints += each.getFrequentRenterPoints(); //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; } // add footer lines result += “Amount owed is “+String.valueOf(getTotalCharge()) + “\n”; result += “You earned “+String.valueOf(frequentRenterPoints)+“frequent renter points\n”; return result; }

  47. Refactoring: step 6c – replace temp with query class Customer ... public String statement() { Enumeration rentals = _rental.elements(); String result = “Rental Record for “ + getName() + “\n”; while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); //show figures for this rental result += “\t” + each.getMovie().getTitle()+ “\t” + String.valueOf(each.getCharge()) + “\n”; } // add footer lines result += “Amount owed is “+String.valueOf(getTotalCharge()) + “\n”; result += “You earned “+String.valueOf(getTotalFrequentRenterPoints())+“frequent renter points\n”; return result; }

  48. Refactoring: step 6d – the totalFrequentRenterPoints query class Customer ... private double getTotalFrequentRenterPoints() { double result = 0; Enumeration rentals = _rentals.elements(); while (rentals.hasMoreElements()) { Rental each = (Rental) rentals.nextElement(); result += each.getFrequentRenterPoints(); } return result; }

  49. Summary of refactoring step 6 • Class diagram before extraction of the totals • Interaction diagram before extraction of the totals getFrequentRenterPoints()

  50. Summary of refactoring step 6 • Class diagram after extraction of the totals • Interaction diagram after extraction of the totals

More Related