Criando e Implementando Java Emitter Templates para o Assistente de Novo Arquivo SQLJ

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 ambiente de trabalho.
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:

  1. 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.
  2. Crie seu gabarito no projeto JET. Você pode criar um arquivo ou importar um dos gabaritos fornecidos com o ambiente de trabalho 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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: 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.

Feedback