For Further Reading

The SCR approach to interface specifications is based on a design approach pioneered by Parnas and others [Britton+ 81]. More information about the other interface examples documented in IDL, HLA, and XML is contained in [OMGIDL 02], [IEEEP1 516 00], and [W3GXML 02].

An excellent foundation paper on exceptions, which lays the groundwork for separating the concern of detecting an exception from the concern of handling an exception, is [ParnasWuerges 76].

Mary Shaw has made the observation that we can't have complete interface specifications, because the cast of stakeholders is too numerous and the range of information they need is too broad. And in the world in which we get our components from other sources and know precious little about them, good interface specifications are even more rare. However, she points out that we can and do accomplish useful work with such incomplete knowledge. This is so because we can assign confidence measures to individual units of information that we pick up about a component from various sources. She calls such a unit a "credential," and assigns it properties such as how we know it and what confidence we have in it [Shaw 96].

Interfaces seen as the set of assumptions that two components are allowed to make about each other dates from early work by Parnas [Parnas 71], echoed in more recent work about architectural mismatch [Garlan+ 95].

Software Architectures and Documentation

Part I. Software Architecture Viewtypes and Styles

The Module Viewtype

Styles of the Module Viewtype

The Component-and-Connector Viewtype

Styles of the Component-and-Connector Viewtype

The Allocation Viewtype and Styles

Part II. Software Architecture Documentation in Practice

Advanced Concepts

Documenting Software Interfaces

Documenting Behavior

Choosing the Views

Building the Documentation Package

Other Views and Beyond

Rationale, Background, and Design Constraints

References



Documenting Software Architectures(c) Views and Beyond
Documenting Software Architectures: Views and Beyond
ISBN: 0201703726
EAN: 2147483647
Year: 2005
Pages: 152

Flylib.com © 2008-2020.
If you may any questions please contact us: flylib@qtcs.net