Encapsulation (computer programming)

In software systems, encapsulation refers to the bundling of data with the mechanisms or methods that operate on the data. It may also refer to the limiting of direct access to some of that data, such as an object's components. ^[1] Essentially, encapsulation prevents external code from being concerned with the internal workings of an object.

Encapsulation allows developers to present a consistent interface that is independent of its internal implementation. As one example, encapsulation can be used to hide the values or state of a structured data object inside a class, preventing direct access to them by clients in a way that could expose hidden implementation details or violate state invariance maintained by the methods.

It also encourages programmers to put all the code that is concerned with a certain set of data in the same class, which organizes it for easy comprehension by other programmers. Encapsulation is a technique that encourages decoupling.

All object-oriented programming (OOP) systems support encapsulation, ^{[2] [3]} but encapsulation is not unique to OOP. Implementations of abstract data types, modules, and libraries, among other systems, also offer encapsulation. The similarity has been explained by programming language theorists in terms of existential types. ^[4]

Meaning

In object-oriented programming languages, and other related fields, encapsulation refers to one of two related but distinct notions, and sometimes to the combination thereof: ^{[5] [6]}

• A language mechanism for restricting direct access to some of the object's components. ^{[7] [8]}
• A language construct that facilitates the bundling of data with the methods (or other functions) operating on those data. ^{[1] [9]}

Some programming language researchers and academics use the first meaning alone or in combination with the second as a distinguishing feature of object-oriented programming, while some programming languages that provide lexical closures view encapsulation as a feature of the language orthogonal to object orientation.

The second definition is motivated by the fact that in many object-oriented languages, and other related fields, the components are not hidden automatically and this can be overridden; thus, information hiding is defined as a separate notion by those who prefer the second definition.

The features of encapsulation are supported using classes in most object-oriented languages, although other alternatives also exist.

Encapsulation and inheritance

The authors of Design Patterns discuss the tension between inheritance and encapsulation at length and state that in their experience, designers overuse inheritance. They claim that inheritance often breaks encapsulation, given that inheritance exposes a subclass to the details of its parent's implementation. ^[10] As described by the yo-yo problem, overuse of inheritance and therefore encapsulation, can become too complicated and hard to debug.

Information hiding

Main article: Information hiding

Under the definition that encapsulation "can be used to hide data members and member functions", the internal representation of an object is generally hidden from view outside of the object's definition. Typically, only the object's own methods can directly inspect or manipulate its fields. Hiding the internals of the object protects its integrity by preventing users from setting the internal data of the component into an invalid or inconsistent state. A supposed benefit of encapsulation is that it can reduce system complexity, and thus increase robustness, by allowing the developer to limit the interdependencies between software components.^{[ citation needed ]}

Some languages like Smalltalk and Ruby only allow access via object methods, but most others (e.g., C++, C#, Delphi or Java ^[11] ) offer the programmer a degree of control over what is hidden, typically via keywords like public and private. ^[8] ISO C++ standard refers to protected, private and public as "access specifiers" and that they do not "hide any information". Information hiding is accomplished by furnishing a compiled version of the source code that is interfaced via a header file.

Almost always, there is a way to override such protection – usually via reflection API (Ruby, Java, C#, etc.), sometimes by mechanism like name mangling (Python), or special keyword usage like friend in C++. Systems that provide object-level capability-based security (adhering to the object-capability model) are an exception, and guarantee strong encapsulation.

Examples

Restricting data fields

Languages like C++, C#, Java, ^[11] PHP, Swift, and Delphi offer ways to restrict access to data fields.

Below is an example in C# that shows how access to a data field can be restricted through the use of a private keyword:

classProgram{publicclassAccount{privatedecimal_accountBalance=500.00m;publicdecimalCheckBalance(){return_accountBalance;}}staticvoidMain(){AccountmyAccount=newAccount();decimalmyBalance=myAccount.CheckBalance();/* This Main method can check the balance via the public         * "CheckBalance" method provided by the "Account" class          * but it cannot manipulate the value of "accountBalance" */}}

Below is an example in Java:

publicclassEmployee{privateBigDecimalsalary=newBigDecimal(50000.00);publicBigDecimalgetSalary(){returnthis.salary;}publicstaticvoidmain(){Employeee=newEmployee();BigDecimalsal=e.getSalary();}}

Encapsulation is also possible in non-object-oriented languages. In C, for example, a structure can be declared in the public API via the header file for a set of functions that operate on an item of data containing data members that are not accessible to clients of the API with the extern keyword. ^[12]

// Header file "api.h"structEntity;// Opaque structure with hidden members// API functions that operate on 'Entity' objectsexternstructEntity*open_entity(intid);externintprocess_entity(structEntity*info);externvoidclose_entity(structEntity*info);// extern keywords here are redundant, but don't hurt.// extern defines functions that can be called outside the current file, the default behavior even without the keyword

Clients call the API functions to allocate, operate on, and deallocate objects of an opaque data type. The contents of this type are known and accessible only to the implementation of the API functions; clients cannot directly access its contents. The source code for these functions defines the actual contents of the structure:

// Implementation file "api.c"#include"api.h"structEntity{intent_id;// ID numbercharent_name[20];// Name...andothermembers...};// API function implementationsstructEntity*open_entity(intid){...}intprocess_entity(structEntity*info){...}voidclose_entity(structEntity*info){...}

Name mangling

Main article: Name mangling

Below is an example of Python, which does not support variable access restrictions. However, the convention is that a variable whose name is prefixed by an underscore should be considered private. ^[13]

classCar:def__init__(self)->None:self._maxspeed=200defdrive(self)->None:print(f"Maximum speed is {self._maxspeed}.")redcar=Car()redcar.drive()# This will print 'Maximum speed is 200.'redcar._maxspeed=10redcar.drive()# This will print 'Maximum speed is 10.'

See also

• Inheritance (object-oriented programming)
• Object-oriented programming
• Software design pattern
• Facade pattern

Citations

1. Rogers, Wm. Paul (18 May 2001). "Encapsulation is not information hiding". JavaWorld . Retrieved 2020-07-20.
2. "What is Object-Oriented Programming (OOP)?". App Architecture. Retrieved 2024-03-02.
3. "Encapsulation in Object Oriented Programming (OOPS)". www.enjoyalgorithms.com. Retrieved 2024-03-02.
4. Pierce 2002 , § 24.2 Data Abstraction with Existentials
5. Scott, Michael Lee (2006). Programming language pragmatics (2 ed.). Morgan Kaufmann. p. 481. ISBN   978-0-12-633951-2. Encapsulation mechanisms enable the programmer to group data and the subroutines that operate on them together in one place, and to hide irrelevant details from the users of an abstraction
6. Dale, Nell B.; Weems, Chip (2007). Programming and problem solving with Java (2nd ed.). Jones & Bartlett. p. 396. ISBN   978-0-7637-3402-2.
7. Mitchell, John C. (2003). Concepts in programming languages. Cambridge University Press. p. 522. ISBN   978-0-521-78098-8.
8. Pierce, Benjamin (2002). Types and Programming Languages. MIT Press. p. 266. ISBN   978-0-262-16209-8.
9. Connolly, Thomas M.; Begg, Carolyn E. (2005). "Ch. 25: Introduction to Object DMBS § Object-oriented concepts". Database systems: a practical approach to design, implementation, and management (4th ed.). Pearson Education. p. 814. ISBN   978-0-321-21025-8.
10. Gamma, Erich; Helm, Richard; Johnson, Ralph; Vlissides, John (1994). Design Patterns . Addison-Wesley. ISBN   978-0-201-63361-0.
11. Bloch 2018, pp. 73–77, Chapter §4 Item 15 Minimize the accessibility of classes and members.
12. King, K. N. (2008). C Programming: A Modern Approach (2nd ed.). W. W. Norton & Company. p. 464. ISBN   978-0393979503.
13. Bader, Dan. "The Meaning of Underscores in Python". Improve Your Python Skills. Retrieved 1 November 2019.

References

• Bloch, Joshua (2018). "Effective Java: Programming Language Guide" (third ed.). Addison-Wesley. ISBN   978-0134685991.