Rodrigogml: /* CRUD Modelo */

2015-03-24T00:38:39Z

CRUD Modelo

← Edição anterior		Edição das 00h38min de 24 de março de 2015
Linha 20:		Linha 20:

	public class <beanname>Crud {		public class <beanname>Crud {
	public static <beanname>VO insert<beanname>(<beanname>VO vo) throws BISException {		public static <beanname>VO insert<beanname>(<beanname>VO vo) throws BISException {
	<beanname>Validation.insert<beanname>(vo);		<beanname>Validation.insert<beanname>(vo);
	<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();		<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
Linha 71:		Linha 71:
	return dao.findUniqueMatch(mo, attributes);		return dao.findUniqueMatch(mo, attributes);
	}		}

	}		}
	</syntaxhighlight>}}		</syntaxhighlight>}}

Rodrigogml: Criou página com 'O CRUD (acrônimo de Create, Read, Update e Delete na língua Inglesa) é a camada lógica do sistema. Nela está toda a definição do que o sistema se propõe a fazer. O CR...'

2015-03-20T14:09:57Z

Criou página com 'O CRUD (acrônimo de Create, Read, Update e Delete na língua Inglesa) é a camada lógica do sistema. Nela está toda a definição do que o sistema se propõe a fazer. O CR...'

Página nova

O CRUD (acrônimo de Create, Read, Update e Delete na língua Inglesa) é a camada lógica do sistema. Nela está toda a definição do que o sistema se propõe a fazer.

O CRUD é orientado a serviço, isto é, cada método tem a sua função clara e específica, recebe os dados de entrada e tenta cumprir sua função. Em caso de sucesso retorna o esperado, em caso de falha lança uma exceção. Não mantém estados (stateless). Em outras palavras, todos os seus métodos são estáticos e devem lançar apenas exceções do próprio framework: BISException. Qualquer outra exceção deve ser tratada e substituída por uma do BISCore como manda o [[Uso das Exceções]].

É recomendável que seja feita uma classe de CRUD para cada elemento do módulo. Isso porque cada classe de CRUD tende a ser extensa por ter os métodos de lógica, e muito código em uma classe torna-se confuso e de difícil manutenção. Além disso, é recomendável que métodos de validação e pré-processo muito longos sejam separados em outras classes, facilitando o a localização do código.

== CRUD Modelo ==

O modelo abaixo é uma classe genérica que implementa todos os métodos fornecidos pela persistência. Os de 'find' já ficam prontos, enquanto que os de insert, update e delete precisam ser melhor observados ganham apenas o 'TODO' em seu corpo. Para usa-lo faça as seguintes substituições com a ferramenta 'replace all':

* '''<beanname>''' - Substitua esta tag pelo nome do bean a ser persistido. Ex: 'Balance' para o 'BalanceVO', 'ItemCode' para o 'ItemCodeVO'.
* '''<modulename>''' - Substitua esta tag pelo nome do módulo. Ex: 'Fiscal', 'Item', 'ECF', etc.

{{java|Exemplo de Código de uma Classe do CRUD|<syntaxhighlight lang="java">
import java.util.Collection;
import java.util.List;

import br.com.biserp.bis.core.mo.BISOrderBy;
import br.com.biserp.bis.exceptions.BISException;

public class <beanname>Crud {
public static <beanname>VO insert<beanname>(<beanname>VO vo) throws BISException {
<beanname>Validation.insert<beanname>(vo);
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
vo = dao.insert(vo);
return vo;
}

public static <beanname>VO update<beanname>(<beanname>VO vo) throws BISException {
<beanname>Validation.update<beanname>(vo);
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
dao.update(vo);
}

public static void delete<beanname>(Long id) throws BISException {
<beanname>Validation.delete<beanname>(id);
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
dao.delete(id);
}

public static void delete<beanname>(Collection<Long> ids) throws BISException {
if (ids != null) {
for (Long id : ids) {
delete<beanname>(id);
}
}
}

public static Long count<beanname>(<beanname>MO mo) throws BISException {
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
return dao.count(mo);
}

public static List<Long> find<beanname>IDs(<beanname>MO mo, BISOrderBy orderby) throws BISException {
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
return dao.findIDs(mo, orderby);
}

public static <beanname>VO find<beanname>(Long id, String[] attributes) throws BISException {
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
return dao.findById(id, attributes);
}

public static List<<beanname>VO> find<beanname>List(<beanname>MO mo, BISOrderBy orderby, String[] attributes) throws BISException {
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
return dao.findList(mo, orderby, attributes);
}

public static <beanname>VO find<beanname>UniqueMatch(<beanname>MO mo, String[] attributes) throws BISException {
<beanname>DAO dao = <modulename>DAOFactory.get<beanname>DAO();
return dao.findUniqueMatch(mo, attributes);
}

}
</syntaxhighlight>}}

CRUD - Histórico de revisão

Rodrigogml: /* CRUD Modelo */

Rodrigogml: Criou página com 'O CRUD (acrônimo de Create, Read, Update e Delete na língua Inglesa) é a camada lógica do sistema. Nela está toda a definição do que o sistema se propõe a fazer. O CR...'