¿Qué es la "relación potencia-peso" de una API?

Question

En la presentación de Bloch, dijo que el diseñador debería buscar buena relación potencia-peso para API. Además, también hizo hincapié en que 'Peso conceptual más importante que a granel'. Supongo que el peso es para 'Peso conceptual', a granel es para el número de métodos de una clase.

Pero yo no podía entender lo que peso conceptual 'es, lo que relación potencia-peso' es. Bienvenido a cualquier explicación!

Bloch dio un ejemplo: List.subList() tiene una buena relación potencia-peso. Si los clientes quieren saber un índice de una lista secundaria, no necesita llamar a un método bajo de "proporción p2" indexOfSubList(a,b,e), sino que puede llamar al List.subList(a,b).indexOf(e). Bloch pensó que esto es 'relación potencia-peso'.

Origen:

API debe ser tan pequeño como sea posible pero no más pequeño

• API debe satisfacer sus necesidades
• En caso de duda se lo saltan
  • Funcionalidad, clases , métodos, parámetros, etc.
  • Siempre puede agrega, pero nunca se puede eliminar
• peso conceptual más importante que la mayor
• buscar una buena relación potencia-peso

Answer 1

Interpretaría el "peso conceptual" como la cantidad de conceptos abstractos que debe aprender y comprender para usar la API. Los conceptos generalmente se asignan a clases públicas, mientras que las clases que no son públicas se agregan al grueso pero no al peso conceptual.

Así que si lo pones técnicamente, una API tiene un alto peso conceptual si un cliente típico de la API tiene que usar explícitamente muchas clases pertenecientes a la API para trabajar con ella.

"buena relación potencia-peso" significa que la API debe utilizar el menor número posible de clases públicas para ofrecer la mayor funcionalidad posible. Eso significa una API debe:

• no añadir conceptos o abstracciones de su propia que no están presentes en el dominio
• Para los dominios complejos, ofrecer accesos directos a las funciones más utilizadas necesaria que permite a un usuario típico de eludir la partes más complejas del dominio

Answer 2

diría que

• poder = la cantidad de funcionalidad provista por la API
• peso = el esfuerzo requerido para aprender la API

Answer 3

Supongo que una API con una buena relación potencia-peso es una API que ofrece mucha funcionalidad (potencia) mientras que requiere poco esfuerzo para trabajar adecuadamente (peso) con ella.

Esto se puede hacer a través de, por ejemplo, "Convention over Configuration". (Tenga en cuenta que esto es sólo un ejemplo, y se puede lograr de muchas maneras.)

sería útil un enlace a la presentación de Bloch, que podría estar refiriéndose a otra cosa :-)

Answer 4

Se refiere a todos lo que obtienes al usar una API. Su ejemplo es para la API de colecciones, donde cada vez que accede a ella, solo obtiene una funcionalidad específica. Por otro lado, algunas API cargarán muchas más cosas solo para darte alguna funcionalidad.

Answer 5

Otro aspecto esencial de la relación potencia-peso de una API o incluso de un idioma en general es su verbosidad. Es decir, cuánto debe escribir para realizar una tarea y la legibilidad del código resultante. En Java, Iterator tiene una mejor relación potencia/peso que Enumeration, la interfaz para la que fue diseñada, simplemente porque Iterator tiene un nombre más corto y nombres de métodos más cortos, que ya no son más de lo que deben ser y hacen el mismo trabajo sin pérdida de claridad (así como el método adicional remove).