Archive for the ‘Utilidades’ Category
Legibilidade do código - Nomes significativos
Desde um pouco antes de minha passagem pela Austrália tenho me dedicado a estudar sobre código e formas de codificar. Melhores e piores técnicas. Na época que passei na Austrália essa dedicação foi amplificada, pois como não estava trabalhando e nem a procura de um emprego passei muito tempo apenas lendo a respeito e aplicando algumas técnicas em códigos pessoais.
Se você ainda não teve uma experiência como esta, você é uma pessoa de sorte, mas em alguns casos você é obrigado a trabalhar com a restrição de oito caracteres para nomes. Essa “lei” se aplica para banco de dados antigos que não evoluíram.
Mas isso não quer dizer que o seu código (Java, C#, Ruby….) deva seguir este modelo. Os nomes das variáveis, métodos devem ser ao menos significativos.
Veja o seguinte trecho de código:
Este é apensa um exemplo, mas tais variáveis não dizem nada, absolutamente nada sobre a intenção das mesmas. Além do mais, você como um programador deve codificar mentalmente o que significa as variáveis cor e pal dentro do contexto. Agora leia o código a baixo:
Não é mais simples? Foi necessário alguma decodificação mental a respeito da intenção das variáveis?
Outra regra muito fácil aprendida na faculdade é de que o nomes para métodos devem ser verbos, expressando uma ação. Como por exemplo: get / set / is / do…..
Mas e com relação a construtores? Estes não são nada próximos de amigáveis ou mesmo significativos.
Uma boa saída é criar métodos estáticos dentro da própria classe informando o motivo para aquele construtor estático, por exemplo:
Este é um exemplo muito pequeno e sem nenhum contexto. Ainda neste código o nome do método construtor createComplete poderia ser renomeado apenas para create, caso existisse uma convenção em toda a aplicação de que o método chamado create precise de todos os parâmetros do objeto para ser criados.
Uma outra alternativa seria criar um construtor static ao invés de informar o parâmetro faltante - state - que não é algo muito legível, utilizar um contexto para esta criação, como por exemplo: createForSelect, sendo utilizado para a criação de um objeto City para ser utilizado em um campo html select.
Nomes Significativos.
Se você ainda não teve uma experiência como esta, você é uma pessoa de sorte, mas em alguns casos você é obrigado a trabalhar com a restrição de oito caracteres para nomes. Essa “lei” se aplica para banco de dados antigos que não evoluíram.
Mas isso não quer dizer que o seu código (Java, C#, Ruby….) deva seguir este modelo. Os nomes das variáveis, métodos devem ser ao menos significativos.
Veja o seguinte trecho de código:
Este é apensa um exemplo, mas tais variáveis não dizem nada, absolutamente nada sobre a intenção das mesmas. Além do mais, você como um programador deve codificar mentalmente o que significa as variáveis cor e pal dentro do contexto. Agora leia o código a baixo:
Não é mais simples? Foi necessário alguma decodificação mental a respeito da intenção das variáveis?
Nomes de Métodos e Construtores.
Outra regra muito fácil aprendida na faculdade é de que o nomes para métodos devem ser verbos, expressando uma ação. Como por exemplo: get / set / is / do…..
Mas e com relação a construtores? Estes não são nada próximos de amigáveis ou mesmo significativos.
Uma boa saída é criar métodos estáticos dentro da própria classe informando o motivo para aquele construtor estático, por exemplo:
Este é um exemplo muito pequeno e sem nenhum contexto. Ainda neste código o nome do método construtor createComplete poderia ser renomeado apenas para create, caso existisse uma convenção em toda a aplicação de que o método chamado create precise de todos os parâmetros do objeto para ser criados.
Uma outra alternativa seria criar um construtor static ao invés de informar o parâmetro faltante - state - que não é algo muito legível, utilizar um contexto para esta criação, como por exemplo: createForSelect, sendo utilizado para a criação de um objeto City para ser utilizado em um campo html select.
Nota Fiscal Paulista
Nota Fiscal Paulista
Muito legal a iniciativa e o melhor, o site funciona bem, a nao ser alguns
problemas menores com o Firefox, mas no IE vai bem.
O que é?
Agora em São Paulo é assim: até 30% do ICMS recolhido pelo estabelecimento comercial será devolvido ao consumidor. Isso vai reduzir, de fato, a carga tributária individual dos cidadãos. O Governo do Estado de São Paulo instituiu a lei que cria o Programa de Estímulo à Cidadania Fiscal e vai implantar o projeto da Nota Fiscal Paulista a partir de 1° de outubro 2007. O projeto da Nota Fiscal Paulista vai devolver dinheiro para os consumidores. Ele será um incentivo para que os cidadãos que adquirem mercadorias exijam do estabelecimento comercial o documento fiscal. Os consumidores identificados pelo CPF ou CNPJ no momento da compra, vão receber créditos e ainda vão se habilitar a concorrer a prêmios. O objetivo é incentivar nos cidadãos o hábito de exigir a nota ou o cupom fiscal.
Como funciona?
1 - Em cada compra, o consumidor solicita sua Nota Fiscal/Cupom Fiscal ou Nota Fiscal on-line e informa seu CPF/CNPJ.
2 - O vendedor registra o CPF/CNPJ do comprador. Ele emite o Cupom Fiscal, a Nota Fiscal tradicional ou gera, no site, a Nota on-line.
3 - Após o recolhimento do ICMS pelo estabelecimento, a Secretaria da Fazenda creditará ao consumidor a parcela do imposto a que ele tem direito, proporcional ao valor da compra.
4 - O crédito poderá, dentro de cinco anos, ser utilizado para reduzir o valor do débito do IPVA, transferido para a conta corrente, poupança, creditado em cartão de crédito, transferido para outra pessoa ou devolvido em prêmios.
Problemas?
Nao funciona muito bem com o Firefox, no entanto, funcionará (espero) muito bem para o bolso!
Estabelecimentos em que já é possivel conseguir o crédito?
http://www.nfp.fazenda.sp.gov.br/lista.shtm
(ainda nao tem nenhum estabelecimento)
Como me cadastrar?
Acesse e informe os dados iniciais, lembre-se que os dados para o primeiro acesso sao os constantes na sua declaração do IR: https://www.nfp.fazenda.sp.gov.br/login.aspx?ReturnUrl=%2fPrincipal.aspx
Endereço: http://www.nfp.fazenda.sp.gov.br/
Muito legal a iniciativa e o melhor, o site funciona bem, a nao ser alguns
problemas menores com o Firefox, mas no IE vai bem.
O que é?
Agora em São Paulo é assim: até 30% do ICMS recolhido pelo estabelecimento comercial será devolvido ao consumidor. Isso vai reduzir, de fato, a carga tributária individual dos cidadãos. O Governo do Estado de São Paulo instituiu a lei que cria o Programa de Estímulo à Cidadania Fiscal e vai implantar o projeto da Nota Fiscal Paulista a partir de 1° de outubro 2007. O projeto da Nota Fiscal Paulista vai devolver dinheiro para os consumidores. Ele será um incentivo para que os cidadãos que adquirem mercadorias exijam do estabelecimento comercial o documento fiscal. Os consumidores identificados pelo CPF ou CNPJ no momento da compra, vão receber créditos e ainda vão se habilitar a concorrer a prêmios. O objetivo é incentivar nos cidadãos o hábito de exigir a nota ou o cupom fiscal.
Como funciona?
1 - Em cada compra, o consumidor solicita sua Nota Fiscal/Cupom Fiscal ou Nota Fiscal on-line e informa seu CPF/CNPJ.
2 - O vendedor registra o CPF/CNPJ do comprador. Ele emite o Cupom Fiscal, a Nota Fiscal tradicional ou gera, no site, a Nota on-line.
3 - Após o recolhimento do ICMS pelo estabelecimento, a Secretaria da Fazenda creditará ao consumidor a parcela do imposto a que ele tem direito, proporcional ao valor da compra.
4 - O crédito poderá, dentro de cinco anos, ser utilizado para reduzir o valor do débito do IPVA, transferido para a conta corrente, poupança, creditado em cartão de crédito, transferido para outra pessoa ou devolvido em prêmios.
Problemas?
Nao funciona muito bem com o Firefox, no entanto, funcionará (espero) muito bem para o bolso!
Estabelecimentos em que já é possivel conseguir o crédito?
http://www.nfp.fazenda.sp.gov.br/lista.shtm
(ainda nao tem nenhum estabelecimento)
Como me cadastrar?
Acesse e informe os dados iniciais, lembre-se que os dados para o primeiro acesso sao os constantes na sua declaração do IR: https://www.nfp.fazenda.sp.gov.br/login.aspx?ReturnUrl=%2fPrincipal.aspx
Endereço: http://www.nfp.fazenda.sp.gov.br/