Módulos da web: o editor do descritor de implementação da web

Atenção: Os projetos da web do Web 3.x não requerem um arquivo web.xml, pois as informações de implementação são gerenciadas por anotações. Caso um descritor de implementação da web seja necessário para um projeto da web do Web 3.x, clique com o botão direito no projeto e selecione Java EE > Gerar stub do descritor de implementação.
O editor do descritor de implementação da web ajuda a especificar informações de implementação para módulos que são criados no ambiente de desenvolvimento da web. As informações aparecem no arquivo web.xml.
Nota: Você usa o descritor de implementação da web para configurar os atributos do descritor de implementação. Não o utilize para manipular o conteúdo do recurso da web.

O arquivo web.xml para um projeto da web fornece as informações necessárias para implementar um módulo de aplicativo da web. É utilizado na construção de um arquivo WAR de um projeto.

O editor do descritor de implementação da web é dinâmico e inclui muitas seções que representam várias propriedades e configurações no descritor de implementação.

Web application Deployment Descriptor Editor

O editor do descritor de implementação da web inclui as seções a seguir:
Estrutura do Aplicativo da Web
Fornece um resumo rápido do conteúdo no descritor de implementação da web e permite que você inclua, remova ou mude o conteúdo.
Ordem Absoluta
Use a ordenação absoluta para forçar uma ordem de varredura de fragmentos da web ou varrer um subconjunto dos fragmentos da web. A configuração de Ordem absoluta aplica-se ao Web3.x e superiores.
Parâmetros de Contexto
Um contexto de servlet define a visualização de um servidor do aplicativo da web no qual o servlet está sendo executado. O contexto também permite que um servlet acesse recursos disponíveis para ele.
Utilizando o contexto, um servlet pode registrar eventos, obter referências de URL para recursos, definir e armazenar atributos que outros servlets no contexto podem utilizar. Essas propriedades declaram os parâmetros de uma aplicativo da web para seu contexto. Elas transmitem informações de configuração, tal como o endereço de e-mail de um webmaster ou o nome de um sistema que contém dados críticos.
Origem de Dados
Configure as informações de origem de dados para tornar a origem de dados disponível para o aplicativo.
Referência EJB Local
Cria uma referência a um bean corporativo que é acessado através de sua posição inicial local ou de sua interface local.
Referência EJB
Crie uma referência para um enterprise bean que é acessado por meio de sua página inicial remota e da interface remota.
Variável de Ambiente
Declare uma entrada de ambiente para o aplicativo.
Página de Erro
locais de página de erro permitem que um servlet localize e sirva um URI para um cliente com base em um código de status do erro ou tipo de exceção especificado.
Estas propriedades são usadas se o manipulador de erros é um outro servlet ou arquivo JSP. As propriedades especificam um mapeamento entre um código de erro ou tipo de exceção e o caminho de um recurso no aplicativo da web. O contêiner examina a lista na ordem em que ela é definida, e tenta corresponder a condição de erro pelo código de status ou pela classe de exceção. Na primeira correspondência bem sucedida da condição de erro, o contêiner serve de volta o recurso que está definido na propriedade Local.
Filtrar
Define uma classe de filtro e seus atributos de inicialização.
Cria um novo filtro, inclui um filtro existente no descritor de implementação ou remove o filtro selecionado do descritor de implementação.
Mapeamento de Filtro
Define o mapeamento de filtro para um padrão de URL ou servlet.
Configuração JSP
Inclua uma coleção de recursos ou uma biblioteca de tags.
Listener
Define um listener do aplicativo.
Lista de Mapeamentos de Codificação de Localidade
Mapeia o nome de código para um nome de codificação.
Configuração de Login
Configura como um usuário é autenticado. Se Configuração de Login for especificada, o usuário deverá ser autenticado a fim de acessar recursos que são limitados pelo parâmetro Restrição de Segurança.
Destino da Mensagem
Especifica o destino de um bean acionado por mensagens.
Referência de Destino da Mensagem
Especifica o nome Java™ Naming and Directory Interface (JNDI) do objeto administrado por J2C para ligar a referência de destino da mensagem aos beans acionados por mensagens. Mapeie cada referência de destino de mensagem em seu aplicativo para um objeto administrado.
Mapeamento do MIME
Define o mapeamento entre uma extensão e um tipo MIME.
Referência do Contexto de Persistência
Especifica o tempo de vida do contexto de persistência.
Referência da Unidade de Persistência
Especifica o arquivo persistence.xml.
Pós-Construção
Define o método que é executado após a inicialização de injeção de dependência.
Pré-Destruição
Define a notificação de retorno de chamada que sinaliza que a instância está sendo removida pelo contêiner.
Referência do Ambiente de Recursos
Define a referência de um recurso no aplicativo da web para um associado a um objeto administrado.
Referência do recurso
Define a referência de um nome de consulta para um recurso externo.
Restrição de Segurança
As restrições de segurança determinam como o conteúdo da web deve ser protegido. Essas propriedades associam restrições de segurança a uma ou mais coletas de recursos da web.
Uma restrição consiste em uma coleta de recursos da web, uma limitação de autorização e uma limitação dos dados do usuário.
  • Uma coleta de recursos da web é um conjunto de recursos (padrões de URL) e métodos HTTP nesses recursos. Todas as solicitações que contêm um caminho de solicitação que corresponde ao padrão de URL que é descrito na coleta de recursos da web estão sujeitas à restrição. Se nenhum método HTTP for especificado, a restrição de segurança se aplicará a todos os métodos HTTP.
  • Uma restrição de autorização é um conjunto de funções que devem ser concedidas aos usuários a fim de acessar os recursos que são descritos pela coleta de recursos da web. Se um usuário que solicita acesso a um URI especificado não receber pelo menos uma das funções que são especificadas na restrição de autorização, o usuário terá o acesso negado a esse recurso.
  • Uma restrição de dados do usuário indica que a camada de transporte do processo de comunicação do cliente ou servidor deve satisfazer ao requisito de garantir a integridade do conteúdo (impedindo violações em trânsito) ou de garantir a confidencialidade (impedindo a leitura enquanto em trânsito).
Função de Segurança
Define funções de segurança.
Referência de Segurança
Define uma referência a uma função de segurança para um nome de função alternativo.
Servlet
Cria um novo servlet, inclui um servlet ou arquivo JSP existente no descritor de implementação ou remove o servlet selecionado de arquivo JSP do descritor de implementação.
Configuração de Sessão
Define os atributos de sessão para o aplicativo da web.
Lista de Arquivos de Boas-vindas
Configura uma lista ordenada de páginas da web padrão que são servidas quando um arquivo não é localizado.
Um arquivo de boas-vindas é um arquivo de ponto de entrada (por exemplo, index.html) para um grupo de arquivos HTML relacionados.
Os arquivos de boas-vindas são localizados utilizando um grupo de URIs parciais. O contêiner da web usa os URIs parciais para localizar um arquivo válido quando o URI inicial não é localizado.
Origem
Edite a origem de web.xml diretamente.

Edite o arquivo web.xml usando as diversas páginas tabuladas no editor do Descritor de Implementação da web. Conforme você especifica as informações de implementação, o editor incorpora automaticamente a identificação XML apropriada no web.xml.

Além das informações de configuração no arquivo web.xml, outros descritores de implementação em um projeto da web incluem as informações a seguir:
Informações de ligação
As informações são requeridas pelo servidor de aplicativos para ligar as informações de implementação que são especificadas no aplicativo a uma instância específica. Por exemplo, ele pode mapear um nome lógico de uma dependência ou recurso externo para o nome JNDI físico real do recurso. Ele também pode mapear informações da função de segurança para um conjunto de grupos ou usuários.
Informações de ligação e extensões da IBM® (arquivos ibm-web-bnd.xml e ibm-web-ext.xml)
Adições nos descritores padrão para aplicativos Java EE, aplicativos da web e enterprise beans. As extensões permitem que os sistemas Java Platform, Enterprise Edition ou anteriores (antigos) funcionem no ambiente atual do WebSphere Application Server. Elas também são utilizadas para especificar o comportamento do aplicativo específico do fornecedor, indefinido em uma especificação atual ou esperado que seja incluído em uma especificação futura.
Se você importar um arquivo WAR em um projeto da web existente, poderá incluir os arquivos do descritor de implementação que são incluídos no arquivo WAR como o novo descritor de implementação do projeto da web. Quaisquer informações sobre implementação específicas que já estejam definidas nesses arquivos serão usadas ao implementar o aplicativo da web atualizado.

O arquivo web.xml pode ser atualizado automaticamente para refletir mudanças em seu projeto da web. Por exemplo, quando você usa o assistente para Novo Servlet para criar um novo servlet em um projeto da web, o assistente coloca a entrada do servlet apropriada no arquivo web.xml.

Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: ccwebxmlweb30.html