Número de parámetros de tipo
| Sigla | NTP |
| Aspecto | «Tamaño» |
| Se mide en | método, clase, interfaz |
| Tipo de valor | valor numérico entero (en Stau Metro es de tipo score, no de recuento; mínimo 0) |
| Dirección | informativa: ni alto ni bajo es mejor |
| Stau Metro | NumTypeParameters (método), NumTypeParametersClass (clase), NumTypeParametersInterface (interfaz) |
En pocas palabras
Cuenta cuántos «huecos de tipo» declara un elemento genérico. List<T> declara uno; Map<K, V>, dos; una clase sin
<…> declara cero. Indica cuánto se apoya el código en los genéricos.
Qué mide
Mide el grado de parametrización de una declaración. Un elemento con un parámetro de tipo es un contenedor o un
algoritmo genérico sobre un tipo; con varios, sobre una relación entre tipos (Map<K, V>, Function<T, R>). Un
valor alto suele indicar una API más general, pero también más difícil de leer y de usar.
No hay un valor deseable. El interés está en detectar las declaraciones más genéricas, que merecen más documentación y más cuidado, y en ver qué parte del código es de uso general y cuál es específica.
Cómo se calcula
Se cuentan los nombres entre < y > en la declaración, no los argumentos con los que se usa y no los límites:
<T extends Comparable<T>> es 1. Los parámetros heredados no suman: el método de una clase Box<T> que no declara
nada propio vale 0 aunque use T, y una clase interna no cuenta los de la clase que la contiene.
Ejemplo
import java.util.Map;
import java.util.function.Function;
class Box<T> { // clase: 1
private T value;
T get() { // método: 0 (usa T, pero no la declara)
return value;
}
<R> Box<R> map(Function<T, R> f) { // método: 1 (R; T es de la clase)
Box<R> result = new Box<>();
result.value = f.apply(value);
return result;
}
static <K, V extends Comparable<V>> void put( // método: 2 (K y V; el límite no suma)
Map<K, V> map, K key, V value) {
map.put(key, value);
}
class Node { } // clase: 0 (no cuenta la T de Box)
}
interface Pair<A, B> { } // interfaz: 2
Cómo interpretarla
Es informativa y Stau Metro no le da umbral de referencia. Cero significa que la declaración no es genérica; uno, que lo es sobre un único tipo. Con varios parámetros conviene preguntarse si todos hacen falta, porque cada uno se añade a lo que el usuario de la API tiene que entender. Se lee mejor como un inventario de dónde están los genéricos que como una señal de calidad.
Relación con otras métricas
- «Número de parámetros» (
NP): los parámetros de valor del método, que no incluyen los de tipo. - «Número de lambdas» (
LAMBDA): otro recuento de rasgos del lenguaje para ver el uso de construcciones avanzadas. - «Número de clases» (
C): el total de clases, útil para saber qué proporción es genérica.
En las herramientas
Stau Metro. Cuenta los parámetros de tipo que declara el propio elemento:
NumTypeParameters(método): los del método. Los constructores genéricos cuentan como métodos. A diferencia de «STAT», también tienen valor los métodos abstractos y los de interfaz sin cuerpo. Los métodos de una clase anónima o local declarada dentro de otro método no tienen fila propia, y sus parámetros de tipo no suman al método que los contiene.NumTypeParametersClass(clase): se calcula para las clases con nombre, incluidos enumerados y records. Una clase anónima o local no tiene fila ni suma a la que la contiene. Las interfaces y anotaciones se tratan aparte.NumTypeParametersInterface(interfaz): se calcula para las interfaces; las anotaciones no cuentan como interfaces en este nivel.
Stau Metro clasifica la métrica como de tipo score y no como recuento, aunque su valor siempre es entero.
No se ha comprobado que otras herramientas calculen esta métrica, por lo que no se comparan aquí.