Действительно ли Google Annotations Gallery полезен в производственном коде?
Я мог на самом деле видеть использование для Google Annotations Gallery в реальном коде:
Задержка через код, который так или иначе работает вне всей причины? Короткая жизнь. Mark его с @Magic и идите дальше:
@Magic public static int negate(int n) { return new Byte((byte) 0xFF).hashCode() / (int) (short) '\uFFFF' * ~0 * Character.digit ('0', 0) * n * (Integer.MAX_VALUE * 2 + 1) / (Byte.MIN_VALUE >> 7) * (~1 | 1); }
Это - серьезный вопрос. Это могло использоваться в фактическом обзоре кода?
5 ответов
Вполне. Ну, не все, но многие из них могли бы заменить более длинные комментарии. Это относится не ко многим из этих аннотаций, но некоторые (как в вашем примере) могут быть удобны.
Можно сказать, что эти аннотации представляют наиболее распространенные комментарии в более короткой и, возможно, более читабельной форме.
Позже вы можете обработать их и добавить пороговые значения, скажем, для количества аннотаций @Magic. Если проект становится слишком "магическим", следует принять меры.
Было бы проще использовать комментарии с такими ключами, как "MAGIC", а затем работать с ними. Hudson, Eclipse и другие инструменты могут подсчитывать или отмечать эти случаи.
К вашему сведению, Sonar, похоже, теперь включает плагин улучшенной версии .
Во всяком случае, если вы не догадались, я думаю, что короткое название проекта достаточно ясно описывает намерения этого проекта: заткнуть рот аннотациями того, чем они могут стать, если их оставить свободными: эквивалентом ада о-о-о-2000 XML.
Я определенно вижу, как @CarbonFootprint будет вписываться в несколько клиентских политик CSR, а аннотация @WTF («комментарий») будет действительно удобна, когда вы работаете в новом проекте, где вы не уверены, действительно ли нужен определенный фрагмент кода для работы с какой-то сумасшедшей ошибкой / угловым состоянием, или это просто случайная, оставшаяся хрень, которую никто не знал, как писать лучше в то время .
Думаю, некоторые люди могли пропустить аббревиатуру и дату той галереи аннотаций Google (GAG) 1 апреля ... или, может быть, в некоторых странах это не национальный день для шуток или шуток ...