Tamaño de la interfaz (operaciones)
| Sigla | ISO |
| Aspecto | «Tamaño» |
| Se mide en | interfaz |
| Tipo de valor | recuento (entero, mínimo 0) |
| Dirección | más alto es peor |
| Stau Metro | InterfaceSizeOperations |
En pocas palabras
Cuenta los métodos de una interfaz: los que declara y los que hereda de otras interfaces. Cuantos más tiene, más trabajo supone implementarla y más difícil es cambiarla sin romper a quien ya lo ha hecho.
Qué mide
El tamaño del contrato. Cada método abstracto que añades a una interfaz obliga a todas las clases que la
implementan, y a los dobles que la sustituyen en los tests, a ocuparse de él; los default, estáticos y privados
también cuentan, aunque no obligan a nada. Una interfaz grande suele indicar que reúne varios roles; es lo
que el principio de segregación de interfaces (la «I» de SOLID, formulado por Robert C. Martin) desaconseja:
ningún cliente debería depender de métodos que no usa.
Nota. El principio no define ningún número. Esta métrica es un indicador indirecto: avisa de interfaces candidatas a dividirse, pero no demuestra que viole el principio.
Cómo se calcula
Ejemplo
interface I { void i(); default void d() {} static void si() {} private void pi() {} }
interface J extends I { void i(); void j(); }
I:i,d,siypilos declara ella, estáticos, privados ydefaultincluidos: 4.J: declaraiyj(2) y heredad(1).iestá redeclarada, así que no se suma otra vez;sies estático ypiprivado, y no se heredan: 3.
Una interfaz que solo declara void a(); vale 1 y, si otra la extiende y añade void b();, esa vale 2.
Cómo interpretarla
Stau Metro no trae umbrales de referencia para esta métrica, pero la marca como «más alto es peor». Una interfaz de muchos métodos se puede leer como señal de que:
- tiene varios clientes con necesidades distintas: considera dividirla en interfaces más pequeñas y específicas (role interfaces);
- sus implementaciones dejan métodos vacíos o lanzan
UnsupportedOperationException: síntoma claro de una interfaz demasiado ancha.
Cuándo un valor alto es aceptable. Una interfaz que modela de verdad una abstracción amplia y cuyos
implementadores son pocos y controlados, o una interfaz de biblioteca con métodos default que dan una
implementación a los más comunes.
Relación con otras métricas
- «Tamaño de la interfaz (atributos)» (
ISA) y «(operaciones + atributos)» (ISOA): las otras variantes. - «Número de implementaciones» (
IMP): cuántas clases implementan la interfaz; el coste de una interfaz ancha crece con ese número. - «Número de subinterfaces» (
SUB): cuántas interfaces la extienden. - «Tamaño de la clase (operaciones)» (
CSO): el equivalente en clases.
En las herramientas
Stau Metro (InterfaceSizeOperations, a nivel de interfaz). Se calcula para las interfaces, también las
anidadas, en código de producción y de test, pero no para los tipos de anotación ni para las interfaces locales.
Cuenta todos los métodos escritos en la interfaz (abstractos,
default, estáticos y privados) más cada método heredado de las interfaces que extiende, una vez por firma. No
cuenta los métodos estáticos ni privados de las superinterfaces, que no se heredan, ni los de Object que toda
interfaz tiene implícitamente. El valor no depende de que el proyecto tenga un JDK configurado.
MetricsReloaded (ISO). Según su código fuente, toma todos los métodos que el IDE atribuye a la interfaz y a
sus supertipos y resta una cantidad fija, 13, por los de Object, sin otro filtro. Sus valores no tienen por qué
coincidir con los de Stau Metro.
Referencias
- Martin, R. C. (2002). Agile Software Development: Principles, Patterns, and Practices. Prentice Hall (el principio de segregación de interfaces).
- Principio de segregación de interfaces: https://en.wikipedia.org/wiki/Interface_segregation_principle
- MetricsReloaded, código fuente de
InterfaceSizeOperationsCalculator: https://github.com/BasLeijdekkers/MetricsReloaded