Law of Demeter
The Law of Demeter (LoD) or principle of least knowledge is a design guideline for developing software, particularly object-oriented programs. In its general form, the LoD is a specific case of loose coupling. The guideline was proposed by Ian Holland at Northeastern University towards the end of 1987, and can be succinctly summarized in each of the following ways:
- Each unit should have only limited knowledge about other units: only units "closely" related to the current unit.
- Each unit should only talk to its friends; don't talk to strangers.
- Only talk to your immediate friends.
The fundamental notion is that a given object should assume as little as possible about the structure or properties of anything else (including its subcomponents), in accordance with the principle of "information hiding". It may be viewed as a corollary to the principle of least privilege, which dictates that a module possess only the information and resources necessary for its legitimate purpose.
It is so named for its origin in the Demeter Project, an adaptive programming and aspect-oriented programming effort. The project was named in honor of Demeter, “distribution-mother” and the Greek goddess of agriculture, to signify a bottom-up philosophy of programming which is also embodied in the law itself.
In object-oriented programming
When applied to object-oriented programs, the Law of Demeter can be more precisely called the “Law of Demeter for Functions/Methods” (LoD-F). In this case, an object
A can request a service (call a method) of an object instance
B, but object
A should not "reach through" object
B to access yet another object,
C, to request its services. Doing so would mean that object
A implicitly requires greater knowledge of object
B's internal structure.
B's interface should be modified if necessary so it can directly serve object
A's request, propagating it to any relevant subcomponents. Alternatively,
A might have a direct reference to object
C and make the request directly to that. If the law is followed, only object
B knows its own internal structure.
More formally, the Law of Demeter for functions requires that a method
m of an object
O may only invoke the methods of the following kinds of objects:
- Any objects created/instantiated within
O's direct component objects
- A global variable, accessible by
O, in the scope of
In particular, an object should avoid invoking methods of a member object returned by another method. For many modern object oriented languages that use a dot as field identifier, the law can be stated simply as "use only one dot". That is, the code
a.b.Method() breaks the law where
a.Method() does not. As an analogy, when one wants a dog to walk, one does not command the dog's legs to walk directly; instead one commands the dog which then commands its own legs.
The advantage of following the Law of Demeter is that the resulting software tends to be more maintainable and adaptable. Since objects are less dependent on the internal structure of other objects, object containers can be changed without reworking their callers.
Basili et al. published experimental results in 1996 suggesting that a lower Response For a Class (RFC, the number of methods potentially invoked in response to calling a method of that class) can reduce the probability of software bugs. Following the Law of Demeter can result in a lower RFC. However, the results also suggest that an increase in Weighted Methods per Class (WMC, the number of methods defined in each class) can increase the probability of software bugs. Following the Law of Demeter can also result in a higher WMC; see Disadvantages.
A multilayered architecture can be considered to be a systematic mechanism for implementing the Law of Demeter in a software system. In a layered architecture, code within each layer can only make calls to code within the layer and code within the next layer down. "Layer skipping" would violate the layered architecture.
Although the LoD increases the adaptiveness of a software system, it may (but not necessarily will) result in having to write many wrapper methods to propagate calls to components; in some cases, this can add noticeable time and space overhead.
At the method level, the LoD leads to narrow interfaces, giving access to only as much information as it needs to do its job, as each method needs to know about a small set of methods of closely related objects. On the other hand, at the class level, the LoD leads to wide (i.e. enlarged) interfaces, because the LoD requires introducing many auxiliary methods instead of digging directly into the object structures . One solution to the problem of enlarged class interfaces is the aspect-oriented approach, where the behavior of the method is specified as an aspect at a high level of abstraction. This is done by having an adaptive method that encapsulates the behaviour of an operation into a place, with which the scattering problem is solved. It also abstracts over the class structure that results in avoiding the tangling problem. The wide interfaces are managed through a language that specifies implementations. Both the traversal strategy and the adaptive visitor use only a minimal set of classes that participate in the operation, and the information about the connections between these classes is abstracted out.
Since the LoD exemplifies a specific type of coupling, and does not specify a method of addressing this type of coupling, it is more suited as a metric for code smell as opposed to a methodology for building loosely coupled systems.
- Macedo, Emerson. "README.markdown: Demeter". GitHub. Retrieved 2012-07-05.
- Bock, David. "The Paperboy, The Wallet, and The Law Of Demeter" (PDF). College of Computer and Information Science, Northeastern University. p. 5. Retrieved 2012-07-05.
- Basili, Victor; Briand, L.; Melo, W. L. (October 1996). "A Validation of Object-Oriented Design Metrics as Quality Indicators". IEEE Transactions on Software Engineering. 22 (10): 751–761. doi:10.1109/32.544352.
As expected, the larger the WMC, the larger the probability of fault detection.
- "Weighted Methods per Class - Maisqual Wiki". maisqual.squoring.com. Retrieved 2018-09-20.
- Appleton, Brad. "Introducing Demeter and its Laws". Retrieved 6 July 2013.
A side-effect of this is that if you conform to LoD, while it may quite increase the maintainability and "adaptiveness" of your software system, you also end up having to write lots of little wrapper methods to propagate methods calls to its components (which can add noticeable time and space overhead).
- "Tell, Don't Ask". The Pragmatic Programmers, LLC. Retrieved 6 July 2013.
The disadvantage, of course, is that you end up writing many small wrapper methods that do very little but delegate container traversal and such. The cost tradeoff is between that inefficiency and higher class coupling.
- Lieberherr, K.; Holland, I.; Riel, A. (1988). "Object-Oriented Programming: An Objective Sense of Style" (PDF). In Meyrowitz, Norman. Conference proceedings on Object-oriented programming systems, languages and applications (OOPSLA '88). ACM. pp. 323–334. doi:10.1145/62083.62113. ISBN 978-0897912846. Archived from the original (PDF) on 1988-09-25. Retrieved 2012-07-05.
Easier software maintenance, less coupling between your methods, better information hiding, narrower interfaces, methods which are easier to reuse, and easier correct.ness proofs using structural induction.
- Lieberherr, Karl; Orleans, Doug; Ovlinger, Johan (October 2001). "Aspect-oriented programming with adaptive methods" (PDF). Commun. ACM. 44 (10): 39–40. CiteSeerX 10.1.1.192.6403. doi:10.1145/383845.383855. Retrieved 2012-07-05.
An adaptive method encapsulates the behavior of an operation into one place, thus avoiding the scattering problem, but also abstracts over the class structure, thus avoiding the tangling problem as well.
- Lieberherr, Karl; Holland, I. (September 1989). "Assuring good style for object-oriented programs". IEEE Software. 6 (5): 38–48. doi:10.1109/52.35588.
- Lieberherr, Karl J. (1995). Adaptive Object-Oriented Software: The Demeter Method with Propagation Patterns. PWS Publishing Company. ISBN 978-0534946029.
- Hunt, Andrew; Thomas, David (2002). "5. Bend, or Break § The Law of Demeter for Functions". The Pragmatic Programmer: From Journeyman to Master. Addison-Wesley. pp. 140–1. ISBN 978-0-13-211917-7.
- Larman, Craig (2005). Applying UML and Patterns (3rd ed.). Prentice Hall. pp. 430–2. (from this book, "Law of Demeter" is also known as "Don't talk to strangers")
- McConnell, Steve (2004). Code Complete (2nd ed.). Microsoft Press. p. 150.
- Palermo, Jeffrey; Scheirman, Ben; Bogard, Jimmy (2009). ASP.NET MVC in Action. Manning Publications. p. 14.
- Law of Demeter (LoD)
- "Object-Oriented Programming: An Objective Sense of Style" (OOPSLA '88 Proceedings) (PDF)
- The Paperboy, The Wallet,and The Law Of Demeter (PDF)
- Phil Haack: "The Law of Demeter is not a Dot Counting Exercise"
- Lieber: "Phil Holland's Law of Demeter"
- "Adaptive Object-Oriented Software, The Demeter Method"