Рефакторинг Java в отраслевые стандарты Generics

Question

Кажется, есть некоторые споры по поводу рефакторинга, чтобы использовать дженерики Java в моей текущей команде. У меня вопрос: каковы текущие отраслевые стандарты с точки зрения рефакторинга старого кода Java, чтобы воспользоваться некоторыми из этих функций? Конечно, по отраслевым стандартам я имею в виду лучшие практики. Ссылка на книгу или сайт, на котором они перечислены, получит голос за ответ, поскольку это наименее субъективный способ решения этого вопроса.

Answer 1

Я не думаю, что слепое следование тому, что кто-то еще объявляет «лучшей практикой» или «отраслевым стандартом», является хорошей идеей.Вы в лучшем положении, чтобы решить, стоит ли менять код или нет.

Вопросы, на которые вам нужно ответить, - какие преимущества вы получите от обновления старого кода, сколько это будет стоить и каковыриски?

Основное преимущество заключается в улучшении проверки типов во время компиляции, которая должна помочь обнаруживать ошибки в новом коде, который использует обновленный код.Это может даже выделить ошибки в существующем коде.Код, который использует дженерики, хотя иногда и довольно многословный, обычно более читабелен, так как он явно указывает, какие типы допустимы в каких контекстах.Вам также больше не придется подавлять / игнорировать предупреждения компилятора.

Стоимость - это количество времени, которое потребуется для того, чтобы внести и протестировать необходимые изменения для введения обобщений.Каждый раз, когда вы вносите изменения в код, есть вероятность, что вы можете внести ошибки, так что это риск.Преимущества перевешивают затраты?Это зависит от того, сколько у вас есть кода, как он используется и какие другие требования у вас есть к вашему времени.

Answer 2

Документы этой исследовательской группы MIT могут дать вам несколько полезных рекомендаций:

• Рефакторинг приложений Java для использования общих библиотек
  • Эффективный рефакторинг Java-приложений для использования общих библиотек
    Роберт Фюрер, Фрэнк Тип, Джулиан Долби, Адам Кизун и Маркус Келлер
    ECOOP 2005 --- Объектно-ориентированное программирование, 19-я Европейская конференция, (Глазго, Шотландия), 25-29 июля 2005 г.
  • Методы рефакторинга для переноса приложений в общие классы контейнеров Java
    Фрэнк Тип, Роберт Фюрер, Джулиан Долби и Адам Кизун
    IBM T.J. Исследовательский центр Уотсона Отчет IBM Research RC 23238, (Йорктаун-Хайтс, штат Нью-Йорк, США), 2 июня 2004 г.

Answer 3

Использование Java-дженериков, безусловно, хорошая идея. Это обратно совместимо. Таким образом, кодовая база, которую вы не можете преобразовать, будет продолжать работать с новым кодом.

РЕДАКТИРОВАТЬ : Я должен был упомянуть стирание типа в качестве причины, делающей обратную совместимость.

Answer 4

Best Practices не существует. Это странный термин, который предполагает, что дверь закрывается на «лучшее» конкретного решения ... Использовать дженерики? Да. Немедленно. Это неловкое путешествие, так как многие большие библиотеки (Hibernate, Spring) все еще не в состоянии полностью их охватить ... но, по моему опыту, работа со смесью обобщений и смелых приведений по-прежнему создает лучшую базу кода, чем отсутствие использования их вообще.

Я бы также назначил политику конвертации по мере необходимости вместо какой-то гигантской миссии по рефакторингу.

Answer 5

Ваша команда должна сбалансировать преимущества масштабного рефакторинга с затратами, техническими и бизнес-рисками, связанными с этим ... и другими приоритетами, которые имеет ваша команда.

Аргументы и рекомендации «передового опыта» от людей, которые не понимают ваш проект и бизнес-контекст, здесь просто не актуальны.

Answer 6

Лучшие практики для принятия дженериков? Первая лучшая практика - это «делать». Постарайтесь исключить как можно больше приведений из своего кода. Если вы хотите сделать свою жизнь проще, используйте рефакторинг IntelliJ «Generify» - просто наведите его на всю кодовую базу, дайте ему сделать свое дело, а затем проведите небольшую пост-очистку.

Answer 7

Обычно хорошей идеей является рефакторинг для использования дженериков.

Это не требуется, поэтому не рассматривайте это как неотложную задачу, но вы можете считать, что использование дженериков - это мягкая форма технического долга - так что если у вас есть свободное время и запланирована база кода чтобы иметь долгую и продолжительную жизнь, стоит инвестировать в ее модернизацию.

Основные преимущества:

• Лучшая проверка типов во время компиляции, которая уменьшит количество ошибок
• Удаление ненужных приведений из исходного кода, что делает код более читабельным
• Он все еще обратно совместим со старым кодом (благодаря стиранию типа)

Реального недостатка нет - единственная потенциальная проблема, о которой я могу подумать, - это если вы когда-нибудь захотите перенести код обратно на более ранние версии Java без общей поддержки. Но это было бы очень необычно!

Если вы решите провести рефакторинг в дженерики, я рекомендую следующие шаги:

1. Включите все предупреждения вашего компилятора (Eclipse имеет довольно хорошие предупреждения)
2. Сначала добавьте универсальный тип в ваш класс, например, MyClass<T>
3. Затем измените тип сигнатур любого метода / внутренних полей / структур данных, чтобы использовать T
4. Возможно, в этот момент в коде будет много предупреждений / ошибок. Это нормально, просто проработайте их и исправьте все. Часто ваша IDE может быстро исправить многие из них.
5. Тестовые сценарии записи / рефакторинга, которые демонстрируют общие функции

Это довольно быстро сделать - я думаю, что мне удалось реорганизовать около 10 000 строк кода библиотеки Java, чтобы использовать дженерики менее чем за один день, что включало обновление некоторого клиентского кода.