O Seam Remoting oferece uma forma conveniente de acessar componentes backing beans via AJAX. Com uma simples anotação é possível chamar ações, intanciar objeto e etc. Porém este recurso é uma maneira limitada de acessar o contexto dos componentes e requer uma certa atenção de nós desenvolvedores. Pessoalmente, pude presenciar soluções fantásticas usando remoting e mas algumas implementações desastrosas. Fica a dica: use o remoting apenas quando os componentes AJAX existentes não solucionam um dado problema.

Por padrão, uma requisição AJAX via Seam Remoting não possui controle de transações e o contexto JSF não é criado. Para ambos os casos é possível habilitá-los. O controle de transações é mais simples, basta adicionar a anotação @Transactional com o tipo REQUIRED. Veja o exemplo:

@WebRemote @Transactional(TransactionPropagationType.REQUIRED)
public void updateUserProfile(Profile profile) {
entityManager.merge(profile);
}

Criar o contexto JSF exige algo um pouco mais avançado. Antes de iniciar a execução das ações, o contexto JSF deve ser criado, e para a sua criação é preciso o HttpServletRequest e o HttpServletResponse. Uma forma seria criando um filtro, mas acredito que não é uma boa solução. O Seam possui um recurso de ExecutionHandler que permite executar determinadas operações em requisições Remoting antes executar a ação. Este recurso usa o padrão Observer, onde o primeiro passo é criar o observer, ele precisa de implementar a interface ExecutionHandler:

public class RemotingFacesContextHandler extends ExecutionHandler {

private ServletContext servletContext;

protected FacesContext getFacesContext(HttpServletRequest request,
HttpServletResponse response) {

FacesContext facesContext = FacesContext.getCurrentInstance();

if (facesContext == null) {
FacesContextFactory contextFactory = (FacesContextFactory) FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);
LifecycleFactory lifecycleFactory = (LifecycleFactory) FactoryFinder.getFactory(FactoryFinder.LIFECYCLE_FACTORY);
Lifecycle lifecycle = lifecycleFactory.getLifecycle(LifecycleFactory.DEFAULT_LIFECYCLE);
facesContext = contextFactory.getFacesContext(servletContext,request, response, lifecycle);
}

return facesContext;
}
@Override
public void handle(HttpServletRequest request, HttpServletResponse response)
throws Exception {
getFacesContext(request, response);
super.handle(request, response);
}
@Override
public void setServletContext(ServletContext ctx) {
this.servletContext = ctx;
super.setServletContext(ctx);
}
}

O método handle chama o método getFacesContext que é responsável por iniciar o contexto. A inicialização do FacesContext é feita por meio do método getFacesContext da classe FacesContextFactory. Além do contexto servlet, do request e do response, é necessário informar o ciclo de vida JSF.O Ciclo de vida é criado por meio da classe LifecycleFactory.

Uma vez criado o observer, basta registrá-lo. Uma das várias alternativas é registrá-lo após a inicialização usando a anotação @Observe:

@Name("registerHandler")
public class RegisterFacesContextHandler {
private static final String REQUEST_PATH_EXECUTE = "/execute";

@Observer("org.jboss.seam.postInitialization")
public void initHandler() {
RequestHandlerFactory.getInstance().registerHandler(REQUEST_PATH_EXECUTE, new RemotingFacesContextHandler());

}

}

Após inicializado o Seam (org.jboss.seam.postInitialization) o observer é registrado. Com isto você pode chamar FacesContext.getCurrentInstance() que não receberá aquele NullPointerException indesejado.

A parte 8, faz a introdução do Seam Remoting. São mostradas as configurações necessárias e a forma de acesso a componentes SEAM. O Seam Remoting é uma forma eficiente acessar componentes SEAM usando AJAX, permitindo ao desenvolvedor resolver problemas que os componentes disponíveis no mercado não atendem. Para utilizá-lo é facil, basta apenas ter o SeamResourceServlet configurado e basta chamar os arquivos javascript ou usar a tag remote para usar os componentes, veja o exemplo:

<script type="text/javascript" src="seam/resource/remoting/resource/remote.js"></script>
<script type="text/javascript" src="seam/resource/remoting/interface.js?newsHome&amp;usersHome"></script>
<!-- Mesmo resultado em relação as 2 linhas anteriores-->
<s :remote include="newsHome,usersHome"/>

A parte 9 aborda uma feature interessante, a resolução de EL. Como uma expression language é resolvida durante a rendereização da página, para usar este recurso é preciso usar a função dentro fora da página em um arquivo Javascript. Depois é só chamar a função da seguinte forma:

Seam.Remoting.eval("#{newsHome.relatedNews}", newsCallback);
// callback function
function newsCallback(newsList) {
// read news
var area = document.getElementById("relatedNews");
for (var i = 0; i < newsList.length; i++) {
var news = newsList[i];
var span = document.createElement("span");
span.innerHTML = "<h4><a href='ViewNews.seam?newsId=" + news.getId() + "'>" +
news.getTitle() + "</a>" + news.getDescription();
area.appendChild(span);
}
}

A última vídeo aula da série mostrará chamadas em lote e a utilização de classes que não são componentes SEAM.

Parte 8
Parte 9

Arquivos Fontes

A parte 6, mostra todos os passos para enviar e-mails usando o módulo de integração do Seam Framework com a JavaMail. O Seam Framework possui um gerenciador de envio de e-mails e para usá-lo é bastante simples. Vejo sempre em fóruns a dificuldade que usuários tem para enviar e-mails usando uma conta SMTP do google, porém o Seam oferece diversas facilidades para configuração. O código abaixo configura o envio de e-mails usando uma conta do Google.

<mail :mail-session host="smtp.gmail.com" port="587" username="testes@marcossousa.com" password="java2008." ssl="false" tls="true"/>

Para configurar a mensagem é bem simples, basta criar um arquivo XHTML usando as tags m:message. Nos fontes há o exemplo demonstrado na vídeoaula.

Já a parte 7 aborda outro tópico interessante, a utilização de CAPTCHA. O Seam oferece uma solução básica, que gera imagens usando representação de somas simples. Na vídeo eu mostro como customizar a classe para gerar imagens mais complexas, no exemplo criado gera códigos alfanuméricos de 6 caracteres. Por padrão, basta apenas configurar o Seam Resource Servlet e usar o código abaixo:

<s :decorate id="verification">
<h :graphicImage value="/seam/resource/captcha" id="captchaimg" />
<h :inputText value="#{captcha.response}"  required="true" id="verify">
<s :validate></s>
<a :support event="onblur" reRender="verification" bypassUpdates="true" ajaxSingle="true"></a>
</h>
</s>

As próximas vídeo aulas da série abordarão as funcionalidades do Seam Remoto.

Parte 6
Parte 7

Arquivos Fontes

Esta parte mostra um passo-a-passo para criar documentos em PDF usando o módulo de integração do Seam Framework com o iText. Na vídeo aula, são apresentadas algumas das tags descritas na publicação Gere PDF de Qualidade em 10 minutos, o documento resultante gera um PDF que contém imagens, títulos, texto HTML formatado e um rodapé contendo texto e numeração.

As próximas vídeo aulas abordarão o envio de e-mails, CAPTCHA e agendamento de tarefas.

Arquivos Fontes
Vídeo aula

Nesta parte não foi demonstrado nenhum recurso especial do Seam Framework, porém foi demonstrado o uso do componente input suggestion.

Link da Vídeo Aula
Arquivos fontes

As próximas partes abordarão a geração de PDF e envio de e-mails.

A primeira vídeo aula aborda a criação e configuração da aplicação. É criado o banco de dados, criação dos formulários e aplicado restrições de acesso a pasta dos cadastros de usuários, tags, anexos e notícias.

A segunda parte aborda a criação de uma classe de criptografia MD5, criptografia e validação de senhas no cadastro de usuário e customização da classe de autenticação de usuários usada pelo Seam Framework.

Por fim a terceira parte abordou a implementação do código necessário para fazer upload de arquivos usando o componente do RichFaces rich:fileUpload. No exemplo, foi limitado o tamanho máximo de arquivos, o tipo do arquivo (apenas imagens) e implementado a ação de modo que salvasse a imagem no Banco de Dados usando o Hibernate. Por fim foi apresentado também como pode ser realizado a exibição de imagens usando o a4j:mediaOutput.

As próximas vídeo aulas mostrarei a implementação do recurso de autocompletar, semelhante ao WordPress, e mostrarei também a geração de PDF e Envio de e-mails. Vale a pena conferir!

Para os interessados, é possível obter a implementação sozinha ou para quem usa o Glassfish Application Server a API também estará disponível através do Update Center do Application Server.

Venho acompanhando o blog do Ryan Lubke, nele há várias informações e dicas mostrando as novas features do JSF 2.0. Vale a pena dar uma olhada.

Veja o código do conversor:

@Name("productConverter")
@BypassInterceptors
@Converter(forClass=Product.class)
public class ProductConverter implements javax.faces.convert.Converter{

public Object getAsObject(FacesContext arg0, UIComponent arg1, String arg2) {
// Insira o código que transforme a string no objeto desejado (Product)
}

public String getAsString(FacesContext arg0, UIComponent arg1, Object arg2) {
// Insira o código que transforme o objeto desejado (Product)    em String
}

}  

Para registrar um conversor temos que usar as anotações:
@Name – Registra o conversor como um componente Seam
@BypassInterceptors – Indica que o conversor não deve sofrer ação dos intercetadores SEAM.
@Converter – Registra o conversor no contexto JSF, o atributo forClass indica a classe que iremos converter.

Também poderíamos cria o conversor usando um identificador, porém eu fiz alguns testes e para determinados comportamentos são gerados erros relacionados ao controle de estado. Se você também teve estas experiências, compartilhe-as!

“I spent an hour with the Dutch JUG. It was great during the opening on Tuesday morning when John Gage made a comment about the Brazilians being uninhibited extroverts, and how the rest of the audience should be honorary Brazilians… About 80 members of the Dutch jug lept up with a huge banner and let out a roar that put the Brazilians to shame. There’s definitely some national competition brewing here.”

Bom não estamos em destaque sozinhos, os holandeses estão aí. Mas bem que eu gostaria de estar em San Francico para ajudar a fortalecer a comunidade brasileira.

Na vídeo aula foram criados dois conversores de dados JSF para as entidades de Produto e Categoria. Estes conversores são usados nos combos de produto (página MovimentEdit.xhtml) e categorias (Página ProductEdit.xhtml). Estes combos recebem listas de SelectItem, métodos criados na parte 9, contendo como valor a instância de produto e categoria. Para finalizar foi criada uma ação para calcular o valor total do movimento.

Esta foi a última vídeo aula da série que introduz os recursos do Seam Framework. Ao logo da série foi abordado a configuração da aplicação, criação de chamadas de ações usando parâmetros, a criação de page actions permitindo fazer o bind de parâmetros GET com propriedades de Managed Beans, criação de URL User Friendly, integração com Spring e por fim a exploração do Seam-Gen.

Espero que tenham gostado. Caso tenha alguma crítica e sugestão serão sempre bem vindas.

Vídeo Aula