Debug Mode

Não seria bom se você pudesse ver tudo que acontece dentro do seu framework web? Qual action foi executada, quais filtros foram aplicados, o que está no input e no output da action depois de cada filtro? O Mentawai revela a mágica do seu controlador através do debug mode.

Para ver o debug mode em ação você pode brincar com a aplicação de referência clicando aqui.

Setando o filtro de servlets no web.xml:

O Debug Mode precisa de um filtro de servlet para interceptar a requisição e acrescentar as informações de debug na resposta. No seu arquivo WEB-INF/web.xml você deve acrescentar:

    <filter>
        <filter-name>DebugFilter</filter-name>
        <filter-class>
            org.mentawai.util.DebugServletFilter
        </filter-class>
    </filter>
    
    <filter-mapping>
        <filter-name>DebugFilter</filter-name>
        <url-pattern>*.jsp</url-pattern>
        <dispatcher>REQUEST</dispatcher> 
        <dispatcher>FORWARD</dispatcher>    
        <dispatcher>INCLUDE</dispatcher>    
        <dispatcher>ERROR</dispatcher>    
    </filter-mapping>

Ligando o modo debug no application manager:

Feito a configuração acima, você pode ligar ou desligar o debug mode diretamente no application manager:

    @Override
    public void init(Context application) {
        
        setDebugMode(true);
        //or
        setDebugMode(true, true); // a segunda flag te dá a opção de colocar as informações dentro de um comentário html
    }

DICA: Você pode colocar as informações de debug dentro de um comentário HTML caso elas estejam interferindo com o layout do seu site.

Usando uma variável do arquivo properties por ambiente:

É provavelmente uma boa idéia ligar o debug mode de acordo com o ambiente que a sua aplicação está sendo executada. Por exemplo, para produção quase que certamente você não vai querer imprimir as informações de debug no seu site. Logo você deve utilizar um arquivo properties por ambiente para especificar essa opção.

    @Override
    public void init(Context application) {
        
        Props props = getProps();
          
        setDebugMode(props.getBoolean("debug_mode"));
        //or
        setDebugMode(props.getBoolean("debug_mode"), props.getBoolean("debug_mode_in_html_comment"));
    }