jambit ToiletPaper: Architecture in Software Systems – How Pattern Languages Increase Readability and Code Comprehension

Architecture in Software Systems – How Pattern Languages Increase Readability and Code Comprehension

Problem: a bad or completely missing architecture in a software system

It’s a typical scenario – a development team stands in the coffee kitchen and criticizes the bad or completely missing architecture in the software system. This scenario occurs more often in maintenance and further development projects of older software systems. Age plays a decisive role in this case. The older a system is, the higher is the probability of finding a strongly eroded architecture [1].

But what does the development team see as architecture in this scenario and what is missing?

Solution: Increase readability and code comprehension with pattern languages

The development team probably lacks a consistent and uniform use of pattern languages [2] in the existing software system, which would significantly increase readability and code understanding. Pattern languages go one step further than architectural styles (layers, microservices etc.) and provide structuring specifications for classes (or modules, packages etc.) on a hierarchically more detailed level.

A pattern language defines a set of pattern elements and specifies rules for them. These rules determine which responsibilities the individual pattern elements have and how they may interact with each other (mandatory and prohibited rules) [3]. In other words: pattern languages define the use of design patterns and their uniform use throughout the software system.

It is never too late in a project to deal with pattern languages and use them in an individual context – consistently and uniformly throughout the code. Documentation of the pattern language is not only helpful but also recommended. It does not matter whether it is a maintenance or greenfield project. In this sense, pattern languages are a good tool to allow more time in the coffee kitchen for more in-depth discussions about cat videos and computer games.

Examples for pattern elements and their mandatory and prohibition rules

Overview of the business logic in the service layer (mandatory and prohibition rules):

  • Pattern element Service interface: Interface in the package com.example.<productname>.service.api with the naming convention *Service
  • Pattern element Service implementation: Class in package com.example.<productname>.service with the annotation @Service; naming convention *Service<xyz> (default: xyz = Impl)

Using Spring Web MVC in the project (excerpt, mandatory and prohibition rules):

  • Pattern element Model: Is created and filled by the pattern element “Controller”; contains no logic
  • Pattern element View: Template language (e.g. Thymeleaf with templates (*.html) in the resources/templates directory); has only access to the pattern element “Model” and not to “Controller”
  • Pattern element Controller: Defines the endpoints using @RequestMapping annotations and their specializations; the class has the annotation @Controller and as naming convention *Controller; controllers are stateless and contain no business logic

Further Aspects

  • [1] M. Mair and S. Herold, „Towards Extensive Software Architecture Erosion Repairs“ in Software Architecture. 7th European Conference, ECSA 2013, Montpellier, 2013.
  • [2] Christopher Alexander, A Pattern Language. Towns, Buildings, Construction
  • [3] C. Lilienthal, Langlebige Software-Architekturen: Technische Schulden analysieren, begrenzen und abbauen, dpunkt.verlag, 2015.


Author: Matthias Mair / Senior Software Architect / Business Division Automotive Bavaria

Architektur in Softwaresystemen: Wie Mustersprachen Lesbarkeit und Code-Verständnis erhöhen

Cookie Settings

This website uses cookies to personalize content and ads, provide social media features, and analyze website traffic. In addition, information about your use of the website is shared with social media, advertising, and analytics partners. These partners may merge the information with other data that you have provided to them or that they have collected from you using the services.

For more information, please refer to our privacy policy. There you can also change your cookie settings later on.

contact icon

Contact us now