Styl, formatowanie kodu - jaka konwencja?

0

Cześć,

Chciałem zapytać Was w jaki sposób formatujecie swój kod, który piszecie. Czy używacie po prostu domyślnych styli formatowania kodu przypisanych w IDE. Czy macie jakiś swój upatrzony i jeśli on różni się w innym IDE (a czasami trzeba pracować w IDE, w którym akurat nie przepadasz) to dostosowujecie pod swoje potrzeby?!

Czy jest ogólny zarys tego jak powinno się programować, bo tu też chodzi o czytelność kodu nie tylko dla mnie, ale również dla innych. Tak by był samodokumentujący się.

Dla przykładu, żeby wyjaśnić o co pytam.

if(){
abc
}

czy moze
if()
{
abc
}

Może są gdzieś jakieś źródła, książki, które dla początkującego programisty rozjaśnią w tym temacie moją wiedzę.

0

Wydaje mi się, że nikt żadnej książki na ten temat nie poświęcił bo i nie ma po co. Domyślne formatowanie w różnych IDE jest zazwyczaj całkiem dobre, jednak myślę, że większość programistów nieco je dostosowuje wedle własnych upodobań. Niemniej jednak jest to chyba raczej indywidualna sprawa, chociaż słyszałem, że czasem wymagane jest aby nie stosować skróconych zapisów instrukcji - bez klamer, ponieważ wówczas łatwiej coś niechcący popsuć.

0

To jest bez znaczenia o ile piszesz spójnie i tak samo jak reszta programistów w zespole.

0

no, ify bez klamer nie przechodzą na code review ;)

0

Jeśli chodzi o literaturę to jest krucho. Jeszcze kilka lat temu Sun udostępniał dokument Java Code Convention, w którym opisane było co i jak. Potem przejął to Oracle i wygląda na to, że ubił (http://www.oracle.com/technetwork/java/index-135089.html linki prowadzą do lochu 404).
Z ciekawych rzeczy to warto rzucić okiem na http://google-styleguide.googlecode.com/svn/trunk/javaguide.html
Oraz na regułki narzędzia checkstyle (domyślne są skonfigurowane pod ten stare sunowskie zalecenia).
Ciekawym dokumentem jest też http://pl.scribd.com/doc/15884743/Java-Coding-Style-by-Achut-Reddy jest to kopia (kolejna wersja) dokumentu Suna z 2000 roku poświęconego temu jak i dlaczego formatować kod. Jest to oryginalny dokument, ale ze względu na swoją obecną lokalizację nie można go uznać za oficjalny papier od Oracle.

Jeśli chodzi o same klamerki to 99% zespołów pisze kod nieskażony formatowaniem znanym z C zatem:

if(con){
    //...
}

Jest poprawnym zapisem (nazywa się to nawiasami K&R). Tak też domyślnie zostanie to sformatowane przez najpopularniejsze IDE (Eclipse, NetBeans, Idea).

1 użytkowników online, w tym zalogowanych: 0, gości: 1