Architectural views

6.2 Architectural views

I explained in the introduction to this chapter that architectural models of a software system can be used to focus discussion about the software requirements or design. Alternatively, they may be used to document a design so that it can be used as a basis for more detailed design and implementation, and for the future evolution of the sys- tem. In this section, I discuss two issues that are relevant to both of these:

1. What views or perspectives are useful when designing and documenting a sys- tem’s architecture?

2. What notations should be used for describing architectural models? It is impossible to represent all relevant information about a system’s architecture in

a single architectural model, as each model only shows one view or perspective of the system. It might show how a system is decomposed into modules, how the run-time processes interact, or the different ways in which system components are distributed across a network. All of these are useful at different times so, for both design and doc- umentation, you usually need to present multiple views of the software architecture.

There are different opinions as to what views are required. Krutchen (1995), in his well-known 4+1 view model of software architecture, suggests that there should

be four fundamental architectural views, which are related using use cases or scenar- ios. The views that he suggests are:

1. A logical view, which shows the key abstractions in the system as objects or object classes. It should be possible to relate the system requirements to entities in this logical view.

154 Chapter 6 ■ Architectural design

2. A process view, which shows how, at run-time, the system is composed of inter- acting processes. This view is useful for making judgments about non- functional system characteristics such as performance and availability.

3. A development view, which shows how the software is decomposed for devel- opment, that is, it shows the breakdown of the software into components that are implemented by a single developer or development team. This view is useful for software managers and programmers.

4. A physical view, which shows the system hardware and how software compo- nents are distributed across the processors in the system. This view is useful for systems engineers planning a system deployment.

Hofmeister et al. (2000) suggest the use of similar views but add to this the notion of a conceptual view. This view is an abstract view of the system that can be the basis for decomposing high-level requirements into more detailed specifications, help engineers make decisions about components that can be reused, and represent

a product line (discussed in Chapter 16) rather than a single system. Figure 6.1, which describes the architecture of a packing robot, is an example of a conceptual system view.

In practice, conceptual views are almost always developed during the design process and are used to support architectural decision making. They are a way of communicating the essence of a system to different stakeholders. During the design process, some of the other views may also be developed when different aspects of the system are discussed, but there is no need for a complete description from all per- spectives. It may also be possible to associate architectural patterns, discussed in the next section, with the different views of a system.

There are differing views about whether or not software architects should use the UML for architectural description (Clements, et al., 2002). A survey in 2006 (Lange et al., 2006) showed that, when the UML was used, it was mostly applied in

a loose and informal way. The authors of that paper argued that this was a bad thing.

I disagree with this view. The UML was designed for describing object-oriented systems and, at the architectural design stage, you often want to describe systems at

a higher level of abstraction. Object classes are too close to the implementation to be useful for architectural description.

I don’t find the UML to be useful during the design process itself and prefer infor- mal notations that are quicker to write and which can be easily drawn on a white- board. The UML is of most value when you are documenting an architecture in detail or using model-driven development, as discussed in Chapter 5.

A number of researchers have proposed the use of more specialized architectural description languages (ADLs) (Bass et al., 2003) to describe system architectures. The basic elements of ADLs are components and connectors, and they include rules and guidelines for well-formed architectures. However, because of their specialized nature, domain and application specialists find it hard to understand and use ADLs. This makes it difficult to assess their usefulness for practical software engineering. ADLs designed for a particular domain (e.g., automobile systems) may be used as a

6.3 ■ Architectural patterns 155

Name MVC (Model-View-Controller)

Description Separates presentation and interaction from the system data. The system is structured into three logical components that interact with each other. The Model component manages the system data and associated operations on that data. The View component defines and manages how the data is presented to the user. The Controller component manages user interaction (e.g., key presses, mouse clicks, etc.) and passes these interactions to the View and the Model. See Figure 6.3.

Example Figure 6.4 shows the architecture of a web-based application system organized using the MVC pattern.

When used Used when there are multiple ways to view and interact with data. Also used when the future requirements for interaction and presentation of data are unknown.

Advantages Allows the data to change independently of its representation and vice versa. Supports presentation of the same data in different ways with changes made in one representation shown in all of them.

Disadvantages Can involve additional code and code complexity when the data model and interactions are simple.

Figure 6.2 The model- basis for model-driven development. However, I believe that informal models and view-controller (MVC) notations, such as the UML, will remain the most commonly used ways of docu- pattern

menting system architectures. Users of agile methods claim that detailed design documentation is mostly unused. It is, therefore, a waste of time and money to develop it. I largely agree with this view and I think that, for most systems, it is not worth developing a detailed architectural description from these four perspectives. You should develop the views that are useful for communication and not worry about whether or not your architec- tural documentation is complete. However, an exception to this is when you are developing critical systems, when you need to make a detailed dependability analy- sis of the system. You may need to convince external regulators that your system conforms to their regulations and so complete architectural documentation may be required.