Mapeo de ejemplos de código fuente para dar apoyo en el uso de APIS

Abstract

Los desarrolladores de software con frecuencia recurren a Interfaces de Programación de Aplicaciones (APIs) para extender la funcionalidad de sus programas. El uso de APIs, que son un conjunto de reglas y convenciones mediante las que un programa puede comunicarse con otro, puede ocasionar defectos en el código fuente, como por ejemplo: defectos funcionales y/o de rendimiento. Cuando un desarrollador desconoce el uso de una API, desea aprender más sobre su uso, o su código fuente no funciona como espera, busca manualmente ejemplos de la funcionalidad provista por la API. Esta tarea puede consumir mucho tiempo y ser propensa a errores. Por ejemplo, cuando inserta en su código la invocación a un método sin conocer bien los parámetros que debe enviar y luego el método no retorna el resultado esperado. En la presente tesis se propone apoyar a los desarrolladores mediante la sugerencia de ejemplos de buen uso de las APIs. Los ejemplos son presentados en orden de relevancia, de acuerdo al código que están escribiendo los desarrolladores que usan la API. La implementación de esta solución consiste en la construcción y uso de un repositorio de ejemplos de código fuente, junto a un plug-in creado para el entorno de desarrollo Eclipse. El plug-in realiza la búsqueda de ejemplos del repositorio, muestra los ejemplos por orden de mayor a menor similitud y permite integrar el código fuente de un ejemplo en el editor de código fuente. La utilidad de la herramienta ha sido validada por medio de un estudio con usuarios, donde se evaluó que el plug-in ayuda a desarrolladores con poco conocimiento de una API a hacer un mejor y más rápido uso de éstas. A los desarrolladores se les asignó dos tareas de programación para completar, una de ellas utilizando el plug-in y la otra mediante la búsqueda de ejemplos en Internet. Como resultado, se encontró que los desarrolladores terminaron las tareas hasta un 66% más rápido cuando usaron el plug-in, respecto de la búsqueda en Internet, y en su código fuente no se encontraron casos de mal uso de las APIs. En base a los resultados obtenidos, se concluye que, pese a que la técnica planteada tiene sus limitaciones, se pueden obtener buenos resultados con la solución propuesta en la medida que el repositorio contenga los ejemplos que el desarrollador necesita. Como uno de los siguientes pasos se considera importante lograr una mejor precisión en los resultados de la búsqueda de los ejemplos, para que esta solución sea de mayor utilidad a los desarrolladores.