DepartamentoHome novo arquivo

package br.xt.app.departamento;

import br.jasap.core.Effect;
import br.jasap.effect.Response;
import br.jasap.gui.JasapPage;
import br.jasap.gui.SideMenu;
import br.jasap.gui.Table;
import br.jasap.gui.TableRow;
import br.jasap.util.Js;
import br.xt.AppsRootAction;
import br.xt.acore.view.XtPage;

public class DepartamentoHome extends AppsRootAction {

    public static final String MID = "__DEPARTAMENTO_MID";

    @Override
    public Effect execute() throws Exception {
        render();
        return new Response();
    }

    public void render() throws Exception {
        XtPage page = new XtPage(getManager());
        if (isAjaxCall()) {
            eval(Js.CLOSE_SUB_WINDOWS);
        } else {
            page.getBody().append(page.content("", "", false));
            page.setWinTitle("Departamento");
            page.getCommands().add(link(MenuItem.class).putInteger(MID, 0).ajax());
            getOutput().write(this, page);
        }
    }

    public static class Title extends DepartamentoHome {
        @Override
        public Effect execute() throws Exception {
            int mid = getInput().getInteger(MID, 0);

            Table aux = new Table(getManager());
            TableRow line = aux.row();

            line.col().setStyle("padding: 0 5 0 5;").setContent(ui().btTitleActive("DEPARTAMENTO", ""));

            update(JasapPage.DIV_HEADER_LEFT, aux);
            update(JasapPage.DIV_HEADER_CENTER, "");
            return new Response();
        }
    }

    public static class MenuItem extends DepartamentoHome {
        @Override
        public Effect execute() throws Exception {
            int mid = getInput().getInteger(MID, 0);

            if (mid > 0) {
                eval(link(Title.class).putInteger(MID, mid).ajax());
                eval(link(Title.class).putInteger(MID, mid).ajax(false));
            } else {
                eval(link(MenuInicial.class).ajax(false));
                eval(link(Title.class).putInteger(MID, mid).ajax(false));
            }

            return new Response();
        }
    }

    public static class MenuInicial extends DepartamentoHome {
        @Override
        public Effect execute() throws Exception {
            SideMenu m = new SideMenu();

            update("sidebar", m.toHtml());
            return new Response();
        }
    }

}

throws Exception

Aparece em quase todos os métodos deste arquivo (e de qualquer arquivo do Jasap). O Java obriga a declarar quando um método pode dar erro. Coisas que podem dar erro: acessar dados da requisição HTTP, montar componentes visuais, escrever a resposta pro browser, criar links pra actions.

Quando um método chama outro que pode dar erro, ele precisa declarar throws Exception também. É como uma corrente: se o método A chama o método B que pode falhar, o método A precisa avisar que também pode falhar.

No Jasap, quase tudo pode falhar (acesso a dados, reflexão Java, I/O de rede). Por isso quase todo método tem throws Exception. Regra simples: se o método chama qualquer coisa do Jasap (ui(), link(), getInput(), update(), eval()), precisa ter throws Exception.

Essa regra vale pra todos os arquivos daqui pra frente.

@Override

Cada subclass (Title, MenuItem, MenuInicial) tem @Override public Effect execute(). Por quê? Porque cada subclass é uma action independente — quando o Jasap recebe uma requisição para Title, ele chama o execute() dela, não o da mãe.

O @Override é uma anotação de segurança: garante que você está sobrescrevendo um método que realmente existe na classe mãe. Se errar o nome (ex: excute() em vez de execute()), o compilador avisa na hora em vez de deixar passar.

Sem sobrescrever, todas as subclasses executariam o execute() da mãe — que chama render() e montaria a página inteira de novo, em vez de fazer o trabalho específico da subclass.

public static class

As subclasses Title, MenuItem e MenuInicial são inner classes estáticas. Isso significa que elas vivem dentro do arquivo DepartamentoHome.java, mas o Jasap as trata como actions independentes — cada uma tem sua própria URL no framework e é instanciada separadamente.

O extends DepartamentoHome existe para herdar os métodos utilitários (ui(), link(), eval(), update()), as constantes (MID) e o contexto (session, manager, input/output). Sem essa herança, seriam classes soltas sem acesso a nada do Home.

É como se fossem funcionários do mesmo departamento: trabalham independentes, mas compartilham as ferramentas e o espaço do departamento.

public static class Title extends DepartamentoHome {
    @Override
    public Effect execute() throws Exception {
        int mid = getInput().getInteger(MID, 0);

        Table aux = new Table(getManager());
        TableRow line = aux.row();

        line.col().setStyle("padding: 0 5 0 5;").setContent(ui().btTitleActive("DEPARTAMENTO", ""));

        update(JasapPage.DIV_HEADER_LEFT, aux);
        update(JasapPage.DIV_HEADER_CENTER, "");
        return new Response();
    }
}

Responsável por atualizar o breadcrumb no topo da tela — o letreiro que mostra onde o usuário está. É uma inner class estática: o Jasap a registra e instancia como uma action independente, com sua própria URL. Quando o Jasap chama Title, executa o execute() dela — não o do DepartamentoHome. O extends DepartamentoHome existe apenas para herdar os métodos utilitários: update(), ui(), link(), getInput().

Por enquanto, sem entidades, o Title só mostra "DEPARTAMENTO" fixo. Quando a primeira entidade for criada, um switch(mid) será adicionado para variar o breadcrumb conforme a tela ativa (ex: "DEPARTAMENTO > Produtos").

public static class MenuItem extends DepartamentoHome {
    @Override
    public Effect execute() throws Exception {
        int mid = getInput().getInteger(MID, 0);

        if (mid > 0) {
            eval(link(Title.class).putInteger(MID, mid).ajax());
            eval(link(Title.class).putInteger(MID, mid).ajax(false));
        } else {
            eval(link(MenuInicial.class).ajax(false));
            eval(link(Title.class).putInteger(MID, mid).ajax(false));
        }

        return new Response();
    }
}

Roteador central do módulo. Toda navegação passa por aqui. Cada link do sidebar aponta para MenuItem com um MID diferente. O MenuItem recebe o número, decide o que fazer e dispara as actions necessárias. Nenhuma tela é aberta diretamente — tudo passa pelo MenuItem primeiro.

public static class MenuInicial extends DepartamentoHome {
    @Override
    public Effect execute() throws Exception {
        SideMenu m = new SideMenu();
        update("sidebar", m.toHtml());
        return new Response();
    }
}

Renderiza o conteúdo do sidebar via Ajax, após a página já estar no browser. Quando o render() monta a página pela primeira vez, o sidebar vem vazio — é o MenuInicial que preenche ele logo em seguida, chamado automaticamente pelo page.getCommands().add(...). E quando o usuário volta ao menu inicial (clica no breadcrumb "DEPARTAMENTO"), o MenuItem com MID=0 chama o MenuInicial de novo para reconstruir o sidebar — sem recarregar a página inteira.

No estado atual o SideMenu é criado vazio porque não há entidades. Conforme forem adicionadas, cada uma ganhará um m.add(...) aqui.