Стилистика кодописания.

[Fintch]

Здравствуйте!

Уважаемые гуру-программисты, поделитесь советами как писать код красиво, грамотно?
Нет, я не конечно понимаю, что в конечном итоге каждый пишет код так как ему удобнее, но..
Мне интересно, существуют какие-то стилистики у опытных программистов на ActionScript 3.0?

Может есть какие-то статьи?
Я нашел вот такую: ссылка
Но хотелось бы более подробное узнать о всех деталях)
Я часто вижу как используют

this.nameFunction

, или задают имя закрытому методу как

_privateMethod

и тп.

Есть же какие-то каноны стилистики?)

Очень хотелось бы узнать об этом подробнее!
Подскажите пожалуйста..

[Krusty]

Совершенный код С. Макконнелл
ИМХО, это лучшее по теме.

[in4core]

Все поля класса _poleName , публичные poleName
Все локальные переменные poleName
Все методы methodName

this используем для всех полей класса. Для локальных не используем.
Названия классов с Большой буквы.
Названия интерфейсов IName
Названия констант БОЛЬШИМИ буквами

private function flush(size:int = 0):void
{
   this._privateVar = 5 * size;
   this._privateVar2 = this._privateVar3 / this._privateVar4;
   super.useWheel(this._privateVar5);
   if(!size || this._privateBoolean) trace("ok");
}

Это абсолютно читабельно, если еще и названия переменных соответсвующие будут )

[dimarik]

Периодически такие темы поднимаются.

[Aquahawk]

Я сторонник того что кодстаил должен быть и точка. Какой не так важно. Я раньше был всегда против явного указания this и super, и подчёркивания не ставил, и скобку всегда переносил. А потом я сменил работу где всё вышеперечисленное делается и делается обязательно. Привык быстро.
Также я сторонник того чтобы одна конструкция всегда делалась однозначно, т.е. я сторонник всегда в ифе писать скобки и всегда переносить строку для следующей инструкции даже если она там одна
не так

if (!isValid(value)) return;

а

if (!isValid(value)) {
return;
}

табуляция кривая потому что тут прямо код написал.
И побуждений тут несколько.
1. Не надо каждый раз думать надо переносить или нет, надо скобки или нет. Чем меньше думаешь над повседневными кострукциями тем лучше.
2. При расширенни функционала всё однозначно, просто добавишь строки, не надо смотреть один там оператор был или нет, ставить скобки или нет.

[КорДум]

http://sourceforge.net/adobe/wiki/Pr...nthandlernames
А здесь была адобовская конвенция. Никто не в курсе, куда она делась? Очень даже в тему бы подошло.

[Bgg]

Как тимлид скажет, так и пишите. Если вы - тимлид, то пишите как вы считаете нужным.

[Fintch]

@Krusty Спасибо, но книга слишком абстрактна, много теории. Мне скорее нужнен практический материал, с примерами. И конечно, лучше по AS3.

@in4core Интересно. Я так все и делаю, почти) А методы вызывают с использованием this внутри класса?
И как насчет определения метода по типу

private function _init(e:Event = null):void {
    // code
}

function Main():void {
 
    super();
 
    if (stage) this._init();
    else this.addEventListener(Event.ADDED_TO_STAGE, this._init());
 
}

@dimarik Спасибо, просмотрю.

@Aquahawk Я тоже за второй вариант) Когда код большой легко зрительно выделять именно такие конструкции. В первом варианте не так четко выделяется.

@Bgg К сожалению, я единственный программист на AS3 в нашей маленькой студии)

Написал большой проект, около 7 месяцев) и в процессе написания т.к. я учился стилистика кода менялась и сейчас хочется определиться с более менее четкой стилистикой и само собой интересно как пишут уже опытные программисты на AS3.

[Wadimir]

В каждой конторе может устанавливается своя конвенция.

[in4core]

Методы с _ я считаю лишним . Без подчеркивания у нас только паблик ( 10% ) и локал ( 20% ) , поэтому разграничение отличное, а если и методы с подчеркиванием , то уже 50%-50% выходит, тоесть хуже.
Методы с использованием this - так же считаю лишним, ведь методы ВСЕГДА this ) , а если метод суперкласса мы так и пишем super.method()

Скобки переношу всегда так

if(a)
{
 //
}

Не придерживаюсь написание if со скобами и без, если 1 строчный пишу без скобок. НО есть правило, если конструкция

if(a) a
else
{
 b
 c
}

то для if так же скобки.