Next 3.6.0 SVN HEAD - Como migrar

[rogelgarcia]

O Next 3.6.0 está sendo desenvolvido. Diversas alterações arquiteturais foram feitas para facilitar ainda mais a utilização do framework, principalmente em respeito a personalização e configuração.

Como ainda demora um pouco para o lançamento oficial da versão, este tópico servirá como um guia básico para quem quiser já utilizar a versão 3.6.0 que está no HEAD do SVN. Esta versão é bastante estável e é utilizada por sistemas em produção.

É recomendável criar uma nova aplicação básica para testar o novo Next. Conseguindo criar uma aplicação básica, migre a sua aplicação oficial seguindo as mesmas orientações.

Todas as funcionalidades do Next continuam funcionando, porém alguns pequenos ajustes podem ser necessários.

Se houver dúvidas, ou ocorrerem erros durante a utilização do Next 3.6.0 basta perguntar no fórum. Coloque no título da mensagem o prefixo "Next 3.6.0 SVN HEAD" para facilitar a organização.

Pode ser que para alguma situação específica não seja colocada a instrução aqui nessa mensagem. Se ocorrerem tais situações atualizaremos esse tópico com esses detalhes.

[rogelgarcia]

[rogelgarcia]

Crie um projeto Java (ou Web se estiver disponível) no seu eclipse.
Se for um projeto Java normal, crie uma pasta no projeto chamado WebContent. Se tiver criado um projeto web essa pasta já deve ter sido criada.

Nesse tutorial o projeto Next será utilizado como um projeto dependente (ao invés de gerar JARs para o next)
Coloque o projeto org.nextframework como sendo uma dependência do seu projeto.
Botão direito no seu projeto > Build Path > Configure Build Path
Na aba Projects clique em Add... e escolha o projeto org.nextframework

Se desejar, poderá adicionar a dependência dos módulos org.nextframework.legacy (inclui recursos para relatórios) e também o org.nextframework.authorization.dashboard (inclui recursos para criação da tela de autorização). Esses dois últimos módulos não são importados automaticamente quando o org.nextframework é adicionado ao classpath.


Aproveitando ainda a tela de configuração do Build Path, vá até a aba Source.
No Default Output Folder coloque seuprojeto/WebContent/WEB-INF/classes
(ou clique em Browse e escolha esse diretório dentro do seu projeto, crie essa hierarquia de pastas se ela não existir)


Nesse momento o seu projeto já terá a dependencia do next e também estará configurado para que as classes compiladas sejam colocadas em WEB-INF/classes

PS: Alguns plugins utilizam pastas diferentes de WebContent para ser a raíz do projeto web, se for esse o caso todo lugar que fizer referência a WebContent troque pela pasta que seu plugin criou.

[rogelgarcia]

[rogelgarcia]

[rogelgarcia]

[rogelgarcia]

Aplicação mínima para o Next 3.6.0 (não inclui as bibliotecas, utiliza os projetos do next já existentes no workspace)

Importe esse projeto para seu eclipse. Alguma configuração de build path (do JRE) pode ser necessária.

Execute o build.xml para publicar a aplicação. Mas antes, altere o caminho do seu servidor no arquivo (propriedade deploy.dir).

Teste utilizando a url http://localhost:8080/hellonext/hello/world

Obs: Não inclui o web.xml, que não é obrigatório no Tomcat 7. Se estiver utilizando outro servidor, pode ser necessário colocar o web.xml, como mostrado no passo 3, dentro de WEB-INF.

[rogelgarcia]

Se você tiver feito download do arquivo compactado do next você terá que copiar os arquivos .jar para sua aplicação:
- Copiar todos os arquivos .jar dentro de /lib para WEB-INF/lib
- Copiar todos os arquivos .jar dentro de /lib/dependencies para WEB-INF/lib

Publique a sua aplicação como uma aplicação JEE usando os plugins da sua IDE. Com a versão em JAR não é possível utilizar o build.xml.

Usar o projeto aberto (ao invés de JAR) tem duas vantagens, você pode usar o build.xml, e os projetos contém os códigos fontes das bibliotecas dependentes. Se desejar continuar usando o next como um projeto no workspace, fique a vontade.