projekty pojava
wymogi formalne
edycja 2015
Jacek Bzdak
Strona przedmiotu
- Przed zajęciami N na stronie przemiotu jest opis zadania do wykonania na zajęcia N+1.
- Opis ze strony Was obowiązuje.
- Osoby które do modelu nie dosłały "raportu" w pdf, mają tydzień na poprawkę.
- Dodatkowo informuję o zakładce materiały, na której będę zamieszczał materiały rozwiązujące konkretne problemy jakie możecie mieć w swoim projekcie
Dalsze wymagania:
- Na następne zajęcia będę prosił przygotowanie pierwszej wersji interfejsu graficznego.
- Do tego każdy zespół powinien przygotować dwa pytania: "Jak to zrobić" --- które opiszą dwie rzeczy które powinni zrobić w projekcie, a nie wiedzą jak (jeśli wydaje wam się że nie macie takich pytań to nie przemyśleliście projektu dostatecznie.
Załączanie projektów
Projekty proszę załączać jako spakowane projekty Eclipse (lub innego IDE z którego korzystacie).
Nie będę przyjmował zgłoszeń zawierających kilka oddzielnych plików java.
Dobre nazwy są ważne
Co robi funkcja:
doStuff(double a)calculateElectronScatteringAngle(double initialPhotonEnergyMeV, double photonScatteringAngleRad)Wymogi formalne
Nazwy klas
interfejsów i typów wyliczeniowych
Wymagania
- Z dużej litery
- Pisane camelCase.
- Nazwy opisują klasę
- Po angielsku
Poprawne przykłady:
JButton, JFreeChart, DriverManager, FooBar, ComptonExperiment
Niepoprawne przykłady
- MojaKlasa, Frame, MyFrame - nazwa nic nie mówi o klasie
- compton_experiment - nie poprawny format nazwy
Nazwy zmiennych i metod
Wymagania
- Z małej litery
- Pisane camelCase.
- Nazwy opisują zmienną
- Po angielsku
Przykłady poprawne
- photonEnergyMeV, scatteringAngleDeg
- ii -- w przypadku zmiennych używanych w pętlach
Przykłady błędne
- zmienna, i -- nic nie mówi
- gamma_angle -- nie camelCase
Wcięcia w kodzie
- Proszę stosować się do używania wcięć w kodzie.
- Szczególnie, że Eclipse potrafi automatycznie formatować kod.
- Dodatkowo proszę pilnować maksymalnej długości linii na poziomie 100 znaków.
- Można wtedy pracować mając otwarte dwa pliki obok siebie
Komentarze
- Kod powinien być zrozumiały.
- I mieć jakieś komentarze, w wersji minimum: każda klasa ma swój komentarz
- Komentarze muszą dodawać informacje których nie można zgadnąć z nazwy klasy.
- Proszę stosować komentarze JAVADOC.
Kwestia autorstwa
- Każda klasa może mieć określonego autora (albo dwóch autorów)
- Autora klasy określamy w komentarzu klasy.
- Brak określonego autora oznacza że klasę wykonały obie osoby.
- Określenie autora będzie służyć do określenia zakresu pytań na kolokwium (nie będę pytać o szczegóły klasy osobę która nie jest jej autorem --- mogę pytać o ogólne informacje o klasie).
Paczka
Państwa kod powinien znajdować się w paczce:
pl.edu.pw.fizyka.pojava.[[cokolwiek]]
np:
pl.pw.edu.fizyka.pojava.compton
Dla zainteresowanych
Jakość kodu
- Dobrze (nie jest to wymóg) jeśli program kompiluje się bez ostrzeżeń (przy włączonych wszystkich ostrzeżeniach: -Xlint)
- Zachęcam do korzystania z http://findbugs.sourceforge.net/
Ostrzeżenia
- Wyeliminowanie ostrzeżeń z programu może wam pomóc go pisać.
- Ostrzeżenie kompilatora to (tak na prawdę) miejsce w którym kompilator widzi (potencjalny) błąd.
- Każde narzędzie które pozwala na rozwiązanie problemu, zanim natrafi na niego użytkownik jest dobre.
Projekty pojava formalne 2015
By Jacek Bzdak
Projekty pojava formalne 2015
- 1,578
