¿Qué se entiende por "código auxiliar de método generado TODO"? [cerrado]

9

Estoy usando eclipse para la programación de Android, y de vez en cuando veo la declaración, "TODO trozo de método generado automáticamente".

Entiendo que estos métodos se generaron automáticamente por eclipse al crear clases y otras actividades de activación, pero no entiendo la necesidad de que se mencione en todas partes.

¿Cuál es la necesidad de que se mencione en todas partes repetidamente?

android coding-standards eclipse

1

puedes cambiar la plantilla en Eclipse si no te gusta

— DPM

3

Esta pregunta parece estar fuera de tema porque no demuestra una comprensión mínima del IDE que se está utilizando.

— Jim G.

9

TODO es una de varias palabras clave predeterminadas que indican tareas para realizar en Eclipse. En windows-> Preferences-> Java-> Compiler-> Task Tags, debería ver estas palabras clave. Se piensa agregar un comentario con esta palabra clave para indicar automáticamente las cosas que aún deben completarse, lo cual es conveniente si utiliza estas etiquetas de tareas.

Sin embargo, si no los usa, debe modificar las plantillas de código (Preferencias-> Java-> Estilo de código-> Plantillas de código) para eliminar estos comentarios.

En particular:

Código-> Cuerpo del método
Código-> Cuerpo del constructor
Código-> Capturar cuerpo de bloque

— Neil
fuente

55

Es más que solo Eclipse que admite comentarios TODO: NetBeans, Visual Studio, JetBrains y más también proporcionan una funcionalidad de lista de tareas que extrae de los comentarios de estilo TODO. Además, esto no responde la pregunta que se hace: qué significa el comentario de estilo TODO y cómo tiene valor.

— Thomas Owens

2

Prefiero el comportamiento de Visual Studio (¿ReSharpers?) De generar stubs que, throw new NotImplementedException();dado que son mucho más difíciles de ignorar para un olvido que un método vacío que falla silenciosamente.

— Dan Is Fiddling By Firelight

1

@ThomasOwens Llamó eclipse, no NetBeans, Visual Studio, JetBrains y otros. Además, esto es precisamente lo que TODO significa y cómo se usa.

— Neil

1

@DanNeely También me gusta esto, es por eso que mis plantillas de código generadas automáticamente en Eclipse se ven así:throw new UnsupportedOperationException("Auto-generated method stub"); // TODO Auto-generated method stub

— Simon Lehmann

16

Eclipse crea solo métodos vacíos que devuelven nulo (por lo tanto, "trozo"). Los comentarios se insertan para recordarle al desarrollador que probablemente querrá hacer algo con esos métodos, de lo contrario, ¿por qué deberían existir? Se supone que debes eliminar los comentarios cuando lo hayas hecho.

Si ve esos comentarios por todos lados, entonces (si realmente contienen implementaciones) los desarrolladores son flojos o creen que los comentarios tienen algún otro propósito y, por lo tanto, no los eliminan, o es una indicación de diseño débil, generalmente interfaces que son demasiado grandes y tienen implementaciones (y usuarios) que en realidad no usan todos los métodos en la interfaz.

— Michael Borgwardt
fuente

7

Muchos IDE, incluido Eclipse, usan "TODO" en un comentario para generar listas de tareas. Estas listas de tareas incluyen el texto del comentario y el archivo y método en el que se encuentra el comentario. Esto permite a todos los que usan una herramienta con esta funcionalidad generar listas de cosas que aún están abiertas. También hay algunos otros identificadores comunes, como FIXME o XXX que tienen una funcionalidad similar en algunos IDE. Esta pregunta sobre Stack Overflow pregunta sobre las palabras clave de comentarios en Eclipse y proporciona información adicional.

Cuando autogenere algunas funciones, se espera que inserte su propia implementación. Agrega el código auxiliar apropiado para que su código se compile, pero agrega los comentarios para que pueda encontrar rápidamente los métodos que deben implementarse. Tenga en cuenta que algunas funciones autogeneradas, como las autogeneradas toStringy las hashcodefunciones, no contienen estos comentarios porque no se espera que las modifique.

Hay formas de desactivar la inserción de estos editando las plantillas utilizadas para crear código autogenerado, si eso te molesta tanto. Sin embargo, son útiles. Simplemente buscar en su base de código cosas como TODO y FIXME puede ser la base de una lista de tareas si se combinan con un comentario decente sobre lo que hay que hacer, especialmente en proyectos más pequeños.

— Thomas Owens
fuente

4

TODO simplemente significa "HACER", el código auxiliar se genera pero el desarrollador o programador necesita agregar el código según sea necesario.

— usuario42588
fuente