jgs CSC 309 Software Engineering II Lecture 05: SOLID Principles Dr. Javier Gonzalez-Sanchez [email protected] www.javiergs.com Building 14 -227 

jgs SOLID Principles Let’s Start from the Beginning 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 3 Key idea § Just like the source code a design should be clean, and that includes. § Keep it Simple - over-designing the system is as bad as their absence when needed. § A design that is more than what we need smells. § So, abstract classes, interfaces, design patterns, and other infrastructure elements that do not solve a problem create a problem. § Eliminating design smells is the goal of design principles. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 4 Key Idea Design principles are not a perfume to be liberally scattered all over the system. Robert Martin (Agile manifesto, SOLID principles, Clean Code Book) 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 5 Design Principles There are five key design principles to consider in Object-Oriented: § Single Responsibility Principle (SRP) § Open-Closed Principle (OCP) § Liskov Substitution Principle (LSP) § Interface Segregation Principle (ISP) § Dependency Inversion Principle (DIP) 

jgs Single Responsibility Principle SRP 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 7 Definition A class should have only one responsibility SRP is all about understanding when and how to apply decoupling. Why? Because each responsibility implies a possibility of a change. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 8 SRP Example 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 9 SRP Example 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 10 SRP Example § Imagine that you need a piece of software to read data from diverse sensor devices (a heart rate monitor, a brain-computer interface, a skin conductance sensor, etc.) § And you need to store that information for future use also. § For some sensors, we need to gather data directly from a serial port. § For others, we use a WebSockets (third-party APIs help us get data from the physical device). § To store data, we want to be able to store data in a local file (text file) or in a database 

jgs Open-Closed Principle OCP 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 12 Definition Software entities (functions, classes, modules, etc.) should be open for extension but closed for modification. OCP is all about achieving changes adding new code, not changing the old code that already works. Closure cannot be complete. There will always be some change against which the entity is not closed. Thus, the closure must be strategic. As a developer, make educated guesses about the likely kinds of changes that the application could suffer over time. OCP means that we do not want to modify the class, i.e., write code into a class. Once you create a class and put that class in a production environment, you do not want to touch that class. OCP can be satisfied with a simple and effective heuristic: inheritance 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 13 OCP Example § Imagine you are asked to create a program to draw geometric shapes on screen. § We want to draw circles and draw squares; maybe later, we would ask for draw triangles, etc. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 14 OCP Example 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 15 OCP Example 

jgs Liskov Substitution Principle LSP 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 17 Definition Subtypes must be substitutable for all their base types. i.e., a child should always be better than its parent. And, “better” means more behaviors, not less. That principle is the answer proposed by Barbara Liskov (1988) to the questions: § What are the characteristics of the best inheritance hierarchies? § What are the traps that could create hierarchies that jeopardize the OCP? 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 18 Let’s Work 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 19 LSP Example § Imagine you already have a class Circle, and you are asked to create a class Cylinder. § Or maybe you have a class Rectangle, and you are asked to create a class Square (a square is a rectangle with the same width and height). § Or you have a class LinkedList, and you are asked to create a class PersistentLinkedList (one that writes out its elements to a stream and can read them back later). If you are tempted to use inheritance from Circle to Cylinder, or from Rectangle to Square, or from LinkedList to PersistentLinkedList, i.e., create a parent-child relationship for any of these cases, you will have problems. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 20 LSP Example § The class Cylinder would eliminate the method calculateArea() in Circle since calculating an area does not make sense. It is impossible to use our Cylinder object to replace a Circle object. § The class Square will make the methods setWidth() and setHeight() to modify both width and height attributes (they are equal in a square, right?). Therefore, it will be impossible to use a Square object to replace a Rectangle object. § The class PersistentLinkedList needs persistent (serializable) objects while LinkedList does not. Moreover, probably, PersistentLinkedList would need to throw some exceptions. 

jgs Interface Segregation Principle ISP 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 22 Definition § Clients should not be forced to depend on methods that they do not use. § ISP deals with the disadvantage of “fat” interfaces (or abstract classes). § ISP recommends to broke up interfaces with a lot of methods into several interfaces. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 23 Let’s Work 

jgs Dependency Inversion Principle DIP 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 25 Definition § High-level modules should not depend on low-level modules. Both should depend on abstractions. § Traditional procedural programming creates software structures in which high-level modules depend on low-level modules. § The dependency structure of a well-designed object-oriented program is “inverted” with respect to the dependency structure that generally results from traditional procedural methods. § DIP is what makes software fulfill the object-oriented paradigm. 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 26 Definition § Hollywood Principle: “do not call us, we will call you.” § Review DIP whenever one class sends a message to another. DIP is about calling methods. § When doing that, depend on abstractions (use abstract classes or interfaces). 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 27 DIP Example 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 28 DIP Example What about ISP? 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 29 Homework Read: Wettel, R. & Lanza, M. (2007). Visualizing Software Systems as Cities. 2007 4th IEEE International Workshop on Visualizing Software for Understanding and Analysis, 92–99. https://doi.org/10.1109/vissof.2007.4290706 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 30 Questions 

jgs 

jgs CSC 309 Software Engineering II Lab 5: Final Project Proposal Dr. Javier Gonzalez-Sanchez [email protected] www.javiergs.com Building 14 -227 

jgs Javier Gonzalez-Sanchez | CSC 309 | Winter 2023 | 33 Let’s Work 

jgs CSC 309 Software Engineering II Javier Gonzalez-Sanchez, Ph.D. [email protected] Winter 2023 Copyright. These slides can only be used as study material for the class CSC308 at Cal Poly. They cannot be distributed or used for another purpose.