Convenção desenvolvedor/Convenção código/Organização de arquivos

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

2013-01-09T20:00:49Z

Linha 1

<<TableOfContents>>

Linha 2

Linha 3

Um arquivo consiste de seções que devem ser separadas por linhas em branco e um comentário opcional identificando cada seção.

Linha 4

Linha 5

Arquivos maiores que 2.000 linhas são “inconvenientes” ou “deselegantes” e devem ser evitados.

Linha 6

Linha 7

Linha 8

Linha 9

== Arquivos de fontes do Java ==

Linha 10

Linha 11

Cada arquivo fonte Java contém uma única classe pública ou uma interface. Quando

Linha 12

classes privadas e interfaces são associadas a uma classe pública, você poderá colocá-las

Linha 13

em um mesmo arquivo fonte. A classe pública ou a interface deverá ser a primeira no

Linha 14

arquivo.

Linha 15

Linha 16

Arquivos fontes Java possuem a seguinte ordem:

Linha 17

* comentários iniciais (opcional);

Linha 18

* instruções de pacotes e importações;

Linha 19

* declarações de classes e interfaces.

Linha 20

Linha 21

Linha 22

=== Comentários iniciais ===

Linha 23

Linha 24

Todos os arquivos fontes deverão começar com um comentário estilo linguagem C que

Linha 25

lista o nome da classe, versão e notas de direitos autorais.

Linha 26

Linha 27

No caso específico do Demoiselle, os arquivos com extensão .java (fonte Java) e .aj

Linha 28

(aspecto AspectJ) devem ser iniciados com o texto a seguir:

Linha 29

Linha 30

}

Linha 31

Linha 32

Note que o ano deve ser preenchido de acordo com a data atual (“2009” no exemplo

Linha 33

citado). Recomenda-se a configuração prévia do ambiente integrado de desenvolvimento

Linha 34

(IDE) para a inclusão automatizada deste texto durante a criação de novo arquivo de fonte.

Linha 35

Linha 36

Linha 37

=== Instruções de pacote e importações ===

Linha 38

Linha 39

A primeira linha sem comentários na maioria dos arquivos de fontes Java é uma

Linha 40

instrução de definição do pacote (i.e. package). Depois disso seguem as instruções de

Linha 41

importações (i.e. import). Por exemplo:

Linha 42

Linha 43

}

Linha 44

Linha 45

}

Linha 46

Linha 47

Linha 48

=== Declarações de classe, interface, enumeração e anotação ===

Linha 49

Linha 50

A tabela seguinte descreve as partes existentes na declaração de uma classe,

Linha 51

interface, enumeração ou anotação na ordem em que as primeiras devem aparecer.

Linha 52

Linha 53

border=1

Linha 54

Linha 55

| | **Parte da declaração** | **Observações**

Linha 56

Linha 57

| 1 | Comentários iniciais de documentação (/**..*/) | Deve conter uma descrição simplificada do componente, no formato de Javadoc.

Linha 58

Linha 59

| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.

Linha 60

Linha 61

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).

Linha 62

Linha 63

| 4 | Variáveis de instância (atributos) | Primeiro variáveis public, então protected e finalmente private.

Linha 64

Linha 65

| 5 | Inicializações estáticas | Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.

Linha 66

Linha 67

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 68

Linha 69

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade. Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 70

Linha 71

| 8 | Classes internas (inner classes) | Declaração das classes internas.

Linha 72

Linha 73

Linha 1

~~New~~

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

2013-01-09T20:00:49Z

Linha 55

| | **Parte da declaração** | **Observações**

Linha 67

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 69

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.

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

2013-01-09T20:00:49Z

Linha 3

<<TableOfContents>>

== Organização de arquivos ==

Linha 9

=== Arquivos de fontes do Java ===

Linha 8

~~== Arquivos de fontes do Java ==~~

Linha 21

==== Comentários iniciais ====

Linha 22

~~=== Comentários iniciais ===~~

Linha 35

==== Instruções de pacote e importações ====

Linha 37

~~=== Instruções de pacote e importações ===~~

Linha 45

==== Declarações de classe, interface, enumeração e anotação ====

Linha 47

Linha 48

~~=== Declarações de classe, interface, enumeração e anotação ===~~

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

2013-01-09T20:00:50Z

Convenção desenvolvedor/Convenção código/Organização de arquivos 1.5 (Edição mínima)

2013-01-09T20:00:50Z

Convenção desenvolvedor/Convenção código/Organização de arquivos 1.6 (Edição mínima)

2013-01-09T20:00:50Z

Convenção desenvolvedor/Convenção código/Organização de arquivos 1.7 (Edição mínima)

2013-01-09T20:00:50Z

Linha 26

No caso específico do Demoiselle, os arquivos com extensão .java (fonte Java) e outros arquivos próprios do projeto (.xml, .properties, etc...)

Linha 27

devem ser iniciados com o texto a seguir:

Linha 26

~~No caso específico do Demoiselle, os arquivos com extensão .java (fonte Java) e .aj~~

Linha 27

~~(aspecto AspectJ) devem ser iniciados com o texto a seguir:~~

Linha 29

Linha 30

* Demoiselle Framework

Linha 31

Linha 32

* ----------------------------------------------------------------------------

Linha 33

* This file is part of Demoiselle Framework.

Linha 34

Linha 35

* Demoiselle Framework is free software; you can redistribute it and/or

Linha 36

* modify it under the terms of the GNU Lesser General Public License version 3

Linha 37

* as published by the Free Software Foundation.

Linha 38

Linha 39

* This program is distributed in the hope that it will be useful,

Linha 40

* but WITHOUT ANY WARRANTY; without even the implied warranty of

Linha 41

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

Linha 42

* GNU General Public License for more details.

Linha 43

Linha 44

* You should have received a copy of the GNU Lesser General Public License version 3

Linha 45

* along with this program; if not, see <http://www.gnu.org/licenses/>

Linha 46

* or write to the Free Software Foundation, Inc., 51 Franklin Street,

Linha 47

* Fifth Floor, Boston, MA 02110-1301, USA.

Linha 48

* ----------------------------------------------------------------------------

Linha 49

* Este arquivo é parte do Framework Demoiselle.

Linha 50

Linha 51

* O Framework Demoiselle é um software livre; você pode redistribuí-lo e/ou

Linha 52

* modificá-lo dentro dos termos da GNU LGPL versão 3 como publicada pela Fundação

Linha 53

* do Software Livre (FSF).

Linha 54

Linha 55

* Este programa é distribuído na esperança que possa ser útil, mas SEM NENHUMA

Linha 56

* GARANTIA; sem uma garantia implícita de ADEQUAÇÃO a qualquer MERCADO ou

Linha 57

* APLICAÇÃO EM PARTICULAR. Veja a Licença Pública Geral GNU/LGPL em português

Linha 58

* para maiores detalhes.

Linha 59

Linha 60

* Você deve ter recebido uma cópia da GNU LGPL versão 3, sob o título

Linha 61

* "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>

Linha 62

* ou escreva para a Fundação do Software Livre (FSF) Inc.,

Linha 63

* 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA.

Linha 64

Linha 29

}

Linha 31

Linha 66

Note que o ano deve ser preenchido de acordo com a data atual (“2009” no exemplo

Note que o ano deve ser preenchido de acordo com a data atual (“2012” no exemplo

Linha 79

}

Convenção desenvolvedor/Convenção código/Organização de arquivos 1.8

2013-04-05T15:35:55Z

Linha 7

Um arquivo consiste de seções que devem ser separadas por linhas em branco e um comentário opcional identificando cada seção.

Linha 17

arquivo.

Linha 19

Linha 29

Linha 33

Linha 35

Linha 33

Linha 39

* This file is part of Demoiselle Framework.

* This file is part of Demoiselle Framework.*

Linha 34

Linha 37

Linha 42

* as published by the Free Software Foundation.

* as published by the Free Software Foundation.*

Linha 38

Linha 42

Linha 46

* GNU General Public License for more details.

* GNU General Public License for more details.*

Linha 43

Linha 45

Linha 48

* along with this program; if not, see <http://www.gnu.org/licenses/>

* along with this program; if not, see <[[http://www.gnu.org/licenses/>|http://www.gnu.org/licenses/>]]

Linha 49

Linha 52

* Este arquivo é parte do Framework Demoiselle.

* Este arquivo é parte do Framework Demoiselle.*

Linha 50

Linha 53

Linha 55

* do Software Livre (FSF).

* do Software Livre (FSF).*

Linha 54

Linha 58

Linha 59

* para maiores detalhes.

* para maiores detalhes.*

Linha 59

Linha 61

* "LICENCA.txt", junto com esse programa. Se não, acesse <http://www.gnu.org/licenses/>

* "LICENCA.txt", junto com esse programa. Se não, acesse <[[http://www.gnu.org/licenses/>|http://www.gnu.org/licenses/>]]

Linha 66

Linha 76

}

Linha 78

{{{

package br.gov.frameworkdemoiselle.stereotype;

import br.gov.frameworkdemoiselle.stereotype.BusinessController;

import br.gov.frameworkdemoiselle.stereotype.ViewController;

}}}

Linha 86

~~border=1~~

Linha 92

Linha 88

| | **Parte da declaração** | **Observações**

Linha 94

**Parte da declaração**

Linha 90

~~| 1 | Comentários iniciais de documentação (/**..*/) | Deve conter uma descrição simplificada do componente, no formato de Javadoc.~~

Linha 96

Linha 92

~~| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.~~

Linha 98

**Observações**

Linha 94

~~| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).~~

Linha 100

Linha 101

|1|

Linha 102

|Comentários iniciais de documentação (/**..*/) **|

Linha 103

Linha 96

~~| 4 | Variáveis de instância (atributos) | Primeiro variáveis public, então protected e finalmente private.~~

Linha 105

Deve conter uma descrição simplificada do componente, no formato de Javadoc.

Linha 98

~~| 5 | Inicializações estáticas | Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.~~

Linha 107

Linha 108

|2|

Linha 100

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 110

Palavra-chave class, interface, @interface ou enum

Linha 102

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 112

Linha 104

~~| 8 | Classes internas (inner classes) | Declaração das classes internas.~~

Linha 114

Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.

Linha 116

|3|

|Variáveis de classe (static) |

Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).

|4|

Variáveis de instância (atributos)

Primeiro variáveis public, então protected e finalmente private.

|5|

Inicializações estáticas

|Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.|

|6|

Métodos construtores

Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

|7|

Métodos convencionais

Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.

|8|

|Classes internas (inner classes)|

Declaração das classes internas.

Convenção desenvolvedor/Convenção código/Organização de arquivos 1.9

2013-04-05T15:37:04Z

Linha 77

importações (i.e. import). Por exemplo:

Linha 84

import br.gov.frameworkdemoiselle.stereotype.ViewController;

}}}

import br.gov.frameworkdemoiselle.stereotype.ViewController;

}}}

Linha 90

~~**Parte da declaração**~~

~~**Observações**~~

~~|1|~~

~~|Comentários iniciais de documentação (/**..*/) **|~~

~~Deve conter uma descrição simplificada do componente, no formato de Javadoc.~~

~~|2|~~

~~Palavra-chave class, interface, @interface ou enum~~

~~Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.~~

~~|3|~~

~~|Variáveis de classe (static) |~~

~~Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).~~

~~|4|~~

~~Variáveis de instância (atributos)~~

~~Primeiro variáveis public, então protected e finalmente private.~~

~~|5|~~

~~Inicializações estáticas~~

~~|Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.|~~

~~|6|~~

~~Métodos construtores~~

~~Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).~~

~~|7|~~

~~Métodos convencionais~~

~~|8|~~

~~|Classes internas (inner classes)|~~

~~Declaração das classes internas.~~

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.0

2013-04-05T15:37:29Z

Linha 87

A tabela seguinte descreve as partes existentes na declaração de uma classe,

interface, enumeração ou anotação na ordem em que as primeiras devem aparecer.

A tabela seguinte descreve as partes existentes na declaração de uma classe,

interface, enumeração ou anotação na ordem em que as primeiras devem aparecer.

|1||

|2||

|3||

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.1

2013-04-05T15:38:44Z

Linha 89

{| border=1

Linha 90

|-----

Linha 91

| || '''Parte da declaração''' || '''Observações'''

Linha 92

|-----

Linha 93

| 1 || Comentários iniciais de documentação (/**..*/) || Deve conter uma descrição simplificada do componente, no formato de Javadoc.

Linha 94

|-----

Linha 95

| 2 || Palavra-chave class, interface, @interface ou enum || Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.

Linha 96

|-----

Linha 97

| 3 || Variáveis de classe (static) || Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).

Linha 98

|-----

Linha 99

| 4 || Variáveis de instância (atributos) || Primeiro variáveis public, então protected e finalmente private.

Linha 100

|-----

Linha 101

| 5 || Inicializações estáticas || Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.

Linha 102

|-----

Linha 103

| 6 || Métodos construtores || Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 104

|-----

Linha 105

| 7 || Métodos convencionais || Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.

Linha 106

Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.

Linha 107

O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 108

|-----

Linha 109

| 8 || Classes internas (inner classes) || Declaração das classes internas.

Linha 110

|-----

Linha 111

Linha 89

~~|1||~~

Linha 90

~~|2||~~

Linha 91

~~|3||~~

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.2

2013-04-05T15:39:11Z

Linha 90

Linha 91

Linha 90

Linha 92

|-----

-----

Linha 91

Linha 93

~~| || '''Parte da declaração''' || '''Observações'''~~

Linha 92

Linha 94

~~|-----~~

'''Parte da declaração''' '''Observações'''

Linha 93

Linha 95

~~| 1 || Comentários iniciais de documentação (/**..*/) || Deve conter uma descrição simplificada do componente, no formato de Javadoc.~~

Linha 94

Linha 96

~~|-----~~

Linha 95

Linha 97

~~| 2 || Palavra~~-~~chave class, interface, @interface ou enum || Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.~~

-----

Linha 96

Linha 98

~~|-----~~

1 Comentários iniciais de documentação (/..*/) Deve conter uma descrição simplificada do componente, no formato de Javadoc.

Linha 97

Linha 99

~~| 3 || Variáveis de classe (static) || Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).~~

-----

Linha 98

Linha 100

|-~~----~~

2 Palavra-chave class, interface, @interface ou enum Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.

Linha 99

Linha 101

~~| 4 || Variáveis de instância (atributos) || Primeiro variáveis public, então protected e finalmente private.~~

-----

Linha 100

Linha 102

~~|-----~~

3 Variáveis de classe (static) Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).

Linha 101

Linha 103

~~| 5 || Inicializações estáticas || Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.~~

-----

Linha 102

Linha 104

~~|-----~~

4 Variáveis de instância (atributos) Primeiro variáveis public, então protected e finalmente private.

Linha 103

Linha 105

| 6 || Métodos construtores || Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

-----

Linha 104

Linha 106

~~|-----~~

5 Inicializações estáticas Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.

Linha 105

Linha 107

~~| 7 || Métodos convencionais || Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.~~

-----

Linha 106

Linha 108

~~Por~~ ~~exemplo, um m~~étodo pr~~ivad~~o de uma classe pode estar entre duas instâncias de m~~éto~~dos públicos.

6 Métodos construtores Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 107

Linha 109

~~O objetivo é tornar a leitura e o entendimento do código algo simples.~~

-----

Linha 108

Linha 110

~~|-----~~

7 Métodos convencionais Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.

Linha 109

Linha 111

| 8 || Classes internas (inner classes) ~~|| De~~clar~~açã~~o das classes internas.

Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 110

Linha 112

~~|-----~~

Linha 111

Linha 113

Linha 114

-----

Linha 115

8 Classes internas (inner classes) Declaração das classes internas.

Linha 116

-----

Linha 117

}

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.3

2013-04-05T15:39:48Z

Linha 88

interface, enumeração ou anotação na ordem em que as primeiras devem aparecer.

Linha 89

|-----

Linha 90

| || '''Parte da declaração''' || '''Observações'''

Linha 91

|-----

Linha 92

| 1 || Comentários iniciais de documentação (/**..*/) || Deve conter uma descrição simplificada do componente, no formato de Javadoc.

Linha 93

|-----

Linha 94

| 2 || Palavra-chave class, interface, @interface ou enum || Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.

Linha 95

|-----

Linha 96

| 3 || Variáveis de classe (static) || Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).

Linha 97

|-----

Linha 98

| 4 || Variáveis de instância (atributos) || Primeiro variáveis public, então protected e finalmente private.

Linha 99

|-----

Linha 100

| 5 || Inicializações estáticas || Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.

Linha 101

|-----

Linha 102

| 6 || Métodos construtores || Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 103

|-----

Linha 104

| 7 || Métodos convencionais || Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.

Linha 105

Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.

Linha 106

O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 107

|-----

Linha 108

| 8 || Classes internas (inner classes) || Declaração das classes internas.

Linha 109

|-----

Linha 110

Linha 90

Linha 91

Linha 92

~~-----~~

Linha 93

Linha 94

~~'''Parte da declaração''' '''Observações'''~~

Linha 95

Linha 96

Linha 97

~~-----~~

Linha 98

~~1 Comentários iniciais de documentação (/..*/) Deve conter uma descrição simplificada do componente, no formato de Javadoc.~~

Linha 99

~~-----~~

Linha 100

~~2 Palavra-chave class, interface, @interface ou enum Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.~~

Linha 101

~~-----~~

Linha 102

~~3 Variáveis de classe (static) Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).~~

Linha 103

~~-----~~

Linha 104

~~4 Variáveis de instância (atributos) Primeiro variáveis public, então protected e finalmente private.~~

Linha 105

~~-----~~

Linha 106

~~5 Inicializações estáticas Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.~~

Linha 107

~~-----~~

Linha 108

6 Métodos construtores Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 109

~~-----~~

Linha 110

~~7 Métodos convencionais Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.~~

Linha 111

Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. O objetivo é tornar a leitura e o entendimento do código algo simples.

Linha 112

Linha 113

Linha 114

~~-----~~

Linha 115

~~8 Classes internas (inner classes) Declaração das classes internas.~~

Linha 116

~~-----~~

Linha 117

}

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.4

2013-04-05T15:45:10Z

Linha 88

|= |='''Parte da declaração'''|='''Observações'''|

Linha 89

| 1 | Comentários iniciais de documentação (/**..*/) | Deve conter uma descrição simplificada do componente, no formato de Javadoc.|

Linha 90

| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.|

Linha 91

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).|

Linha 92

| 4 | Variáveis de instância (atributos) | Primeiro variáveis public, então protected e finalmente private.|

Linha 93

| 5 | Inicializações estáticas | Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.|

Linha 94

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).|

Linha 95

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.

Linha 96

O objetivo é tornar a leitura e o entendimento do código algo simples.|

Linha 97

| 8 | Classes internas (inner classes) | Declaração das classes internas.|

Linha 88

~~{| border=1~~

Linha 89

~~|-----~~

Linha 90

~~| || '''Parte da declaração''' || '''Observações'''~~

Linha 91

~~|-----~~

Linha 92

~~| 1 || Comentários iniciais de documentação (/**..*/) || Deve conter uma descrição simplificada do componente, no formato de Javadoc.~~

Linha 93

~~|-----~~

Linha 94

~~| 2 || Palavra-chave class, interface, @interface ou enum || Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.~~

Linha 95

~~|-----~~

Linha 96

~~| 3 || Variáveis de classe (static) || Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).~~

Linha 97

~~|-----~~

Linha 98

~~| 4 || Variáveis de instância (atributos) || Primeiro variáveis public, então protected e finalmente private.~~

Linha 99

~~|-----~~

Linha 100

~~| 5 || Inicializações estáticas || Este código será executado apenas uma vez durante o carregamento da classe pela Máquina Virtual do Java.~~

Linha 101

~~|-----~~

Linha 102

| 6 || Métodos construtores || Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).

Linha 103

~~|-----~~

Linha 104

~~| 7 || Métodos convencionais || Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.~~

Linha 105

~~Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. ~~

Linha 106

~~O objetivo é tornar a leitura e o entendimento do código algo simples.~~

Linha 107

~~|-----~~

Linha 108

~~| 8 || Classes internas (inner classes) || Declaração das classes internas.~~

Linha 109

~~|-----~~

Linha 110

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.5

2013-04-05T15:46:03Z

Linha 88

Linha 89

|= |=Parte da declaração|=Observações|

Linha 90

| 1 | Comentários iniciais de documentação (/**..*/) **| Deve conter uma descrição simplificada do componente, no formato de Javadoc.|

Linha 88

~~|= |='''Parte da declaração'''|='''Observações'''|~~

Linha 89

~~| 1 | Comentários iniciais de documentação (/**..*/) | Deve conter uma descrição simplificada do componente, no formato de Javadoc.|~~

Linha 95

Linha 96

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. |

Linha 97

Linha 99

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.6

2013-04-05T15:48:23Z

Linha 89

|= |=Parte da declaração|=Observações|

|= |= Parte da declaração |= Observações|

Linha 95

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes ~~ ~~ (i.e. quantidade de argumentos).|

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).|

Linha 96

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos. |

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.|

Linha 97

Linha 98

~~O objetivo é tornar a leitura e o entendimento do código algo simples.|~~

Linha 99

Linha 100

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.7

2013-04-05T15:48:50Z

Linha 89

|= |= Parte da declaração |= Observações|

|= # |= Parte da declaração |= Observações|

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.8

2013-04-05T15:51:01Z

Linha 91

| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem a hierarquia do componente.|

| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem\\a hierarquia do componente.|

Linha 92

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente as privadas (private).|

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente\\as privadas (private).|

Linha 95

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade destes (i.e. quantidade de argumentos).|

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade\\destes (i.e. quantidade de argumentos).|

Linha 96

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo, um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.|

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo,\\um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.|

Convenção desenvolvedor/Convenção código/Organização de arquivos 2.9

2013-04-05T15:51:25Z

Linha 91

| 2 | Palavra-chave class, interface, @interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definem\\a hierarquia do componente.|

| 2 | Palavra-chave class, interface,\\@interface ou enum | Nesta linha deverão aparecer as palavras chave extends e ou implements que definema hierarquia do componente.|

Linha 92

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmente\\as privadas (private).|

| 3 | Variáveis de classe (static) | Primeiramente as variáveis públicas (public) da classe, então as protegidas (protected) e finalmenteas privadas (private).|

Linha 95

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidade\\destes (i.e. quantidade de argumentos).|

| 6 | Métodos construtores | Primeiro o construtor padrão (se existente), e em seguida os demais construtores na ordem de complexidadedestes (i.e. quantidade de argumentos).|

Linha 96

| 7 | Métodos convencionais | Os métodos devem ser agrupados pela funcionalidade de preferência pelo escopo ou acessibilidade.Por exemplo,um método privado de uma classe pode estar entre duas instâncias de métodos públicos.O objetivo é tornar a leitura e o entendimento do código algo simples.|