Caelum Stella - o cinto de utilidades para o desenvolvedor brasileiro
Por Fabio Kung em 21/05/08
Durante o Falando em Java 2008 do último fim de semana (18/05/2008), anunciamos o lançamento do novo Caelum Stella.
O projeto vem para auxiliar os desenvolvedores brasileiros, suprindo algumas das necessidades comumente encontradas em aplicações desenvolvidas aqui no Brasil. Atualmente, o Caelum Stella fornece uma biblioteca de validadores, formatadores e conversores para documentos brasileiros, tais como CPF, CNPJ e PIS/PASEP.
String cpf = "867.554.707-24";
CPFValidator vld = new CPFValidator();
for(ValidationMessage error : vld.invalidMessagesFor(cpf)) {
System.out.println(error.getMessage());
}
Há uma alternativa que lança uma exceção caso ocorra algum problema de validação:
new CPFValidator().assertValid("867.554.707-24");
O Stella também inclui módulos extras, como o de geração de boletos bancários, adaptadores para JSF, VRaptor, JBoss Seam e Hibernate Validator. Veja um exemplo de validação para CPFs usando o Caelum Stella junto ao Hibernate Validator:
@Entity
public class Modelo {
@CPF
private String cpf;
public String getCpf() {
return cpf;
}
}
O módulo Stella Faces conta com alguns validadores compatíveis com a especificação JSF, que você pode adicionar aos seus componentes:
<h:inputText id="cpf" value="#{usuarioBean.cpf}">
<stella:validateCPF/>
</h:inputText>
O Stella Boleto procura fornecer um idioma mais fluente para a geração de boletos, através do encadeamento de métodos, gerando PDFs, PNGs e em breve TXT, RTF e HTML:
Boleto boleto = Boleto.newBoleto()
.withBanco(banco).withDatas(datas)
.withDescricoes("descricao 1", "descricao 2", "descricao 3")
.withEmissor(emissor).withSacado(sacado)
.withValorBoleto("200.00").withNoDocumento("1234")
.withInstrucoes("instrucao 1", "instrucao 2", "instrucao 3")
.withLocaisDePagamento("local 1", "local 2");
new BoletoGenerator(boleto).toPNG("teste.png");
Estão ainda previstas no roadmap do projeto funcionalidades como JSP taglibs, rotinas JavaScript para máscaras, validação e suporte a formulários, seleção de cidades dependente da seleção de estados, suporte a mais documentos, geração da nota fiscal eletrônica, webservices para busca de endereços através de CEP, entre muitas outras. A lista vem sendo constantemente atualizada e você pode conferi-la através deste link.
Todas estas funcionalidades estão divididas em diversos módulos dentro do Stella. Atualmente são quatro: Stella Core, Stella Hibernate, Stella Faces e Stella Boleto. Cada um com um propósito diferente, mas todos relacionados aos problemas do dia a dia recorrentes no mercado brasileiro.
Além de facilitar a vida dos desenvolvedores brasileiros, o projeto prima pela alta qualidade (extensa quantidade de testes unitários, cobertura e documentação) e facilidade de uso. Você pode conferir diversas características técnicas do projeto e dos vários módulos na página técnica, gerada pelo maven. Lá você encontra a lista de responsáveis (e respectivos emails), a ótima cobertura dos testes para cada um dos módulos e o código fonte navegável para cada um dos módulos.
Como de costume em qualquer projeto open-source, o código fonte está disponível em um repositório SVN (subversion) no sourceforge.net. Para baixar os fontes basta usar seu cliente preferido:
svn checkout http://caelum-stella.svn.sourceforge.net/svnroot/caelum-stella/trunkVocê também pode navegar pelo repositório neste link.
Para tirar as suas dúvidas, sugerir funcionalidades, apontar bugs e discutir sobre o projeto, não deixe de assinar as listas de discussão, que podem ser encontradas aqui. Se preferir, pode postar também no GUJ.
Visite, use, comente e participe do desenvolvimento do projeto!