Convenção desenvolvedor/Convenção código/Indentação

Convenção desenvolvedor/Convenção código/Indentação 1.1 (Edição mínima)

2013-01-09T20:00:48Z

Linha 1

<<TableOfContents>>

Linha 2

Linha 3

Quatro espaços devem ser utilizados como unidade de indentação.

Linha 4

Linha 5

Recomenda-se configurar previamente o editor de código para que esta configuração

Linha 6

seja considerada automaticamente durante as tabulações.

Linha 7

Linha 8

Linha 9

== Comprimento da linha ==

Linha 10

Linha 11

Evite linhas maiores que 80 caracteres, geralmente não mais que 70 caracteres.

Linha 12

Linha 13

Linha 14

== Quebra de linhas ==

Linha 15

Linha 16

Quando uma expressão não se ajusta somente em uma linha, quebre-a de acordo

Linha 17

com estes princípios gerais:

Linha 18

* quebre depois de uma vírgula;

Linha 19

* quebre antes de um operador;

Linha 20

* prefira quebras de maior nível a quebras de menor nível;

Linha 21

* alinhe a nova linha com o início de uma expressão no mesmo nível da linha anterior;

Linha 22

* se as regras acima levarem a um código confuso ou que ultrapasse a margem direita,

Linha 23

* use então indentação com oito espaços.

Linha 24

Linha 25

Linha 26

=== Quebra em chamada de método ===

Linha 27

Linha 28

Eis alguns exemplos de quebra em chamadas de métodos:

Linha 29

Linha 30

}

Linha 31

Linha 32

}

Linha 33

Linha 34

Os dois exemplos a seguir são de quebra de expressões aritméticas. O primeiro é o

Linha 35

preferido, uma vez que a quebra ocorre fora da expressão entre parênteses, a qual está em

Linha 36

um nível mais alto.

Linha 37

Linha 38

}

Linha 39

Linha 40

}

Linha 41

Linha 42

Linha 43

=== Quebra em declaração de método ===

Linha 44

Linha 45

Os dois exemplos a seguir são de indentação para declarações de métodos. O

Linha 46

primeiro é o caso convencional. No segundo exemplo poderia ser deslocada a segunda e

Linha 47

terceira linha para a direita, ao invés de indentar somente com oito espaços.

Linha 48

Linha 49

}

Linha 50

Linha 51

}

Linha 52

Linha 53

Linha 54

=== Quebra em declaração de condicional ===

Linha 55

Linha 56

Quebra de linha para declarações condicionais “if” deveriam usar a regra de 8

Linha 57

espaços, uma vez que a indentação convencional (4 espaços) dificulta a visão do bloco de

Linha 58

código. Por exemplo:

Linha 59

Linha 60

}

Linha 61

Linha 62

}

Linha 63

Linha 64

}

Linha 65

Linha 66

Linha 67

=== Quebra em operador ternário ===

Linha 68

Linha 69

Aqui são apresentadas três maneiras aceitáveis para se formatar operadores ternários:

Linha 70

Linha 71

}

Linha 72

Linha 73

}

Linha 74

Linha 75

}

Linha 76

Linha 77

Linha 1

~~New~~

Convenção desenvolvedor/Convenção código/Indentação 1.2 (Edição mínima)

2013-01-09T20:00:48Z

Linha 11

Evite linhas maiores que 80 caracteres, geralmente não mais que 70 caracteres.

Evite linhas maiores que 120 caracteres, geralmente não mais que 100 caracteres.

Convenção desenvolvedor/Convenção código/Indentação 1.3 (Edição mínima)

2013-01-09T20:00:49Z

Convenção desenvolvedor/Convenção código/Indentação 1.4 (Edição mínima)

2013-01-09T20:00:49Z

Convenção desenvolvedor/Convenção código/Indentação 1.5

2013-04-05T16:09:03Z

Linha 3

<<TableOfContents>>

Linha 6

Linha 8

Linha 13

Linha 18

Linha 25

Linha 30

}

Linha 31

{{{

metodo(longExpression1, longExpression2, longExpression3,

longExpression4, longExpression5);

var = metodo1(longExpression1,

metodo2(longExpression2,

longExpression3));

}}}

Linha 38

}

Linha 47

{{{

longName1 = longName2 * (longName3 + longName4 - longName5)

+ 4 * longname6; // PREFIRA ESTA QUEBRA

Linha 51

longName1 = longName2 * (longName3 + longName4

- longName5) + 4 * longname6; // EVITE ESTA QUEBRA

}}}

Linha 62

{{{

// INDENTAÇÃO CONVENCIONAL

algumMetodo(int umArg, Object outroArg, String aindaOutroArg,

Object maisOutroAinda) {

...

Linha 69

Linha 70

// INDENTAÇÃO COM 8 ESPAÇOS PARA EVITAR INDENTAÇÕES PROFUNDAS

Linha 71

private static synchronized metodoComNomeComprido(int umArg,

Linha 72

Object outroArg, String aindaOutroArg,

Linha 73

Object maisOutroAinda) {

Linha 74

...

Linha 50

Linha 76

}}}

Linha 85

{{{

// NÃO USE ESTA INDENTAÇÃO

if ((condição1 && condição2)

|| (condição3 && condição4)

||!(condição5 && condição6)) { // QUEBRA RUIM

executarAlgumaCoisa(); // TORNA ESTA LINHA FÁCIL DE SE PERDER

Linha 93

Linha 94

// AO INVÉS DISSO, USE ESTA INDENTAÇÃO

Linha 95

if ((condição1 && condição2)

Linha 96

|| (condição3 && condição4)

Linha 97

||!(condição5 && condição6)) {

Linha 98

executarAlgumaCoisa();

Linha 61

Linha 100

Linha 101

// OU USE ESTA OUTRA INDENTAÇÃO

Linha 102

if ((condição1 && condição2) || (condição3 && condição4)

Linha 103

||!(condição5 && condição6)) {

Linha 104

executarAlgumaCoisa();

Linha 63

Linha 106

}}}

Linha 71

}

Linha 114

{{{

alfa = (umaLongaExpressaoLogica) ? beta : gama;

Linha 117

alfa = (umaLongaExpressaoLogica) ? beta

: gama;

alfa = (umaLongaExpressaoLogica)

? beta

: gama;

}}}