4.3.6. Depuração e Resolução de Exceções e Erros de Implantação do Arquivo do Seam 2.2 Booking

Nos passos anteriores, Seção 4.3.5, “Construção e Implantação da VersãoJBoss EAP 5.X do Aplicativo Seam 2.2 Booking”, o aplicativo Seam 2.2 Booking do JBoss EAP 5.X foi construído e implantado na pasta de implantação do JBoss EAP 6. Neste passo, você depurará e resolverá cada erro de implantação que encontrar.

Importante

Os aplicativos que usam Hibernate diretamente com Seam 2.2 podem usar uma versão do Hibernate 3 empacotada dentro do aplicativo. Hibernate 4, que é fornecido através do módulo org.hibernate do JBoss EAP 6, não é suportado pelo Seam 2.2. Este exemplo tem o propósito de ajudá-lo a executar o seu aplicativo no JBoss EAP 6 como um primeiro passo. Você deve estar ciente de que o empacotamento do Hibernate 3 com um aplicativo Seam 2.2 não possui uma configuração suportada.

Procedimento 4.10. Depuração e resolução de exceções e erros de implantação

  1. Problema - java.lang.ClassNotFoundException: javax.faces.FacesException
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR \[org.jboss.msc.service.fail\] (MSC service thread 1-1) MSC00001: Failed to start service jboss.deployment.subunit."jboss-seam-booking.ear"."jboss-seam-booking.war".POST_MODULE:
org.jboss.msc.service.StartException in service jboss.deployment.subunit."jboss-seam-booking.ear"."jboss-seam-booking.war".POST_MODULE:
Failed to process phase POST_MODULE of subdeployment "jboss-seam-booking.war" of deployment "jboss-seam-booking.ear"
    (.. additional logs removed ...)
Caused by: java.lang.ClassNotFoundException: javax.faces.FacesException from \[Module "deployment.jboss-seam-booking.ear:main" from Service Module Loader\]
    at org.jboss.modules.ModuleClassLoader.findClass(ModuleClassLoader.java:191)
    O que significa:

    ClassNotFoundException indica uma dependência ausente. Neste caso, a classe javax.faces.FacesException não pode ser encontrada e é necessário adicionar explicitamente a dependência.

    Como resolver isto:

    Localize o nome do módulo para aquela classe no diretório EAP6_HOME/modules/system/layers/base/ procurando por um caminho que coincida com a classe ausente. Neste caso, você encontra dois módulos que coincidem: 

    javax/faces/api/main
javax/faces/api/1.2
    Ambos os módulos possuem o mesmo nome de módulo: javax.faces.api, porém aquele localizado no diretório principal é para JSF 2.0 e o outro, no diretório 1.2, é para JSF 1.2. Caso houvesse apenas um módulo disponível, seria possível simplesmente criar um arquivo MANIFEST.MF e adicionar a dependência do módulo. Mas, neste caso, você quer usar a versão JSF 1.2, e não a versão 2.0, no principal, então é necessário especificar uma e excluir a outra. Para isto, crie um arquivo jboss-deployment-structure.xml no diretório do META-INF/ EAR que contenha os seguintes dados: 
    <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
      <dependencies>
        <module name="javax.faces.api" slot="1.2" export="true"/>
      </dependencies>
  </deployment>
  <sub-deployment name="jboss-seam-booking.war">
    <exclusions>
        <module name="javax.faces.api" slot="main"/>
      </exclusions>
      <dependencies>
        <module name="javax.faces.api" slot="1.2"/>
      </dependencies>
  </sub-deployment>
</jboss-deployment-structure>
    Na seção deployment, adicione a dependência para javax.faces.api para o módulo JSF 1.2. Adicione também a dependência para o módulo JSF 1.2 na seção de subimplantação para o WAR e exclua o módulo para JSF 2.0.

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  2. Problema - java.lang.ClassNotFoundException: org.apache.commons.logging.Log
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR [org.jboss.msc.service.fail] (MSC service thread 1-8) MSC00001: Failed to start service jboss.deployment.unit."jboss-seam-booking.ear".INSTALL:
org.jboss.msc.service.StartException in service jboss.deployment.unit."jboss-seam-booking.ear".INSTALL:
Failed to process phase INSTALL of deployment "jboss-seam-booking.ear"
    (.. additional logs removed ...)
Caused by: java.lang.ClassNotFoundException: org.apache.commons.logging.Log from [Module "deployment.jboss-seam-booking.ear.jboss-seam-booking.war:main" from Service Module Loader]
    O que significa:

    ClassNotFoundException indica uma dependência ausente. Neste caso, a classe org.apache.commons.logging.Log não pode ser encontrada e é necessário adicionar explicitamente a dependência.

    Como resolver isto:

    Localize o nome do módulo para aquela classe no diretório EAP6_HOME/modules/system/layers/base/ procurando por um caminho que coincida com a classe ausente. Neste caso, você encontra um módulo que coincide com o caminho org/apache/commons/logging/. O nome do módulo é “org.apache.commons.logging”.

    Modifique o arquivo jboss-deployment-structure.xml para adicionar a dependência do módulo à seção de implantação do arquivo. 
    <module name="org.apache.commons.logging" export="true"/>
    jboss-deployment-structure.xml deve parecer-se com o seguinte: 
    <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
      <dependencies>
        <module name="javax.faces.api" slot="1.2" export="true"/>
        <module name="org.apache.commons.logging" export="true"/>
      </dependencies>
  </deployment>
  <sub-deployment name="jboss-seam-booking.war">
    <exclusions>
        <module name="javax.faces.api" slot="main"/>
      </exclusions>
      <dependencies>
        <module name="javax.faces.api" slot="1.2"/>
      </dependencies>
  </sub-deployment>
</jboss-deployment-structure>
    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  3. Problema - java.lang.ClassNotFoundException: org.dom4j.DocumentException
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/seam-booking]] (MSC service thread 1-3) Exception sending context initialized event to listener instance of class org.jboss.seam.servlet.SeamListener: java.lang.NoClassDefFoundError: org/dom4j/DocumentException
    (... additional logs removed ...)
Caused by: java.lang.ClassNotFoundException: org.dom4j.DocumentException from [Module "deployment.jboss-seam-booking.ear.jboss-seam.jar:main" from Service Module Loader]
    O que significa:

    ClassNotFoundException indica uma dependência ausente. Neste caso, a classe org.dom4j.DocumentException não pode ser encontrada.

    Como resolver isto:

    Localize o nome do módulo no diretório EAP6_HOME/modules/system/layers/base/ procurando pelo org/dom4j/DocumentException. O nome do módulo é “org.dom4j”. Modifique o arquivo jboss-deployment-structure.xml para adicionar a dependência do módulo à seção de implantação do arquivo. 

    <module name="org.dom4j" export="true"/>
    O arquivo jboss-deployment-structure.xml deve parecer-se com o seguinte agora: 
    <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
      <dependencies>
        <module name="javax.faces.api" slot="1.2" export="true"/>
        <module name="org.apache.commons.logging" export="true"/>
            <module name="org.dom4j" export="true"/>
          </dependencies>
  </deployment>
  <sub-deployment name="jboss-seam-booking.war">
    <exclusions>
        <module name="javax.faces.api" slot="main"/>
      </exclusions>
      <dependencies>
        <module name="javax.faces.api" slot="1.2"/>
      </dependencies>
  </sub-deployment>
</jboss-deployment-structure>

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  4. Problema - java.lang.ClassNotFoundException: org.hibernate.validator.InvalidValue
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/seam-booking]] (MSC service thread 1-6) Exception sending context initialized event to listener instance of class org.jboss.seam.servlet.SeamListener: java.lang.RuntimeException: Could not create Component: org.jboss.seam.international.statusMessages
    (... additional logs removed ...)
Caused by: java.lang.ClassNotFoundException: org.hibernate.validator.InvalidValue from [Module "deployment.jboss-seam-booking.ear.jboss-seam.jar:main" from Service Module Loader]
    O que significa:

    ClassNotFoundException indica uma dependência ausente. Neste caso, a classe org.hibernate.validator.InvalidValue não pode ser encontrada.

    Como resolver isto:

    Existe um módulo “org.hibernate.validator”, mas o JAR não possui a classe org.hibernate.validator.InvalidValue, portanto a adição da dependência do módulo não resolve este problema. Neste caso, o JAR contendo a classe fazia parte da implantação do JBoss EAP 5.X. Procure pelo JAR que contém a classe ausente no diretório EAP5_HOME/seam/lib/. Para fazer isto, abra um console e digite o seguinte: 

    $ cd EAP5_HOME/seam/lib
$ grep 'org.hibernate.validator.InvalidValue' `find . -name '*.jar'`
    O resultado apresenta o seguinte: 
    $ Binary file ./hibernate-validator.jar matches
$ Binary file ./test/hibernate-all.jar matches
    Neste caso, copie hibernate-validator.jar para o diretório jboss-seam-booking.ear/lib/ 
    $ cp EAP5_HOME/seam/lib/hibernate-validator.jar jboss-seam-booking.ear/lib

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  5. Problema - java.lang.InstantiationException: org.jboss.seam.jsf.SeamApplicationFactory
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    INFO  [javax.enterprise.resource.webcontainer.jsf.config] (MSC service thread 1-7) Unsanitized stacktrace from failed start...: com.sun.faces.config.ConfigurationException: Factory 'javax.faces.application.ApplicationFactory' was not configured properly.
  at com.sun.faces.config.processor.FactoryConfigProcessor.verifyFactoriesExist(FactoryConfigProcessor.java:296) [jsf-impl-2.0.4-b09-jbossorg-4.jar:2.0.4-b09-jbossorg-4]
  (... additional logs removed ...)
Caused by: javax.faces.FacesException: org.jboss.seam.jsf.SeamApplicationFactory
  at javax.faces.FactoryFinder.getImplGivenPreviousImpl(FactoryFinder.java:606) [jsf-api-1.2_13.jar:1.2_13-b01-FCS]
  (... additional logs removed ...)
  at com.sun.faces.config.processor.FactoryConfigProcessor.verifyFactoriesExist(FactoryConfigProcessor.java:294) [jsf-impl-2.0.4-b09-jbossorg-4.jar:2.0.4-b09-jbossorg-4]
  ... 11 more
Caused by: java.lang.InstantiationException: org.jboss.seam.jsf.SeamApplicationFactory
  at java.lang.Class.newInstance0(Class.java:340) [:1.6.0_25]
  at java.lang.Class.newInstance(Class.java:308) [:1.6.0_25]
  at javax.faces.FactoryFinder.getImplGivenPreviousImpl(FactoryFinder.java:604) [jsf-api-1.2_13.jar:1.2_13-b01-FCS]
  ... 16 more
    O que significa:

    com.sun.faces.config.ConfigurationException e java.lang.InstantiationException indicam um problema de dependência. Neste caso, a causa não é óbvia.

    Como resolver isto:

    Procure pelo módulo que contém as classes com.sun.faces. Ainda que não exista um módulo com.sun.faces, existem dois módulos com.sun.jsf-impl. Uma verificação rápida do jsf-impl-1.2_13.jar no diretório 1.2 mostra que ele contém as classes com.sun.faces. Assim como fez com javax.faces.FacesException ClassNotFoundException, você deve usar a versão 1.2 JSF e não, a versão 2.0 JSF no principal, portanto você deve especificar uma e excluir a outra. A modificação do jboss-deployment-structure.xml para a adição da dependência do módulo é necessária na seção de implantação do arquivo. Você também precisa adicioná-la à subimplantação WAR e excluir o módulo 2.0 JSF. O arquivo deve parecer-se com o seguinte agora: 

    <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
      <dependencies>
        <module name="javax.faces.api" slot="1.2" export="true"/>
              <module name="com.sun.jsf-impl" slot="1.2" export="true"/>
        <module name="org.apache.commons.logging" export="true"/>
        <module name="org.dom4j" export="true"/>
      </dependencies>
  </deployment>
  <sub-deployment name="jboss-seam-booking.war">
    <exclusions>
        <module name="javax.faces.api" slot="main"/>
        <module name="com.sun.jsf-impl" slot="main"/>
      </exclusions>
      <dependencies>
        <module name="javax.faces.api" slot="1.2"/>
              <module name="com.sun.jsf-impl" slot="1.2"/>
      </dependencies>
  </sub-deployment>
</jboss-deployment-structure>

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  6. Problema - java.lang.ClassNotFoundException: org.apache.commons.collections.ArrayStack
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR [org.apache.catalina.core.ContainerBase.[jboss.web].[default-host].[/seam-booking]] (MSC service thread 1-1) Exception sending context initialized event to listener instance of class com.sun.faces.config.ConfigureListener: java.lang.RuntimeException: com.sun.faces.config.ConfigurationException: CONFIGURATION FAILED! org.apache.commons.collections.ArrayStack from [Module "deployment.jboss-seam-booking.ear:main" from Service Module Loader]
    (... additional logs removed ...)
Caused by: java.lang.ClassNotFoundException: org.apache.commons.collections.ArrayStack from [Module "deployment.jboss-seam-booking.ear:main" from Service Module Loader]
    O que significa:

    ClassNotFoundException indica que uma dependência ausente. Neste caso, a classe org.apache.commons.collections.ArrayStack não pode ser encontrada.

    Como resolver isto:

    Localize o nome do módulo no diretório EAP6_HOME/modules/system/layers/base/ procurando pelo caminho org/apache/commons/collections. O nome do módulo é “org.apache.commons.collections”. Modifique jboss-deployment-structure.xml para adicionar a dependência do módulo à seção de implantação do arquivo. 

    <module name="org.apache.commons.collections" export="true"/>
    O arquivo jboss-deployment-structure.xml deve parecer-se com o seguinte agora: 
    <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.0">
  <deployment>
      <dependencies>
        <module name="javax.faces.api" slot="1.2" export="true"/>
              <module name="com.sun.jsf-impl" slot="1.2" export="true"/>
        <module name="org.apache.commons.logging" export="true"/>
        <module name="org.dom4j" export="true"/>
        <module name="org.apache.commons.collections" export="true"/>
    </dependencies>
  </deployment>
  <sub-deployment name="jboss-seam-booking.war">
    <exclusions>
        <module name="javax.faces.api" slot="main"/>
        <module name="com.sun.jsf-impl" slot="main"/>
      </exclusions>
      <dependencies>
        <module name="javax.faces.api" slot="1.2"/>
              <module name="com.sun.jsf-impl" slot="1.2"/>
      </dependencies>
  </sub-deployment>
</jboss-deployment-structure>

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  7. Problema - Serviços com dependências indisponíveis/faltantes
    Quando o aplicativo é implantado, o log contém o seguinte erro: 
    ERROR [org.jboss.as.deployment] (DeploymentScanner-threads - 2) {"Composite operation failed and was rolled back. Steps that failed:" => {"Operation step-2" => {"Services with missing/unavailable dependencies" => ["jboss.deployment.subunit.\"jboss-seam-booking.ear\".\"jboss-seam-booking.jar\".component.AuthenticatorAction.START missing [ jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seam-booking.jar\".AuthenticatorAction.\"env/org.jboss.seam.example.booking.AuthenticatorAction/em\" ]","jboss.deployment.subunit.\"jboss-seam-booking.ear\".\"jboss-seam-booking.jar\".component.HotelSearchingAction.START missing [ jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seam-booking.jar\".HotelSearchingAction.\"env/org.jboss.seam.example.booking.HotelSearchingAction/em\" ]","
  (... additional logs removed ...)
"jboss.deployment.subunit.\"jboss-seam-booking.ear\".\"jboss-seam-booking.jar\".component.BookingListAction.START missing [ jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seam-booking.jar\".BookingListAction.\"env/org.jboss.seam.example.booking.BookingListAction/em\" ]","jboss.persistenceunit.\"jboss-seam-booking.ear/jboss-seam-booking.jar#bookingDatabase\" missing [ jboss.naming.context.java.bookingDatasource ]"]}}}
    O que significa:

    Quando aparecer um erro “Serviços com dependências ausentes/indisponíveis”, observe o texto entre parênteses após "missing" (ausente). Segue abaixo um exemplo: 

    missing [ jboss.naming.context.java.comp.jboss-seam-booking.\"jboss-seam-booking.jar\".AuthenticatorAction.\"env/org.jboss.seam.example.booking.AuthenticatorAction/em\" ]
    O “/em” indica um problema de fonte de dados e Gerenciador de Entidade.

    Como resolver isto:

    No JBoss EAP 6, a configuração da fonte de dados foi alterada e precisa ser definida no arquivo EAP6_HOME/standalone/configuration/standalone.xml. Já que o JBoss EAP 6 é enviado junto com um exemplo de fonte de dados que já está definido no arquivo standalone.xml, modifique o arquivo persistence.xml para usar o exemplo da fonte de dados neste aplicativo. Quando pesquisando o arquivo standalone.xml, você verá que jndi-name para o exemplo da fonte de dados é java:jboss/datasources/ExampleDS. Modifique o arquivo jboss-seam-booking.jar/META-INF/persistence.xml para comentar o elemento jta-data-source existente e substituí-lo pelo o seguinte: 

    <!-- <jta-data-source>java:/bookingDatasource</jta-data-source> -->
<jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>

    Reimplante o aplicativo deletando o arquivo EAP6_HOME/standalone/deployments/jboss-seam-booking.ear.failed e criando um arquivo em branco jboss-seam-booking.ear.dodeploy no mesmo diretório.
  8. A esta altura, o aplicativo é implantado sem erros, porém quando acessar o URL http://localhost:8080/seam-booking/ em um navegador e tentar "Entrar na Conta", um erro de tempo de execução “A página não está sendo redirecionada de forma apropriada” será exibido. No próximo passo, você aprenderá como depurar e resolver os erros de tempo de execução.
    Consulte Seção 4.3.7, “Depuração e Resolução de Exceções e Erros de Tempo de Execução do Arquivo do Seam 2.2 Booking” para mais informações sobre como depurar e resolver problemas de tempo de execução.
    Clique aqui Seção 4.3.4, “Migração do Arquivo do Seam 2.2 Booking para JBoss EAP 6: Instruções Passo a Passo” para retornar ao tópico anterior.
Reportar um erro