Associating Natural Language Comment and Source Code Entities

Comments are an integral part of software development; they are natural language descriptions associated with source code elements. Understanding explicit associations can be useful in improving code comprehensibility and maintaining the consistency between code and comments. As an initial step towards this larger goal, we address the task of associating entities in Javadoc comments with elements in Java source code. We propose an approach for automatically extracting supervised data using revision histories of open source projects and present a manually annotated evaluation dataset for this task. We develop a binary classifier and a sequence labeling model by crafting a rich feature set which encompasses various aspects of code, comments, and the relationships between them. Experiments show that our systems outperform several baselines learning from the proposed supervision. / * * * Check the beanFactory to see whether the bean * named beanName already exists. Accounts for * the fact that the requested bean may be "in * creation", i.e.: we're in the middle of servicing * the initial request for this bean. From JavaConfig's * perspective, this means that the bean does not * actually yet exist, and that it is now our job to * create it for the first time by executing the logic * in the corresponding Bean method. Said another * way, this check repurposes * ConfigurableBeanFactory#isCurrentlyInCreation * to determine whether the container is calling this * method or the user is calling this method. * @param beanName name of bean to check for * @return true if beanName already exists in * the factory * / boolean factoryContainsBean(String beanName)