Ferramentas da Web - Notas sobre o Release

1.0 Introdução
2.0 Alterações do Release Anterior
3.0 Limitações
   3.1 Casos em Que um Gabarito de Página Não Será Aplicado a uma Página da Web
4.0 Problemas Conhecidos
   4.1 O JSP Validator Não Compila Automaticamente em Alterações Java Dependentes
   4.2 Dica de Desempenho: Fechar Projetos Inativos
   4.3 Dica de Desempenho: Desativar a Validação Automática
   4.4 Ativando e Desativando o Page Designer Classic
   4.5 Limitação de Personalização de Menus da Barra de Ferramentas do Page Designer
   4.6 Aviso de Link Interrompido em Applets
   4.7 Inserindo Applets nos Arquivos HTML e JSP Utilizando o Page Designer
   4.8 Visualizar um Arquivo HTML que Inclua Shockwave Pode Fazer com que o WebSphere Studio Seja Encerrado Bruscamente
   4.9 Problema ao Exibir Alguns Caracteres GB18030 no Windows 2000/XP
   4.10 Problema de BiDi para WebArt Designer, Animated GIF Designer e PageDesigner classic
   4.11 Os JSPs Devem Utilizar Instruções Import Explícitas
   4.12 Suporte a Idiomas Bidirecionais para Page Designer Classic
   4.13 Migrando Dados Relacionais em Projetos da Web do 4.0.3
   4.14 JSPs e Servlets Java que São Projetados em um Ambiente DBCS para um Nível J2EE 1.3 no Servidor WebSphere 5 Exigem um Snippet de Código Extra
   4.15 Arrastando e Soltando Itens em Exibição Quick Edit
   4.16 Utilizando Itens da Exibição Snippet com Ações Simples na Exibição Quick Edit
   4.17 Suporte a Linguagem Mobile para o Page Designer
   4.18 Suporte a Gabaritos de Páginas para o Page Designer
   4.19 Notas para Utilização das Partes do Site com o Web Site Designer
   4.20 Alterando Definições do Sistema para Cores e Fontes
   4.21 Anotações de Pesquisa em Arquivos Não-salvos em Editores
   4.22 Restrições do ClearCase Utilizando o Designer de Web Site ou Gabaritos de Páginas
   4.23 Problema de Envio de Formulário Javascript em JSPs Gerados pelo Database Web Pages Wizard

1.0 Introdução

O ambiente de desenvolvimento da Web no WebSphere Studio fornece as ferramentas necessárias para desenvolver os aplicativos da Web.  Os aplicativos da Web incluem páginas estáticas da Web, JSPs (JavaServer Pages), Java Servlets, um descritor de implementação XML (web.xml) e outros recursos da Web.   O arquivo leia-me descreve os problemas conhecidos, limitações e as soluções alternativas que estão associadas às ferramentas utilizadas no ambiente de desenvolvimento da Web.

2.0 Alterações do Release Anterior

Os nomes de pastas Web Content e Java Source em um projeto da Web são agora, configuráveis. Os nomes padrão são WebContent e JavaSource, no entanto, para novos projetos da Web, eles podem ser alterados em Web Tools->New Project na página Preferences. As pastas de projetos existentes podem ser renomeadas utilizando o Navigator.
NOTA: Os nomes de pastas diferentes do padrão não são compatíveis com o WebSphere Studio Versão 5.0.0. Não altere os nomes padrão, se precisar manter compatibilidade com o espaço de trabalho da versão 5.0.0.

Duas novas exibições foram incluídas na perspectiva Web para auxiliar a edição de páginas HTML/JSP. A exibição Palette contém um conjunto de itens que podem ser arrastados e soltos sobre uma página da Web no Page Designer. A exibição Quick Edit permite que os usuários adicionem/editem scripts e scripts dos eventos de marcação no Page Designer. Para obter detalhes adicionais, consulte o sistema Help.

3.0 Limitações

3.1 Casos em Que um Gabarito de Página Não Será Aplicado a uma Página da Web

Existem algumas circunstâncias que podem fazer com que um gabarito de página não seja aplicado a uma página da Web ao utilizar um dos assistentes para gabarito de página:

4.0 Problemas Conhecidos

4.1 O JSP Validator Não Compila Automaticamente em Alterações Java Dependentes

O JSP validator não revalidará automaticamente um arquivo JSP quando uma classe Java a qual ele faz referência é alterada. Ele poderá ser reexecutado no arquivo selecionando-o no Project Navigator e selecionando Run Validation no menu de contexto.

4.2 Dica de Desempenho: Fechar Projetos Inativos

É recomendável fechar quaisquer projetos com os quais não esteja trabalhando para melhorar o desempenho. Somente projetos abertos são recompilados quando Rebuild All é executado.

4.3 Dica de Desempenho: Desativar Validação Automática

Por padrão, os validadores são automaticamente executados quando você salva recursos em um projeto Web. Se não desejar que os validadores executem automaticamente quando você salvar esses recursos, abra o diálogo Properties do projeto Web a partir do menu de contexto na exibição J2EE Navigator. Em seguida, ative a opção Override validation preferences e desative a opção Run validation automatically when you save changes to resources na página Validation. Você também pode desativar a validação automática (e construções) para todos os projetos, selecionando Window > Preferences e desativando Perform build automatically on resource modification na página Workbench. Se você desativar as construções automáticas, poderá executar manualmente uma construção (e validação), selecionando Project > Rebuild Project.

4.4 Ativando e Desativando o Page Designer Classic

A versão WebSphere Studio V4 do Page Designer (agora conhecido como Page Designer Classic) foi reprojetada para a Versão 5. O novo Page Designer (referido como Page Designer na interface com o usuário e na documentação do produto) é a versão recomendada. É também a versão padrão. O Page Designer Classic não está disponível como um recurso instalável, mas ele pode ser ativado utilizando-se as instruções abaixo.

O Page Designer fornece funcionalidade e recursos aperfeiçoados, como edição de atributos com base na exibição e suporte simplificado à biblioteca de marcações.

Alguns recursos não são transportados do Page Designer Classic. Eles incluem:

A menos que você precise de suporte específico para os recursos incluídos no Page Designer Classic, utilize o Page Designer padrão. Se você desejar ativar o Page Designer Classic, proceda da seguinte forma:

Instalando o Page Designer Classic:

  1. Saia do WebSphere Studio antes de começar a instalação.
  2. No Windows Explorer, abra o diretório WSAD INSTALL DIR/bin e dê um clique duplo em pdclassic.exe.
  3. Quando você iniciar novamente o WebSphere Studio, o diálogo Updates será exibido. Clique no botão Yes.
    Nota: Se esta for a primeira vez que você utiliza o workbench, esta etapas e aquelas que se seguem não ocorrerão.
  4. No diálogo Configuration Changes, Selecione a caixa de opções na área Detected changes. Em seguida, clique no botão de comando Finish.
  5. No diálogo Install/Update, clique no botão de comando Yes. O workbench será iniciado novamente para efetivação das alterações.

Mapeando o Page Designer Classic como o Editor Padrão da Web:

Após a instalação do Page Designer Classic, por padrão, as associações de arquivos entre este editor e vários tipos de arquivos HTML e JSP (incluindo *.htm, *.html, *.jsp, *.jhtml, *.shtml, *.shtm e *.html-ss) são mapeadas, para que você possa utilizar Open With > Page Designer Classic no menu de contexto da exibição J2EE Navigator para abrir um arquivo selecionado no Page Designer Classic. No entanto, se você desejar tornar o Page Designer Classic o editor padrão para os tipos de arquivos HTML e JSP, proceda da seguinte forma:

  1. Selecione Window > Preferences.
  2. Expanda as definições de Workbench e abra a página File Associations.
  3. Selecione os tipos de arquivos aplicáveis (um por vez) no quadro de listagem File types.
  4. Selecione Page Designer Classic no diálogo Editor Selection e clique no botão de comando Default.
  5. Repita as etapas 3 e 4 para cada tipo de arquivo aplicável.

Nota: Se, posteriormente, você desativar e, em seguida, reativar o Page Designer Classic, as associações de arquivos também serão restabelecidas. No entanto, o editor padrão para o tipo de arquivo mapeado reverterá para o novo Page Designer.

Opcionalmente, você pode fazer atualizações nas preferências de edição do Page Designer Classic. Selecione Window > Preferences e, em seguida, expanda as definições de Web Tools. Expanda Page Design (Classic) para fazer as atualizações desejadas.

Desativando o Page Designer Classic

Para desativar este recurso (incluindo a ajuda) e retomar a utilização do Page Designer padrão, execute estas etapas:

  1. Selecione Help > Software Updates > Updates Manager.
  2. Na exibição Install Configuration, expanda Current Configuration para localizar o Page Designer Classic 5.1.0 e selecione-o.
  3. Clique no botão de comando Disable no canto inferior direito da área de janela Preview.
  4. No diálogo Feature Install, clique no botão de comando Finish.
  5. No diálogo Install/Update, clique no botão de comando Yes. O workbench será iniciado novamente para efetivação das alterações.

Ativando o Page Designer Classic (depois que ele tiver sido desativado)

Para reativar o Page Designer Classic, não reexecute o pdclassic.exe. Em vez disso, execute estas etapas:

  1. Selecione Help > Software Updates > Updates Manager.
  2. Na exibição Install Configuration, clique no botão da barra de ferramentas denominado Show Disabled Features.
  3. Expanda Current Configuration para localizar o Page Designer Classic 5.1.0 e selecione-o.
  4. Clique no botão de comando Enable no canto inferior direito da área de janela Preview.
  5. No diálogo Feature Install, clique no botão de comando Finish.
  6. No diálogo Install/Update, clique no botão de comando Yes. O workbench será iniciado novamente para efetivação das alterações.

4.5 Limitação de Personalização do Menu Page Designer Toolbar

Depois de personalizar a barra de ferramentas utilizando o diálogo Customize Perspective (acessado selecionando Window > Customize Perspective), o menu Page Designer Toolbar não poderá ser utilizado para personalizar outra barra de ferramentas. Nesse caso, você deve utilizar o diálogo Customize Perspective para personalizar quais itens da barra de ferramentas devem ser exibidos.

4.6 Aviso de Link Interrompido em Applets

LinksBuilder pode sinalizar incorretamente o valor do atributo de código de um applet como um link inválido se um nome de classe Java completo for utilizado:

<applet code="aaa.bbb.AnApplet" codebase="MyApplets">
Esse aviso pode ser seguramente ignorado e não afeta o comportamento do applet quando ele é executado no servidor.

Esse aviso pode ser evitado utilizando um separador de caminho ('/'), em vez do separador ('.') e assegurando que a extensão .class seja explicitamente especificada. Exemplo:

<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">

4.7 Inserindo Applets em Arquivos HTML e JSP Utilizando o Page Designer

A pasta de origem Java (por padrão, JavaSource) de um projeto da Web destina-se a classes do lado do servidor, portanto, o código fonte para applets não pode ser colocado nessa pasta. Portanto, recomenda-se o seguinte ao desenvolver applets:

  1. Crie um projeto Java para applets e crie as classes de applet no projeto.
  2. Copie os arquivos de classe de applet para a pasta de conteúdo da Web (por padrão, WebContent) de um projeto da Web. Não os copie para a pasta WEB-INF, porque essa pasta destina-se apenas a classes do lado do servidor. (Para ver os arquivos de classe, você precisará alterar os filtros da exibição Project Navigator, selecionando Filters na lista drop-down do botão Menu da exibição.
  3. Insira um applet em uma página da Web, selecionando Insert > Others > Java Applet no Page Designer. Nesse ponto, você deve definir os atributos code e codebase apropriados.

    Por exemplo, se a sua classe de applet for aaa.bbb.AnApplet e a estrutura de arquivos for a seguinte:

     WebContent/index.html
    WebContent/MyApplets/aaa/bbb/AnApplet.class
    code is "aaa.bbb.AnApplet"

    a marcação de applet no index.html deverá conter:

    codebase is "MyApplets"

4.8 Visualizar um Arquivo HTML que Inclua Shockwave Pode Fazer com que o WebSphere Studio Seja Encerrado Bruscamente

Não há uma solução alternativa conhecida para esse problema.

4.9 Problema ao Exibir Alguns Caracteres GB18030 no Windows 2000/XP

GB18030 é um conjunto de caracteres padrão para a República da China que especifica uma página de códigos estendida e uma tabela para mapear para Unicode. O WebArt Designer e Animated GIF Designer não podem exibir corretamente caracteres GB18030 no intervalo 0xA840 - 0xA9A0 se o locale do sistema for chinês simplificado e o Microsoft GB18030 Support Package estiver instalado.

Para o WebArt Designer, este problema ocorre nos campos de texto na exibição WebArt Gallery, nos campos de texto no Assistente Logo, no diálogo (Specify Text 1/4), nos campos de texto no diálogo Edit Bookmarks e nos itens de menu no menu Bookmark.

Para o Animated GIF Designer, este problema ocorre no campo Comment no diálogo Frame Properties (Comment Frame), no quadro Comment na exibição Frame Thumbnail e nos campos de texto no diálogo Create Animated Banner

Por exemplo, se você inserir o caractere GB18030 '0xA877' (em Unicode, U+2573 Box Drawings Light Diagonal Cross), ele será exibido como GB18030 '0xA876' (em Unicode, U+2572 Box Drawings Light Diagonal Upper Left To Lower Right).

4.10 Problema de BiDi para WebArt Designer, Animated GIF Designer e PageDesigner Classic

Às vezes, o WebArt Designer e o Page Designer Classic falham ao criar a imagem Logo do idioma bidirecional no Windows XP. Se você especificar espaçamento de caracteres quando criar uma imagem Logo dos caracteres da direita para a esquerda, os caracteres no Logo não serão reordenados. Você deve especificar zero como espaçamento de caracteres para ter uma imagem Logo correta de caracteres bidirecionais no Windows XP.

O banner animado do AnimatedGif Designer tem a mesma restrição.

4.11 As JSPs Devem Utilizar Instruções Import Explícitas

Os arquivos JSp devem utilizar o atributo 'import' da diretriz page para descrever os tipos que estão disponíveis para o ambiente de script naquela página. Alguns tipos podem ter sido importados implicitamente em arquivos JSP contidos em projetos do J2EE1.2, mas mostrarão erros se utilizados em um projeto do J2EE1.3. Para evitar esse problema, os tipos devem ser sempre importados explicitamente na página JSP (a menos que o tipo esteja incluído na lista de importação padrão: java.lang.*, javax.servlet.*, javax.servlet.jsp.* e javax.servlet.http.*).

4.12 Suporte a Idiomas Bidirecionais para Page Designer Classic

Você pode ativar o suporte bidirecional do Page Designer Classic definindo o locale padrão do sistema e o locale padrão do usuário como Arabic ou Hebrew no Windows.

4.13 Migrando Dados Relacionais de Projetos da Web 4.0.3

Para migrar dados relacionais de projetos WebSphere Studio 4.0.3, você precisará fazer o seguinte:

  1. A partir de um espaço de trabalho 4.0.3, gere arquivos DDL para cada banco de dados disponível.
  2. Remova o banco de dados da pasta Web Project de origem/banco de dados (através da exibição Data Definition)
  3. Abra o espaço de trabalho 4.0.3 com o WebSphere Studio Versão 5.
  4. Migre os projetos da Web para os quais você deseja restaurar os dados relacionais.
  5. Clique em File > Import > File System e especifique o(s) arquivo(s) DDL de seu espaço de trabalho 4.0.3.
  6. Na exibição Data Definition da perspectiva Data, selecione Run against Local e especifique o projeto de destino da Web.

Os artefatos de dados relacionais serão restaurados.

4.14 JSPs e Servlets Java que São Projetados em um Ambiente DBCS para Um Nível J2EE 1.3 no Servidor WebSphere 5 Exigem um Snippet de Código Extra

Esta entrada aplica-se a Servlets JSPs e Java que são projetados em um ambiente DBCS para um nível J2EE 1.3 no servidor WebSphere 5. O snippet de código a seguir deve ser incluído na origem antes de qualquer parâmetro ou atributo de pedido ser acessado:

  if(request.getCharacterEncoding() == null){  
request.setCharacterEncoding(<encoding>); // typically this would be the encoding of the JSP or servlet
}
//...normal jsp/servlet code which access request objects like
// <%=request.getParameter("message")%>

Se o procedimento acima não for realizado e o pedido não incluir informações de codificação, todos os parâmetros de pedidos devem ser analisados em ISO-8859-1, portanto, se qualquer parâmetro de entrada incluir caracteres DBCS, eles serão exibidos incorretamente.

4.15 Arrastar e Soltar Itens na Exibição Quick Edit

Antes de arrastar e soltar itens ou texto a partir da exibição Snippets ou Palette na exibição Quick Edit, certifique-se primeiro de que a exibição Quick Edit não contenha mais a instrução "Insert an action/code snippet".

4.16 Utilizando Itens da Exibição Snippet com Ações Simples na Exibição Quick Edit

Para cada item da exibição JavaScript Snippet, existe uma ação simples correspondente disponível na exibição Quick Edit. Na exibição Quick Edit, não é recomendado combinar o uso de ações simples com itens da exibição Snippets no mesmo script de evento. Se for necessário combiná-los, cuidado com o posicionamento do item do Snippet. Arrastar e soltar itens da exibição Snippets na exibição Quick Edit quando o editor já contém ações simples, pode fazer com que o item do Snippet seja inserido no lugar errado. Se isso ocorrer, exclua e insira novamente a ação simples.

4.17 Suporte a Linguagem Mobile para o Page Designer

Os atributos que não são suportados em idiomas móveis, como cHTML ou WML, podem ser inseridos a partir do diálogo Insert ou da exibição Attributes.
No entanto, você pode verificar a validade do código utilizando Tools > Validate HTML Syntax para um documento cHTML, ou Tools > Validate WML Syntax para um documento WML.

4.18 Suporte a Gabaritos de Páginas para o Page Designer

Os gabaritos de página são suportados apenas pelo Page Designer, não pelo Page Designer Classic. Você pode utilizar o Page Designer para editar uma página HTML/JSP utilizando uma função Page template.

4.19 Notas para Utilização das Partes do Site com o Web Site Designer

4.20 Alterando Definições do Sistema para Cores e Fontes

Quando as definições de cores e fontes do sistema são alteradas, é necessário iniciar novamente o WebSphere Studio para que as novas definições sejam aplicadas à página Design do Page Designer e à exibição Palette.

4.21 Anotações de Pesquisa em Arquivos Não-salvos em Editores

No Source Editor e na página Source de editores de várias páginas, como o XML Editor, a função de pesquisa está funcionando a partir do recurso salvo no sistema de arquivos, em vez de a partir do conteúdo do editor. As anotações de pesquisa em qualquer editor não salvo podem não ser confiáveis. Para evitar esse problema, salve o arquivo antes de fazer a pesquisa.

4.22 Restrições do ClearCase Utilizando o Designer de Web Site ou Gabaritos de Páginas

Se utilizar o Web Site Designer para trabalhar em um projeto da Web, você deverá primeiro assegurar que os arquivos de projetos, como arquivos html ou jsp e arquivos relacionados tenham saída registrada do repositório do ClearCase.

Além disso, se utilizar gabaritos de páginas em seu projeto da Web, você deverá primeiro verificar os arquivos apropriados fora do ClearCase.

4.23 Problema de Envio de Formulário Javascript em JSPs Gerados pelo Assistente Database Web Pages

Em alguns JSPs gerados pelo assistente Database Web Pages, especialmente os denominados '***MasterView.jsp'

os links na página denominados 'Back', 'Refresh' & outros podem não funcionar em todos os navegadores. Foram observados problemas em alguns navegadores, especialmente o Mozilla & Konqueror.

Para corrigir o problema para a maioria dos navegadores, altere o código Javascript para a função denominada 'submitForm' no JSP.

Altere a variável 'document.<formName>.elements.action' no método para 'document.<formName>.action'.

Por exemplo function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.elements.action = "/Web3/SCHEMA_TABLEDetailsView"; }

torna-se

function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.action = "/Web3/SCHEMA_TABLEDetailsView"; }

Retornar para o Arquivo Leia-me Principal