1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
<chapter id="code-import-generation">
<title
>Importação de Código e Geração de Código</title>
<para
>O &umbrello; é uma ferramenta de modelagem &UML;, e como tal seu principal propósito é auxiliá-lo na <emphasis
>análise e desenho</emphasis
> de seus sistemas. No entanto, para fazer a transição entre seu desenho e sua <emphasis
>implementação</emphasis
>, o &umbrello; permite gerar código fonte numa linguagem de programação que você conheça. Se você quiser iniciar o uso do &UML; num projeto em C++ já iniciado, o &umbrello; pode auxiliá-lo a criar um modelo de seu sistema a partir do código fonte analisando seu código e importando as classes encontradas nele. </para>
<sect1 id="code-generation">
<title
>Geração de Código</title>
<para
>O &umbrello; pode gerar código fonte a partir de várias linguagens de programação baseadas no seu Modelo &UML; para auxiliá-lo no início com a implementação do seu projeto. O código gerado consiste de declarações de classe, com seus métodos e atributos de modo que você possa <quote
>preencher as lacunas</quote
> fornecendo a funcionalidade das suas operações de classes. </para>
<para
>O &umbrello; 1.2 vem com suporte à geração de código para ActionScript, Ada, C++, CORBA IDL, &Java;, JavaScript, <acronym
>PHP</acronym
>, Perl, Python, SQL e Esquema XML. </para>
<sect2 id="generate-code">
<title
>Gerando Código</title>
<para
>Para gerar código como o &umbrello;, você primeiro precisa criar ou carregar um Modelo contendo pelo menos uma classe. Quando você estiver pronto para iniciar a escrita de algum código, selecione a entrada do <guimenuitem
>Assistente de Geração de Código</guimenuitem
> no menu <guimenuitem
>Código</guimenuitem
> para iniciar um Assistente que o guiará através do processo de geração de código. </para>
<para
>O primeiro passo é selecionar as classes para quais você deseja gerar código fonte. Por padrão todas as classes de seu modelo serão selecionadas, e você pode remover as que não deseja que seja gerado código movendo-as para o lado esquerdo da lista. </para>
<para
>O próximo passo do assistente lhe permite modificar os parâmetros que o Gerador de Código usa ao escrever seu código. As seguintes opções estão disponíveis: </para>
<para>
<screenshot>
<screeninfo
>Opções de Geração de Código</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="generation-options.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Opções para a Geração de Código no &umbrello;</phrase>
</textobject>
<caption>
<para
>Opções para a Geração de Código no &umbrello; </para>
</caption>
</mediaobject>
</screenshot>
</para>
<sect3 id="generation-options">
<title
>Opções Gerais</title>
<!-- LW; to rearrange -->
<sect4>
<title
>Verbosidade do Código</title>
<para
>A opção <guilabel
>Escrever cometários da documentação se vazios</guilabel
> instrui o Gerador de Código a escrever comentários no estilo /** blah */ sempre que o bloco de comentários estiver vazio. Se você adicionar documentação a sua classe, métodos ou atributos em seu Modelo, o Gerador de Código escreverá estes comentários como documentação <application
>Doxygen</application
> a menos que você configure algo aqui, mas se você selecionar esta opção o &umbrello; escreverá blocos de comentários para todas as classes, métodos e atributos se não houver nenhuma documentação no Modelo, caso contrário você deverá documentar suas classes posteriormente diretamente no código fonte. </para>
<para
><guilabel
>Escrever comentários para seções se seção estiver vazia</guilabel
> faz com que o &umbrello; escreva comentários no código fonte para delimitar as diferentes seções de uma classe. Por exemplo <quote
>métodos públicos</quote
> ou <quote
>Atributos</quote
> antes das seções correspondentes. Se você selecionar esta opção o &umbrello; escreverá comentários para todas as seções da classe se a seção estiver vazia. Por exemplo, ele escreverá um comentário <quote
>métodos protegidos</quote
> se existem métodos não protegidos em sua classe. </para>
</sect4>
<sect4>
<title
>Pastas</title>
<para
><guilabel
>Gravar todos os arquivos gerados para pasta</guilabel
>. Aqui você pode selecionar a pasta onde deseja que o &umbrello; coloque os fontes gerados. </para>
<para
>A opção <guilabel
>Incluir arquivos de cabeçalho da pasta</guilabel
> permite-lhe inserir um cabeçalho no início de cada arquivo gerado. Arquivos de cabeçalho podem conter informações de direito de cópia ou licença e conter variáveis que serão avaliados no momento da geração. Você pode dar uma olhada nos arquivos modelos de cabeçalho fornecidos com o &umbrello; para ver como usar estas variáveis para substituir seu nome ou a data atual no momento da geração. </para>
</sect4>
<sect4>
<title
>Política de Sobrescrever</title>
<!-- FIXME update for Umbrello 1.2's new C++ and Java code generators -->
<para
>Esta opção diz ao &umbrello; o que fazer se o arquivo que está sendo criado já existe na pasta destino. O &umbrello; <emphasis
>não pode modificar arquivos fonte existentes</emphasis
>, logo você deve escolher entre sobrescrever o arquivo existente, pular a geração do arquivo em particular ou deixar o &umbrello; escolher um nome de arquivo diferente. Se você escolher a opção de usar um nome diferente, o &umbrello; adicionará um sufixo ao nome do arquivo. </para>
</sect4>
<sect4>
<title
>Linguagem</title>
<para
>O &umbrello; irá gerar por padrão código na linguagem que você tiver selecionado como Linguagem Ativa, mas com o Assistente de Geração de Código você tem a opção de mudar isto para outra linguagem. </para>
</sect4>
</sect3
><!--generation-options-->
<sect3 id="generation-wizard-generation">
<title
>Geração do Assistente de Geração</title>
<para
>O terceiro e último passo do assistente mostra o estado do processo de Geração de Código. Você precisa somente clicar no botão Gerar para ter suas classes escritas para você. </para>
<para
>Observe que as Opções que você selecionou durante o assistente de Geração de Código são válidas somente para a geração atual. Na próxima vez que executar o Assistente você precisará re-selecionar todas as opções (sua pasta de cabeçalhos, política de sobrescrever, e assim por diante). Você pode configurar os padrões usados pelo &umbrello; na seção <guilabel
>Geração de Código</guilabel
> das configurações do Umbrello, disponível em <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar &umbrello;...</guimenuitem
></menuchoice
> </para>
<para
>Se você tiver configurado suas opções de Geração de Código para as configurações corretas e desejar gerar algum código da mesma maneira sem passar pelo assistente, você pode selecionar a entrada <guimenuitem
>Gerar Todo Código</guimenuitem
> no menu Código. Isto irá gerar código para todas as classes em seu Modelo usando suas configurações atuais (incluindo Pasta de Saída e Política de Sobrescrever, logo use com cuidado). </para>
</sect3>
</sect2
><!--generate-code-->
</sect1
> <!--code-generation-->
<sect1 id="code-import">
<title
>Importar Código</title>
<para
>O &umbrello; pode importar código fonte de seus projetos existentes para auxiliá-lo a construir o Modelo de seus sistemas. O &umbrello; 1.2 suporta somente código fonte C++, mas outras linguagens devem estar disponíveis em versões futuras. </para>
<para
>Para importar classes para seu Modelo, selecione a entrada <guimenuitem
>Importar Classes...</guimenuitem
> no menu <guimenu
>Código</guimenu
>. No diálogo de arquivo selecione os arquivos contendo as declarações de classe C++ e pressione OK. As classes serão importadas e você irá encontrá-las como parte de seu Modelo na Visão Árvore. Observe que o &umbrello; não criará nenhum tipo de Diagrama para mostrar suas classes, elas serão apenas importadas para seu Modelo e então você poderá usá-las mais tarde em qualquer diagrama que desejar. </para>
<para>
<screenshot>
<screeninfo
>Importar Código</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="code-import.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Menu para importação de código fonte no &umbrello;</phrase>
</textobject>
<caption>
<para
>Menu para importação de código fonte no &umbrello; </para>
</caption>
</mediaobject>
</screenshot>
</para>
</sect1>
</chapter
> <!--code-import-generation-->
|
