A tool for building retrievable code­first Web Services

HIRSCH, MATÍAS; RODRÍGUEZ, ANA; RODRÍGUEZ, JUAN MANUEL; MATEOS, CRISTIAN; ZUNINO, ALEJANDRO; ORDIALES COSCIA, JOSÉ LUIS

San Carlos de Bariloche

Congreso; 2014 IEEE Biennial Congress of Argentina (ARGENCON); 2014

IEEE Seccional Argentina

Although producing high quality WSDL documents is a key factor in a Web Service system success, previous works have shown that WSDL document quality, in terms of readability and discoverability, is often disregarded by service developers. One of the main causes of this is that developers do not write the WSDL documents directly. Instead, these documents are automatically generated from service implementations, which are called code-first Web Services. This work presents a novel tool for assisting Java code-first Web Service development that spots potential issues that might lead to low quality WSDL documents. The approach was empirically evaluated using 81 open-source Web Service implementations. The evaluation shows that the WSDL documents generated using our tool can be more easily retrieved from Web Service registries by users. This indirectly implies that these WSDL documents have a better quality than the ones generated using alternative tools. Resumen A pesar de que la calidad de los documentos WSDL, en términos de legibilidad y facilidad de descubrimiento, es un factor clave en el éxito de los sistemas orientados a servicios. Trabajos anteriores han mostrado que la calidad de éstos tiende a ser baja en la práctica. Una posible causa es que los documentos no son escritos manualmente sino generados automáticamente a partir del código de los servicios, estos son llamados Servicios Web code-first. En este trabajo se presenta una herramienta para asistir al desarrollo de Servicios Web desarrollados en Java mediante la metodología code-first, en donde los documentos WSDL son derivados de la implementación del servicio. La herramienta detecta potenciales problemas a nivel código fuente que pueden afectar la calidad de los documentos WSDL generados. La herramienta fue evaluada utilizando 81 implementaciones de Servicios Web de código abierto. Esta evaluación mostró que los documentos WSDL generados aplicando las mejoras propuestas por la herramienta son más fáciles de encontrar en registros de Servicios Web por los usuarios. Esto sugiere que la calidad de estos documentos WSDL es mayor respecto de aquellos generados mediante herramientas alternativas.