Refaktoryzacja kodu – dlaczego i kiedy

O czym jest to opracowanie?

Refaktoryzacja kodu

Refaktoryzacja to proces poprawiania struktury kodu bez zmiany jego zewnętrznego zachowania. Celem jest uczynienie kodu bardziej czytelnym, łatwiejszym w utrzymaniu i rozszerzaniu. To nie naprawa błędów ani dodawanie funkcji - to “sprzatanie” kodu, które pozwala zespołowi pracowac efektywniej. Każdy profesjonalny programista musi rozumiec, kiedy i jak refaktoryzowac.

Dlaczego warto to znac?

Utrzymanie kodu - Czysty kod jest łatwy do zrozumienia i modyfikacji
Redukcja błędów - Uproszczony kod ma mniej miejsc na błędy
Praca zespołowa - Inni programisci łatwiej zrozumieja Twoj kod
Profesjonalizm - Refaktoryzacja to codziennosc w pracy programisty

Cel Twojego opracowania

Rozumiec czym jest refaktoryzacja i czym rozni się od przepisywania kodu
Umiec wyjaśnić typowe “zapachy kodu” (code smells) wymagajace refaktoryzacji
Potrafic pokazac przykład refaktoryzacji - kod przed i po
Wiedzieć kiedy refaktoryzowac, a kiedy tego unikac

Zakres obowiazkowy

Elementy merytoryczne

Definicja refaktoryzacji
- Co to jest refaktoryzacja
- Czym rozni się od debugowania i dodawania funkcji
- Zasada: zachowanie zewnętrznego działania
Code smells (zapachy kodu)
- Duplikacja kodu (DRY)
- Długie funkcje
- Zbyt wiele parametrow
- Magiczne liczby i stringi
- Martwy kod
Techniki refaktoryzacji
- Ekstrakcja funkcji
- Zmiana nazw (rename)
- Eliminacja duplikacji
- Uproszczenie warunkow
Kiedy refaktoryzowac
- Przed dodaniem nowej funkcji
- Po naprawieniu błędu
- Podczas code review
- Kiedy NIE refaktoryzowac

Wymagane przykłady kodu

Przykład 1

Przed refaktoryzacja - kod z code smells

Przykład 2

Po refaktoryzacji - ten sam kod po poprawkach

Przykład 3

Ekstrakcja funkcji - wydzielenie fragmentu do osobnej funkcji

Przykład 4

Analiza różnic - co się zmieniło i dlaczego jest lepiej

Zakres rozszerzony (dla wyzszych ocen)

Katalog refaktoryzacji Martina Fowlera
Refaktoryzacja z testami (TDD)
Wzorce projektowe jako cel refaktoryzacji
Narzedzia IDE do automatycznej refaktoryzacji
Techniki: Extract Method, Inline Variable, Replace Temp with Query
Legacy code i strategia “strangler fig”
Metryki kodu (cyklomatyczna złożoność)

Proponowana struktura pracy

Struktura podstawowa

Wstep (0.5 strony) - dlaczego kod “gnije” i trzeba go poprawiac
Definicja refaktoryzacji (1 strona) - czym jest, czym nie jest
Code smells (1.5 strony) - typowe problemy z przykładami
Techniki refaktoryzacji (1 strona) - jak poprawiac kod
Przykład przed/po (1 strona) - konkretny przypadek z analiza
Kiedy refaktoryzowac (0.5 strony) - dobre praktyki
Podsumowanie (0.5 strony)
Bibliografia

Pytania kontrolne

Czy refaktoryzacja zmienia funkcjonalnosc programu?
Co oznacza zasada DRY i jak się łączy z refaktoryzacja?
Podaj trzy przykłady “code smells”.
Kiedy NIE powinno się refaktoryzowac?
Co to jest ekstrakcja funkcji (Extract Method)?
Dlaczego refaktoryzacja wymaga dobrych testow?

Najczestsze błędy

Błąd	Jak poprawic?
Brak przykładów kodu	Pokaz konkretny kod przed i po
Mylenie z debugowaniem	Jasno rozrozni refaktoryzacje od naprawy błędów
Tylko teoria	Przeanalizuj rzeczywisty przykład kodu
Pominiecie code smells	Omow przynajmniej 4-5 typowych problemow
Brak analizy różnic	Wyjaśnij CO i DLACZEGO się zmieniło

Zasoby

Refactoring.com Oficjalna strona Martina Fowlera o refaktoryzacji

Refactoring Guru Katalog technik refaktoryzacji z przykładami

Code Smells Katalog code smells z rozwiazaniami

Clean Code - Robert Martin Książka o pisaniu czystego kodu

Do dziela!

To więcej niz praca zaliczeniowa

Opracowanie tego tematu to szansa, by naprawde zrozumiec jak pisac i utrzymywac wysokiej jakosci kod. Refaktoryzacja to codziennosc każdego profesjonalnego programisty.

Wykorzystaj lekcje - konsultuj watpliwosci, pokazuj postepy! Pracuj iteracyjnie - outline -> draft -> przykłady kodu -> analiza -> redakcja