Ferramentas do JavaServer Faces (Beta) - Notas sobre o Release


1.0 Software Suportado e Especificações
2.0 Limitações
   2.1 Componente Drag and Drop do Faces Não Funciona Corretamente nos Gabaritos de Páginas com Várias Áreas de Conteúdo
   2.2 O Componente File Upload Não Pode Ser Eliminado em uma Página Gerada a partir de um Gabarito de Páginas que Contém um Formulário
   2.3 Componentes Copy and Paste do Faces no Page Designer
   2.4 Emitir Quando Adicionar Recursos de Projetos do Faces
   2.5 Problema de Sincronização do Identificador de Componente do JSF com o Arquivo de Origem Java, Quando Quick Edit View Está Aberta
3.0 Problemas Conhecidos
   3.1 Erro Emitido na Adição de Recursos do Faces ao Projeto
   3.2 Erros na Utilização de Controles JSF em Gabaritos de Páginas

1.0 Software Suportado e Especificações

As ferramentas em torno da tecnologia do JavaServer Faces, como os componentes do Faces na exibição Palette, são consideradas como funções de nível Beta. A documentação referida a esta função é suportada também no nível Beta.
Devido ao fato dos recursos do JavaServer Faces estarem no estado Beta, eles não devem ser utilizados para aplicativos de produção. A IBM não assegura a migração, compatibilidade ou o suporte avançados dos arquivos JavaServer Page que utilizam estes recursos do JavaServer Faces.

2.0 Limitações

2.1 Componente Drag and Drop do Faces Não Funciona Corretamente nos Gabaritos de Páginas com Várias Áreas de Conteúdo

Quando o usuário cria um gabarito de página (baseado em uma página do Faces) que contém várias áreas de conteúdo, ele deve assegurar que uma marcação de formulário do Faces envolve ambas as áreas de conteúdo. Isso pode ser feito de uma das duas maneiras. A primeira e mais direta maneira seria para arrastar e soltar um botão de comandos da paleta em cada uma das áreas de conteúdo na página e excluí-los novamente quando todos os botões forem soltos. Isso forçará que a marcação de formulário seja originada novamente, até que todas as áreas de conteúdo sejam encapsuladas. A alternativa é mostrar o componente do formulário na gaveta de paletas Faces Components e arrastar e soltá-lo no gabarito e nas áreas de conteúdo no componente do formulário.

2.2 O Componente File Upload Não Pode Ser Eliminado em uma Página Gerada a partir de um Gabarito de Páginas que Contém um Formulário

Os usuários podem perceber os problemas quando arrastar e soltar o componente File Upload da paleta em uma página gerada a partir de um gabarito de páginas que já contém a marcação de formulário de faces. A ação soltar precisa conseguir editar os atributos do formulário para concluir a ação de soltar. Há duas alternativas possíveis:
a) Altere a marcação de formulário no gabarito de página, para que ela tenha um atributo enctype. Defina o atributo como "multipart/form-data" por exemplo: <h:form formName="form1" id="form1" enctype="multipart/form-data"></h:form>
b) Coloque a marcação de formulário em uma área editável do gabarito. Isso pode ser feito soltando a área de conteúdo na página e, em seguida, mostrando o item de formulário da paleta e soltando-o na área de conteúdo.

2.3 Componentes Copy and Paste do Faces no Page Designer

Atualmente os recursos recortar, copiar e colar do Page Designer apenas produzirão uma cópia exata de uma marcação JSP e a inserção deles na localização do cursor atual. Isso nem sempre é útil quando se lida com componentes do Faces, porque, muitas vezes, a nova marcação será colada dentro de um controle existente, mesmo se essa não for uma localização válida. Há restrições sobre aninhamentos de marcação e IDs exclusivos que não são apropriadamente tratados hoje em dia apenas por recortar e colar (Ctrl-x/Ctrl-c/Ctrl-v ou ações de menu). Para evitar erros ao manipular controles na área de janela Design, em vez de utilizar o mouse para selecionar e arrastar um controle para mover sua posição. Manter pressionada a tecla Ctrl durante a ação arrastar também pode ser utilizado para copiar um controle do Faces e produzirá uma nova marcação com um ID exclusivo na localização de soltar.

2.4 Emitir Quando Adicionar Recursos de Projetos do Faces

Quando arrastar componentes do Faces da paleta em uma página JSP regular em um projeto Web, você pode ser solicitado a adicionar novos recursos de projetos. Não responda "Yes" para esse prompt, em vez disso, cancele a ação soltar e adicione manualmente o recurso do projeto para componentes do Faces (disponíveis na configuração Properties do projeto). Após o recurso do projeto ser adicionado, repita a ação soltar da paleta.

2.5 Problema de Sincronização do Identificador de Componente do JSF com o Arquivo de Origem Java, Quando Quick Edit View Está Aberta

Quando Quick Edit View está aberta e um componente do Faces é selecionado no Page Designer e a exibição Attribute é utilizada para renomear o ID do componente, a atualização de todas as referências para esse ID não será concluída no arquivo de origem Java correspondente do JSP. Ela renomeará todas as ocorrências desse ID localizado em qualquer lugar no arquivo de origem Java, exceto no método que Quick Edit View está atualmente editando. A solução alternativa é fechar Quick Edit View antes de renomear um componente do Faces através da exibição attributes. Uma solução alternativa é renomear manualmente o ID do componente mencionado nesse método.

3.0 Problemas Conhecidos

3.1 Erro Emitido na Adição de Recursos do Faces ao Projeto

Ao adicionar recursos do Faces a um projeto Web no Linux (selecionando-os no assistente para projeto ou criando o primeiro JSP do Faces nesse projeto), o usuário pode ver uma mensagem de erro NullPointerException aparecer na janela utilizada para iniciar o produto. Esse erro é inofensivo e pode ser seguramente ignorado.

3.2 Erros na Utilização de Controles JSF em Gabaritos de Páginas

Ao utilizar gabaritos de páginas, pode haver alguns casos em que soltar ou mover marcações do Faces resulta no posicionamento de marcação incorreto. Para a página funcionar no tempo de execução, a marcação "use_faces" deve envolver todas as outras marcações do Faces na página. Se você descobrir isso, não será possível solucionar isso cortando e colando "use_faces" em uma localização melhor que envolve todas as outras marcações do Faces.

Retornar para o arquivo Leia-me principal