Você pode criar JETs (Java Emitter Templates) para gerar
arquivos SQLJ que utilizam as informações coletadas pelo assistente de Novo Arquivo SQLJ.
Pré-requisito: Criar um projeto JET no workbench.
Para desempenhar
esta tarefa, você deve ter experiência com a criação de Java Emitter Templates. Para obter informações
sobre como criar Java Emitter Templates, consulte os seguintes artigos
no Web site eclipse.org:
Para economizar espaço nas etapas da tarefa, o caminho completo para o diretório ...\com.ibm.datatools.sqlj
é omitido. O caminho completo é install_directory\eclipse\plugins\com.ibm.datatools.sqlj.
Para
criar e implementar um gabarito JET para o assistente de Novo Arquivo SQLJ:
- Inclua uma estrutura no projeto JET:
- Importe o arquivo SQLJFileSkeleton.skel para seu projeto JET.
O arquivo está no diretório ...\com.ibm.datatools.sqlj\templates\skeleton.
- Crie uma estrutura em seu projeto JET. A estrutura deve definir uma classe
que implementa a interface ISQLTemplate com um método generate()
que aceita IBeanData como um parâmetro.
- Crie seu gabarito no projeto JET. Você pode criar um arquivo
ou importar um dos gabaritos fornecidos com o workbench
e alterar seu conteúdo de acordo com suas necessidades. Os arquivos de gabarito estão no diretório ...\com.ibm.datatools.sqlj\templates.
A diretiva
JET em seu gabarito deve conter:
- Um nome de classe que seja exclusivo entre todos os gabaritos no diretório ...\com.ibm.datatools.sqlj\templates.
Um nome de classe que seja igual ao nome do gabarito é uma boa prática.
- Um atributo skeleton que faça referência à estrutura que está sendo utilizada.
- Inclua o arquivo JAR de tempo de execução para o plug-in SQLJ no caminho de construção Java do projeto.
Na janela Propriedades do projeto, clique em Caminho de Construção Java e,
em seguida, execute uma das seguintes ações na página Bibliotecas:
- Se você tiver criado um arquivo SQLJ com o assistente de Novo Arquivo SQLJ, clique em Incluir
Variável e, em seguida, dê um clique duplo em SQLJPLUGIN
na janela Nova Entrada de Caminho de Classe da Variável.
- Se você não utilizou o assistente de Novo Arquivo SQLJ, clique em Incluir
JARs Externos, vá para o diretório ...\com.ibm.datatools.sqlj
na janela Seleção de JAR e, em seguida, dê um clique duplo no arquivo sqlj.jar.
O arquivo JAR de tempo de execução para o plug-in SQLJ resolve as referências
em seu gabarito para as classes no plug-in SQLJ.
- Após a compilação bem-sucedida do gabarito, copie seu arquivo .sqljjet
para o diretório ...\com.ibm.datatools.sqlj\templates.
Se você tiver criado um novo arquivo de estrutura, copie-o para o subdiretório em ...\com.ibm.datatools.sqlj
correspondente à referência na diretiva JET.
- Inclua a descrição de seu gabarito no arquivo user.properties
no diretório ...\com.ibm.datatools.sqlj\template\properties. Abra o arquivo em um editor de texto e inclua as duas seguintes linhas
após as linhas de comentários:
template_file_name.label=Template name
template_file_name.desc=Template description.
O nome do gabarito especificado na etiqueta está incluído
na lista Gabaritos no assistente de Novo Arquivo SQLJ. Quando o
gabarito estiver selecionado na lista, sua descrição será mostrada na caixa
de exibição ao lado da lista.
- Utilize o assistente para criar um arquivo SQLJ, selecionar seu gabarito
e, em seguida, rever o código resultante no arquivo SQLJ gerado.
Se precisar fazer alterações no gabarito, será possível utilizar
um dos seguintes métodos:
- Utilize um editor de texto para alterar o arquivo de gabarito diretamente no diretório ...\com.ibm.datatools.sqlj\templates.
- Utilize o workbench para alterar o gabarito em seu projeto JET e, em seguida,
copie o arquivo atualizado para o diretório de plug-in SQLJ (...\com.ibm.datatools.sqlj\templates).
Na próxima vez em que utilizar o assistente de Novo Arquivo SQLJ para criar um novo arquivo SQLJ,
o plug-in SQLJ detectará seu arquivo de gabarito alterado e utilizará o gabarito atualizado.