Automatically locating framework extension examples

ABSTRACT

Using and extending a framework is a challenging task whose difficulty is exacerbated by the poor documentation that generally comes with the framework. Even in the presence of documentation, developers often desire implementation examples for concrete guidance. We propose an approach that automatically locates implementation examples from a code base given lightweight documentation of a framework. Based on our experience with concern-oriented documentation, we devised an approach that uses the framework documentation as a template and that finds instances of this template in a code base. The concern instances represent self-contained and structured implementation examples: the relationships and the roles of parts composing the examples are uncovered and explained. We implemented our approach in a tool and conducted a study comparing the results of our tool with results provided by Eclipse committers, showing that our approach can locate examples with high precision.

REFERENCES

• 1: Michal Antkiewicz , Thiago Tonelli Bartolomei , Krzysztof Czarnecki, Automatic extraction of framework-specific models from framework-based application code, Proceedings of the twenty-second IEEE/ACM international conference on Automated software engineering, November 05-09, 2007, Atlanta, Georgia, USA [doi>10.1145/1321631.1321664]
• 2: Marcel Bruch , Thorsten Schäfer , Mira Mezini, FrUiT: IDE support for framework understanding, Proceedings of the 2006 OOPSLA workshop on eclipse technology eXchange, p.55-59, October 22-23, 2006, Portland, Oregon [doi>10.1145/1188835.1188847]
• 3: Barthélémy Dagenais , Harold Ossher, Aiding evolution with concern-oriented guides, Proceedings of the 3rd workshop on Linking aspect technology and evolution, p.4-es, March 12-16, 2007, Vancouver, British Columbia, Canada [doi>10.1145/1275672.1275676]
• 4: Thomas Eisenbarth , Rainer Koschke , Daniel Simon, Locating Features in Source Code, IEEE Transactions on Software Engineering, v.29 n.3, p.210-224, March 2003 [doi>10.1109/TSE.2003.1183929]
• 5: George Fairbanks , David Garlan , William Scherlis, Design fragments make using frameworks easier, Proceedings of the 21st annual ACM SIGPLAN conference on Object-oriented programming systems, languages, and applications, October 22-26, 2006, Portland, Oregon, USA
• 6: Leiguang Gong , Tim Klinger , Paul Matchen , Peri Tarr , Rosario Uceda-Sosa , Annie Ying , Jian Xu , Xin Zhou, Integrated solution engineering, Companion to the 21st ACM SIGPLAN symposium on Object-oriented programming systems, languages, and applications, October 22-26, 2006, Portland, Oregon, USA [doi>10.1145/1176617.1176695]
• 7: Reid Holmes , Robert J. Walker , Gail C. Murphy, Approximate Structural Context Matching: An Approach to Recommend Relevant Examples, IEEE Transactions on Software Engineering, v.32 n.12, p.952-970, December 2006 [doi>10.1109/TSE.2006.117]
• 8: G. Kiczales, J. Lamping, A. Menhdhekar, C. Maeda, C. Lopes, J.-M. Loingtier, and J. Irwin. Aspect-oriented programming. In Proc. of the 11th European Conf. on Object-Oriented Programming, pages 220--242, 1997.
• 9: Rainer Koschke , Jochen Quante, On dynamic feature location, Proceedings of the 20th IEEE/ACM international Conference on Automated software engineering, November 07-11, 2005, Long Beach, CA, USA [doi>10.1145/1101908.1101923]
• 10: Dapeng Liu , Andrian Marcus , Denys Poshyvanyk , Vaclav Rajlich, Feature location via information retrieval based filtering of a single scenario execution trace, Proceedings of the twenty-second IEEE/ACM international conference on Automated software engineering, November 05-09, 2007, Atlanta, Georgia, USA [doi>10.1145/1321631.1321667]
• 11: David Mandelin , Lin Xu , Rastislav Bodík , Doug Kimelman, Jungloid mining: helping to navigate the API jungle, Proceedings of the 2005 ACM SIGPLAN conference on Programming language design and implementation, June 12-15, 2005, Chicago, IL, USA
• 12: Janet Nykaza , Rhonda Messinger , Fran Boehme , Cherie L. Norman , Matthew Mace , Manuel Gordon, What programmers really want: results of a needs assessment for SDK documentation, Proceedings of the 20th annual international conference on Computer documentation, p.133-141, October 20-23, 2002, Toronto, Ontario, Canada [doi>10.1145/584955.584976]
• 13: Martin P. Robillard , Wesley Coelho , Gail C. Murphy, How Effective Developers Investigate Source Code: An Exploratory Study, IEEE Transactions on Software Engineering, v.30 n.12, p.889-903, December 2004 [doi>10.1109/TSE.2004.101]
• 14: Martin P. Robillard , Gail C. Murphy, Representing concerns in source code, ACM Transactions on Software Engineering and Methodology (TOSEM), v.16 n.1, p.3-es, February 2007 [doi>10.1145/1189748.1189751]
• 15: Naiyana Sahavechaphan , Kajal Claypool, XSnippet: mining For sample code, Proceedings of the 21st annual ACM SIGPLAN conference on Object-oriented programming systems, languages, and applications, October 22-26, 2006, Portland, Oregon, USA
• 16: V. Sundaresan, P. Lam, E. Gagnon, R. Vallée-Rai, L. Hendren, and P. Co. Soot - a java optimization framework. In Proc. of CASCON, pages 125--135, 1999.
• 17: Peri Tarr , Harold Ossher , William Harrison , Stanley M. Sutton, Jr., N degrees of separation: multi-dimensional separation of concerns, Proceedings of the 21st international conference on Software engineering, p.107-119, May 16-22, 1999, Los Angeles, California, United States [doi>10.1145/302405.302457]
• 18: Suresh Thummalapenta , Tao Xie, Parseweb: a programmer assistant for reusing open source code on the web, Proceedings of the twenty-second IEEE/ACM international conference on Automated software engineering, November 05-09, 2007, Atlanta, Georgia, USA [doi>10.1145/1321631.1321663]
• 19: Zhenchang Xing , Eleni Stroulia, UMLDiff: an algorithm for object-oriented design differencing, Proceedings of the 20th IEEE/ACM international Conference on Automated software engineering, November 07-11, 2005, Long Beach, CA, USA [doi>10.1145/1101908.1101919]
• 20: Wei Zhao , Lu Zhang , Yin Liu , Jiasu Sun , Fuqing Yang, SNIAFL: Towards a Static Non-Interactive Approach to Feature Location, Proceedings of the 26th International Conference on Software Engineering, p.293-303, May 23-28, 2004

INDEX TERMS

Primary Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.6 Programming Environments

Additional Classification:
  D. Software
  D.2 SOFTWARE ENGINEERING
      D.2.7 Distribution, Maintenance, and Enhancement

General Terms:
Algorithms, Documentation, Experimentation