Identifying and addressing problems in object-oriented framework reuse

D. Kirk, M. Roper, M. Wood

Research output: Contribution to journalArticle

23 Citations (Scopus)

Abstract

This paper describes the results of a long-term empirical investigation into object-oriented framework reuse. The aim is to identify the major problems that occur during framework reuse and the impact of current documentation techniques on these problems. Four major reuse problems are identified: understanding the functionality of framework components; understanding the interactions between framework components; understanding the mapping from the problem domain to the framework implementation; understanding the architectural assumptions in the framework design. Two forms of documentation are identified as having the potential to address these problems, namely pattern languages and micro-architecture descriptions. An in-depth, qualitative analysis suggests that, although pattern languages do provide useful support in terms of introducing framework concepts, this can be bypassed by developers using their previous knowledge, occasionally to the detriment of the final solution. Micro-architecture documentation appears to provide support for simple interaction and functionality queries, but it is not able to address large scale interaction problems involving multiple classes within the framework. The paper concludes that, although a combination of pattern language and microarchitecture documentation is useful for framework reuse, the forms of these documentation types used in this study require further enhancement to become effective. The paper also serves as an example to encourage others to perform evaluation of framework understanding and documentation.
LanguageEnglish
Pages243-274
Number of pages31
JournalEmpirical Software Engineering
Volume12
Issue number3
DOIs
Publication statusPublished - Jun 2007

Keywords

  • object-oriented frameworks
  • documentation
  • empirical study
  • software comprehension
  • qualitative study
  • framework reuse

Cite this

@article{12c092bab97b4b739dcdbd927b2b7222,
title = "Identifying and addressing problems in object-oriented framework reuse",
abstract = "This paper describes the results of a long-term empirical investigation into object-oriented framework reuse. The aim is to identify the major problems that occur during framework reuse and the impact of current documentation techniques on these problems. Four major reuse problems are identified: understanding the functionality of framework components; understanding the interactions between framework components; understanding the mapping from the problem domain to the framework implementation; understanding the architectural assumptions in the framework design. Two forms of documentation are identified as having the potential to address these problems, namely pattern languages and micro-architecture descriptions. An in-depth, qualitative analysis suggests that, although pattern languages do provide useful support in terms of introducing framework concepts, this can be bypassed by developers using their previous knowledge, occasionally to the detriment of the final solution. Micro-architecture documentation appears to provide support for simple interaction and functionality queries, but it is not able to address large scale interaction problems involving multiple classes within the framework. The paper concludes that, although a combination of pattern language and microarchitecture documentation is useful for framework reuse, the forms of these documentation types used in this study require further enhancement to become effective. The paper also serves as an example to encourage others to perform evaluation of framework understanding and documentation.",
keywords = "object-oriented frameworks, documentation, empirical study, software comprehension, qualitative study, framework reuse",
author = "D. Kirk and M. Roper and M. Wood",
year = "2007",
month = "6",
doi = "10.1007/s10664-006-9027-z",
language = "English",
volume = "12",
pages = "243--274",
journal = "Empirical Software Engineering",
issn = "1382-3256",
number = "3",

}

Identifying and addressing problems in object-oriented framework reuse. / Kirk, D.; Roper, M.; Wood, M.

In: Empirical Software Engineering, Vol. 12, No. 3, 06.2007, p. 243-274.

Research output: Contribution to journalArticle

TY - JOUR

T1 - Identifying and addressing problems in object-oriented framework reuse

AU - Kirk, D.

AU - Roper, M.

AU - Wood, M.

PY - 2007/6

Y1 - 2007/6

N2 - This paper describes the results of a long-term empirical investigation into object-oriented framework reuse. The aim is to identify the major problems that occur during framework reuse and the impact of current documentation techniques on these problems. Four major reuse problems are identified: understanding the functionality of framework components; understanding the interactions between framework components; understanding the mapping from the problem domain to the framework implementation; understanding the architectural assumptions in the framework design. Two forms of documentation are identified as having the potential to address these problems, namely pattern languages and micro-architecture descriptions. An in-depth, qualitative analysis suggests that, although pattern languages do provide useful support in terms of introducing framework concepts, this can be bypassed by developers using their previous knowledge, occasionally to the detriment of the final solution. Micro-architecture documentation appears to provide support for simple interaction and functionality queries, but it is not able to address large scale interaction problems involving multiple classes within the framework. The paper concludes that, although a combination of pattern language and microarchitecture documentation is useful for framework reuse, the forms of these documentation types used in this study require further enhancement to become effective. The paper also serves as an example to encourage others to perform evaluation of framework understanding and documentation.

AB - This paper describes the results of a long-term empirical investigation into object-oriented framework reuse. The aim is to identify the major problems that occur during framework reuse and the impact of current documentation techniques on these problems. Four major reuse problems are identified: understanding the functionality of framework components; understanding the interactions between framework components; understanding the mapping from the problem domain to the framework implementation; understanding the architectural assumptions in the framework design. Two forms of documentation are identified as having the potential to address these problems, namely pattern languages and micro-architecture descriptions. An in-depth, qualitative analysis suggests that, although pattern languages do provide useful support in terms of introducing framework concepts, this can be bypassed by developers using their previous knowledge, occasionally to the detriment of the final solution. Micro-architecture documentation appears to provide support for simple interaction and functionality queries, but it is not able to address large scale interaction problems involving multiple classes within the framework. The paper concludes that, although a combination of pattern language and microarchitecture documentation is useful for framework reuse, the forms of these documentation types used in this study require further enhancement to become effective. The paper also serves as an example to encourage others to perform evaluation of framework understanding and documentation.

KW - object-oriented frameworks

KW - documentation

KW - empirical study

KW - software comprehension

KW - qualitative study

KW - framework reuse

UR - http://dx.doi.org/10.1007/s10664-006-9027-z

U2 - 10.1007/s10664-006-9027-z

DO - 10.1007/s10664-006-9027-z

M3 - Article

VL - 12

SP - 243

EP - 274

JO - Empirical Software Engineering

T2 - Empirical Software Engineering

JF - Empirical Software Engineering

SN - 1382-3256

IS - 3

ER -