1.0 Introdução
2.0 Problemas Conhecidos
2.1 Ambiente de
Desenvolvimento da Web
2.2 Depuração
do WebSphere Application Server
2.3 Depurador de
JavaScript
2.4 Depurador de Procedimento Armazenado SQL
2.5 Ferramentas de Teste e de Implementação (Ferramentas do Servidor)
2.6
Depurador JDT (Java Development Tools)
2.7 Depurador de Linguagem Compilada
2.8 Limitações do Idioma Nacional
2.9 Depurador SQLJ
2.10 Depuração de Script Ativo
Os depuradores no WebSphere Studio fornecem as ferramentas necessárias para depurar aplicativos da Web, JavaScript do lado do servidor, Script Ativo, Java, SQLJ, Procedimentos Armazenados SQL e linguagens compiladas. Este arquivo readme descreve os problemas e limitações conhecidos que estão associados aos depuradores do WebSphere Studio.
Depuração de JSP:
- Os arquivos JSP podem ser depurados ao testar em um WebSphere Application Server. Se estiver testando um servidor Tomcat, o depurador não parará nos pontos de interrupção do JSP.
- Pontos de Interrupção podem ser definidos nos arquivos JSP com as seguintes marcações:
- Scriplets JSP do formulário: <% %>
- Expressões JSP do formulário: <%= %>
- Declarações JSP do formulário: <%! %>
- As marcações jsp:useBean, jsp:getProperty, e jsp:setPropertys
- Marcações Personalizadas
- Pontos de interrupção não podem ser definidos para os seguintes conjuntos de marcação:
- Código HTML
- Diretriz JSP
- Todas as outras marcações JSP (jsp:include, jsp:forward, etc.)
- Se você estiver migrando um espaço de trabalho de uma versão mais antiga do WebSphere Studio para esta versão, será preciso excluir seus pontos de interrupção de JSP e recriá-los.
- O modo de depuração passo a passo falhará para métodos iniciais de EJB: Se você utilizar o adaptador de depuração do WebSphere Application Server para ativar uma sessão de depuração, o modo de depuração passo a passo não parará para métodos iniciais de EJB. Utilize os pontos de interrupção se deseja depurar esses métodos.
- O passo retornar de Java para o JavaScript não é suportado: Utilize pontos de interrupção se deseja poder retornar de Java para o código JavaScript.
- Depurando JSPs:
- O depurador passo-a-passo não irá funcionar para JSPs que não contenham qualquer código executável.
- Se utilizar o WebSphere Application Server Debug Adapter para lançar uma sessão do depurador, não poderá inspecionar ou exibir as variáveis e expressões JSP.
- Executar para a linha não é suportado pelos JSPs.
- Definindo pontos de interrupção JSP pode ser lento. Permita um tempo extra para o depurador inicializar se tiver muitos pontos de interrupção JSP.
- Pontos de interrupção em variáveis estáticas em blocos de declaração de JSP não funcionarão e podem causam outros problemas com pontos de interrupção.
- As propriedades dos pontos de interrupção como contagem de ocorrências, encadeamentos selecionados, e política de suspensão do VM não são suportadas para pontos de interrupção JSP.
- Não defina pontos de interrupção Java no Editor do Debugger: Os pontos de interrupção Java devem ser definidos no Editor Java e não no Editor do Debugger.
- Utilizando o item de menu pop-up Change Source File da exibição Debug: Se você alterar o arquivo fonte que é exibido utilizando o item de menu pop-up Change Source File no quadro de pilhas, o novo arquivo poderá não ser aberto no editor. Para solucionar isso, clique em um outro quadro de pilhas e, em seguida, clique novamente no quadro de pilhas original. O novo arquivo deverá então ser aberto no editor.
- Debug Console: No Debug Console, hiperlinks para tipos abertos não funcionarão.
- Etiquetas de quadros de pilhas após troca a quente: Se, após uma substituição de código a quente, algumas das etiquetas de pilhas tiverem etiquetas como
<tipo de recebimento desconhecido>(<tipo de declaração desconhecido>).<nome de método desconhecido>(<argumentos desconhecidos>) linha: <número de linha desconhecido> indisponívelvocê poderá obter as etiquetas corretas, alternando para uma perspectiva diferente e, em seguida, retorne para a perspectiva Debug.
- Um objeto JavaScript não está disponível para consulta até que seu construtor seja concluído: Você pode percorrer a execução do construtor, mas não pode examinar o objeto que está sendo construído, até que a construção seja concluída (você saiu do construtor).
- Escalonamento e quadros de pilhas abaixo do quadro de pilhas superior: O avanço e retorno de um quadro de pilhas diferente do quadro de pilhas superior não são suportados para o JavaScript.
- Inclusão de JSP: A depuração de JavaScript em uma inclusão de JSP não é suportada.
- Sair de funções recursivas: Os usuários que depuram funções recursivas de JavaScript perceberão que, quando saírem de uma função recursiva, não retornarão ao nível de execução superior.
- Não expanda objetos que contêm as variáveis writer ou inputStream: Ao examinarem os objetos JavaScript, os usuários são avisados para não expandir objetos que contêm as variáveis writer ou inputStream. Isso torna o depurador não-responsivo.
- Test Environment: A depuração de JavaScript não funcionará ao utilizar o WebSphere V5 Test Environment. Este problema é corrigido no APAR #PQ73036.
- A importação ou exclusão do banco de dados na exibição Data Definition pode causar perda de pontos de interrupção definidos: Se você depurar um procedimento armazenado SQL antes de importar o banco de dados para uma pasta na exibição Data Definition e, em seguida, importar o banco de dados, todos os pontos de interrupção de linha criados serão perdidos. Depois de importar o banco de dados, o depurador utilizará aquela pasta para exibir a origem. Se você excluir as informações do banco de dados importado, perderá também as informações do ponto de interrupção na próxima vez que tentar depurar um procedimento armazenado SQL. Isso não restaurará os pontos de interrupção perdidos quando o banco de dados foi importado pela primeira vez.
Recomendamos que você importe o banco de dados antes de depurar um procedimento armazenado para evitar esse problema.
- A depuração de procedimentos armazenados Java não é suportada: O editor permite que você inclua pontos de interrupção no código fonte de um procedimento armazenado Java. No entanto, esses pontos de interrupção são ignorados porque a depuração de procedimentos armazenados Java ainda não é suportada.
- Nomes de procedimentos armazenados delimitados: o depurador de procedimento armazenado SQL fornece suporte limitado para procedimentos armazenados com esquema delimitado ou nomes de procedimentos. Tais procedimentos devem ser ativados do diálogo Launch Configuration e não do menu de contexto na exibição Data Definition.
- Suporte para ter mais que uma sessão do depurador de procedimento armazenado SQL ativa ao mesmo tempo: Na Versão 5.0 deste produto, você não podia ter mais que uma sessão do depurador de procedimento armazenado SQL ativa ao mesmo tempo. Essa restrição não se aplica mais nas Versões 5.0.1 ou superiores deste produto.
- Procedimentos Armazenados com argumentos FOR BIT DATA: Procedimentos armazenados que tenham argumentos com o atributo FOR BIT DATA não podem ser depurados com o depurador SQL Stored Procedure do WebSphere Studio.
- A configuração de lançamento criada no produto Early Availability pode não ser reconhecida no produto atual: Se você instalou a versão Early Availability deste produto e criou uma configuração de lançamento do Depurador de Procedimento Armazenado com ela, as definições da configuração de lançamento podem não ser reconhecidas quando ela é utilizada com a versão atual deste produto. As definições da Configuração de Lançamento que foram salvas na versão Early Availability podem reverter para os valores padrão quando abertas na versão atual do produto.
Considere o seguinte, quando decidir executar um servidor no modo de depuração:
- Os servidores podem iniciar e executar lentamente do que quando executando em modo de não-depuração.
- O WebSphere Application Server demora bem mais para compilar páginas JSP.
Informações sobre os problemas e limitações conhecidos com as ferramentas de desenvolvimento Java estão disponíveis nas notas sobre o release de JDT (Java Development Tools) e do Workbench (IDE). Essas notas podem ser acessadas a partir de links do Leia-me principal do produto que foi instalado com este produto.
- Erro "Unable to find DLL": Se o início de uma sessão de depuração compilada produz a mensagem do Windows "Unable to find DLL", remova a variável de ambiente LOCPATH.
- Falha na localização de uma cadeia existente na exibição de fonte ou de listagem para um programa: Ao trabalhar com arquivos fonte ou de listagem grandes, a função localizar no editor do depurador pode não conseguir localizar uma cadeia. Isso pode ocorrer quando somente uma parte da fonte ou listagem está carregada no editor.
- Exibição de armazenamento mostra caracteres incorretos: Quando a exibição de armazenamento é formatada como "hexadecimal e caractere", os dados hexadecimais estão corretos, mas apenas os caracteres com codificações de byte único serão corretamente exibidos..
- Rolando saltos por mais linhas que o esperado: Avançar ou retroceder no Editor Debugger, pode ignorar mais linhas do que o esperado. Para obter uma linha específica, utilize a ação Ir para a linha (Ctrl-L).
- Limitação de BiDi (bidirecional): Você não poderá utilizar o editor do Debugger quando depurar JSPs que foram codificados em uma página de códigos diferente da página de códigos nativa.
- Depurador de Linguagem Compilada:
- Em sistemas de byte único (SBCS), o Depurador de Linguagem Compilada não suporta nomes de programas ou a transmissão de parâmetros do programa que contenham caracteres acima de 0x7F.
- A utilização de caracteres NL em nomes e argumentos depurados não é suportada.
Ao executar troca a quente durante depuração com a JVM J9, se houver muitos métodos SQLJ na pilha de chamadas, você verá um diálogo Obsolete methods on the stack. Se a troca a quente foi de uma classe SQLJ, a classe será recarregada na JVM, mas você não verá o novo código sendo executado até a próxima vez em que um método na classe for chamado.
Se você fizer troca a quente de uma classe SQLJ, os pontos de interrupção SQLJ podem não funcionar para essa classe durante a sessão de depuração atual.
Aplicativo Script HTML
Os seguintes problemas podem ocorrer ao tentar ativar uma sessão de depuração de Aplicativo Script HTML:
- Uma mensagem persistente "Error creating debug target".
- Ao tentar conectar-se a um navegador existente para depuração,o depurador é incapaz de obter uma lista dos navegadores em execução.
Você pode corrigir esses problemas fazendo o seguinte:
- Feche todos os navegadores e janelas do Microsoft(R) Windows Explorer em execução antes de tentar iniciar outra sessão de depuração.
- Se a etapa anterior não resolver o problema, o processo mdm.exe está corrompido. Feche todos os navegadores e exploradores de arquivos em execução e, em seguida, encerre mdm.exe a partir do Gerenciador de Tarefas do Windows(R). Inicie a sessão de depuração novamente.
Ao tentar conectar-se a um navegador existente para depuração, não tente conectar-se ao navegador interno do workbench do WebSphere. A conexão ao navegador interno para depuração fará com que o workbench pare de responder e resultados inesperados podem ocorrer.
Os seguintes problemas podem ocorrer durante uma sessão de depuração de Aplicativo Script HTML:
- A localização atual não é realçada no editor quando a sessão de depuração é suspensa.
- Pontos de interrupção não podem ser instalados.
- A fonte não está disponível para exibição se a fonte estiver localizada fora do espaço de trabalho do workbench.
Você pode corrigir esses problemas fazendo o seguinte:
- O navegador pode não estar carregando a página corretamente. Atualize a página no Microsoft(R) Internet Explorer (você pode precisar fazer isto várias vezes).
- Se a atualização da página não corrigir o problema, encerre a sessão de depuração. Feche todos os navegadores e exploradores de arquivos em execução e, em seguida, reinicie a sessão de depuração.
- Se a etapa anterior não resolver o problema, o processo mdm.exe está corrompido. Encerre a sessão de depuração todos os navegadores e exploradores de arquivos em execução. Em seguida, encerre mdm.exe a partir do Gerenciador de Tarefas do Windows(R) e inicie a sessão de depuração novamente.
Ter a janela Help do workbench ou o navegador interno abertos durante Active Script Debug pode interferir com a sessão de depuração e resultarem comportamento inesperado.
Pontos de interrupção definidos antes de uma sessão de depuração são ignorados se a página for implementada em um servidor. Para definir um ponto de interrupção,suspenda a sessão de depuração para tornar visível a fonte e defina o ponto de interrupção nessa página temporária. Consulte "Definindo Ponto de Interrupção de Linha" para obter detalhes.
O depurador Active Script utiliza o Microsoft(R) Script Debugger para obter informações sobre depuração. Para questões adicionais relativas ao Microsoft(R) Script Debugger, consulte seu ReadMe.htm.
Aplicativo Host Script
O seguinte problema pode ocorrer ao tentar ativar uma sessão de depuração de Aplicativo Host Script:
- Uma mensagem persistente "Error creating debug target".
Você pode corrigir esse problema fazendo o seguinte:
- Feche todos os navegadores e janelas do Microsoft(R) Windows Explorer em execução antes de tentar iniciar outra sessão de depuração.
- Se a etapa anterior não resolver o problema, o processo mdm.exe está corrompido. Feche todos os navegadores e exploradores de arquivos em execução e, em seguida, encerre mdm.exe a partir do Gerenciador de Tarefas do Windows(R). Inicie a sessão de depuração novamente.
Retornar para o arquivo leia-me principal
(C) Copyright IBM Corporation 2000, 2003. Todos os Direitos Reservados.