WebZero code

Gerência de Projetos

2010-07-29T12:14:00.000-07:00

Como "diria" a Wikipédia: "Gerência de projetos, gestão de projetos, gerenciamento de projetos ou ainda administração de projetos é a aplicação de conhecimentos, habilidades e técnicas na elaboração de atividades relacionadas para atingir um conjunto de objetivos pré-definidos, num certo prazo, com um certo custo e qualidade, através da mobilização de recursos técnicos e humanos."

Andei fazendo um curso nestas férias de inverno e, dentre o material disponibilizado, está um resumo sobre gerência de projetos que achei bem interessante.

O material é bem básico, indicado, principalmente, àqueles que querem aprender os principais conceitos da área e conhecer um pouco sobre o PMBOK.

Clique no link abaixo para baixar o material.

Introdução Gerência de Projetos - Download

Menu do asp.net não funciona no Google Chrome

2010-05-04T09:43:00.000-07:00

Este erro, ao contrário do que os outros pensam, não é do Chrome ou do Safari e sim do próprio ASP.NET.

Para gerar o código JavaScript do menu, o ASP.NET verifica qual é o browser do cliente, e se ele suporta ou não JavaScript. Acontece que esta verificação falha em alguns browsers como o Sarafi e consequentemente o Chrome (pois o Chrome foi baseado no Safari), e o ASP.NET então devolve um código que não funciona.

Para corrigir isto devemos “forçar” o ASP.NET a executar o JavaScript, para isto setamos a propriedade Page.ClientTarget com o valor “uplevel”. Assim informamos que o cliente possui um moderno “uplevel” browser.

Devemos fazer isto para todas as páginas que utilizarão o menu. O código deverá estar dentro do evento Page_Init da página. Ex:

protected void Page_PreInit(object sender, EventArgs e)

{
if (Page.Request.ServerVariables["http_user_agent"].ToLower().Contains("chrome"))
{
Page.ClientTarget = "uplevel";
}

}

Neste código, fazemos uma verificação se o user_agent possui a palavra 'chrome', que servirá também pro safari, se sim, forçamos o uplevel.

Para evitar de “copiar” e “colar” o mesmo código em todas as páginas, você poderá aproveitar o que há de melhor da programação orienteda a objetos, a herânça. Para isto crie uma classe herdando de System.Web.UI.Page e coloque este código nela. Para todas as suas páginas, ao invés de herdar diretamente de System.Web.UI.Page, você herda da classe que acabou de criar.

Como nomear seus objetos

2010-05-03T07:00:00.000-07:00

Como estou em meio a discussões sobre padrões resolvi postar este texto retirado do blog do Giovanni Bassi. Já havia colocado isto no meu antigo blog, mas acho ele muito bom e vou colocar novamente.
Segue então :

Estou no meio de uma consultoria, o cliente me pede para ver o código. Eu vou ver o código, claro. Eu olho a classe, olho os métodos, não entendo nada.

“ClienteDB”. Isso é nome de classe? O que será que quer dizer? Deixa eu ver o nome das funções. “ObterDados”. Nossa, que dados serão esses? Devem ser do cliente, e deve ter alguma coisa a ver com um banco de dados (tem o tal “DB” no final). Mas retorna booleano! Será que esses dados são da conexão com o banco de dados? Não, não, tem um método aqui chamado “Configurar”. Configurar… o quê? Será que é a conexão também? Ou será que é configurar o cliente?

Vou então examinar as variáveis. Dentro de um método encontro variáveis com nomes muito interessantes:

“obj”;
“oCliente”;
“i”
;“cmp”.

Agora ficou fácil!
O mesmo acontece quando estou dando aula. Vem o aluno e me mostra a classe. “Quarto”. Métodos: “dormir” e “acordar”. O quarto pode dormir? Tudo bem, são alunos, eles podem. Aí é legal, o aluno entende que está aprendendo, aproveita as sugestões e vai em frente, no próximo ele acerta. Mas programadores experientes?

Nomear classes (e funções, propriedades, eventos, ou seja, estruturas em geral) é importante. Se você não consegue dar um nome para sua classe, talvez ela esteja violando o princípio da responsabilidade única. Ou talvez ela não tenha um conceito sólido. De qualquer forma, não dê qualquer nome, é pior. Dê um nome expressivo.

Não se esqueça de que o usuário final da aplicação não é o único. O próximo desenvolvedor que vier depois de você dar manutenção na aplicação também é usuário, só que de outro ponto de vista.

Além disso, não use notação húngara em objetos de negócio. Se você gosta muito de notação húngara, use apenas em objetos de GUI, como txtNome, para textboxes. Não crie “oCliente”, ou “objCliente”, ou “cliNovo”. Não crie “intAnos”. Se são anos, só podem ser inteiros, chame de “anos”! Se é um cliente novo, chame de “clienteNovo”. Fica mais fácil de ler.

Entrando em uma questão mais de estilo pessoal:

Não use underline/underscore para definir nomes. Nada pior que “nome_completo”. Use lower CamelCase para variáveis e campos, como “nomeCompleto”, e upper CamelCase para classes, métodos, eventos e propriedades “NomeCompleto”, “Andar()”, “Click”. E use this (C#)/Me(VB) quando acessar campos ou propriedades de uma classe.

Enfim, torne seu código legível (questões de estilo – CamelCase, húngara, underline, etc), e expressivo (usando nomes que explicam a estrutura que nomeiam). O mundo inteiro agradece.

Fonte: http://unplugged.giggio.net/unplugged/post/Como-nomear-seus-objetos.aspx

Enterprise Library 5

2010-04-29T07:08:00.000-07:00

Dia 20 de abril foi lançada a versão final da Enterprise Library 5.0.

Enterprise Library é uma coleção de módulos(Application Blocks) reutilizáveis que auxiliam no desenvolvimento de aplicações corporativas visando suprir algumas necessidades comuns a estas aplicações.

De acordo com a Microsoft as principais novidades do EntLib 5 são:

Suporte para configuração programática, incluindo uma interface amigável de configuração e um esquema XSD para habilitar o IntelliSense
Suporte ao acesso a dados assíncrono
Validação de atributos entre Application Block Validation e DataAnnotations
Integração com os mecanismos de validação do Windows Presentation Foundation (WPF)
Suporte a configuração de cenários complexos, incluindo configuração de mutiplas fontes e também hierárquicamente
Otimização da limpeza do cache
Melhor desempenho para o log
Supporte ao .NET 4.0 Framework e integração com Microsoft Visual Studio 2010

Redesign da ferramenta de configuração para oferecer:

Maior usabilidade e controles mais intuitivos
Melhorias estendidas por meio da configuração de visualização de meta-dados para substituir a obrigação de escrever o código em tempo de design
Um Wizard que simplifica configurações complexas
Novos modos de acesso a dados para um processamento mais intuitivo dos resultados das consultas

A lista detalhada com as mudanças do EntLib 5 pode ser vista aqui.

Download e Documentação
Para fazer o download do EntLib 5 e/ou da documentação clique aqui.

Como criar um CustomTraceListener ?

2010-04-28T05:17:00.000-07:00

O EnterpriseLibrary, além de disponibilizar algumas formas padrão para log, nos permite criar uma customização do TraceListener.

Neste post vou mostrar como criar um CustomTraceListener para logar as informações.

Para modificar o modo com que sua classe gravará as informações basta modificar o método "WriteLine()" e/ou "Write()" inserindo o código para gravar em banco de dados, arquivo, Event Viewer, e-mail ou seja lá qual for sua vontade.

Criando o MyCustomTraceListener

Adicione uma nova classe chamada "MyCustomTraceListener" ao seu projeto.
Especifique que a classe deriva "CustomTraceListener".
Adicione o atributo de classe "ConfigurationElementType" . Especifique o tipo "CustomTraceListenerData" como o parâmetro de atributo.

[ConfigurationElementType(typeof(CustomTraceListenerData))]

public class MyCustomTraceListener : CustomTraceListener

Sobrescreva o método "TraceData" da classe "CustomTraceListener". Este método é que será chamado pelo EntLib na hora de realizar o trace nos objetos de log.

public override void TraceData(TraceEventCache eventCache, string source, TraceEventType eventType, int id, object data)

{

if (data is LogEntry && this.Formatter != null)

{

this.WriteLine(this.Formatter.Format(data as LogEntry));

}

else

{

this.WriteLine(data.ToString());

}

Sobrescreva os métodos "Write" e "WriteLine". Estes métodos serão chamados pelo seu TraceData, neles é que você deverá implementar o modo com que deseja salvar os logs de sua aplicação.

public override void Write(string message)

{

//implementação do modo de log

}

public override void WriteLine(string message)

{

//implementação do modo de log

}

Pronto, seu CustomTraceListener está criado. Para utilizá-lo basta adicionar este projeto a sua solução e depois criar um novo TraceListener, adicionando como Type o MyCustomTraceListener.

Como gerar uma SQLException manualmente ?

2010-04-19T07:47:00.000-07:00

Estava eu criando um projeto para testar um CustomTraceListener que grava um log no banco de dados de acordo com o tipo de exceção.
Com isso, precisei criar um método que gerasse uma SQLException.

Não é possível gerar uma SQLException manualmente em C#, pois a classe SQLException não possui um construtor público.

Mas nós podemos gerar esta exceção indiretamente, usando a função RAISEERROR do SQLServer.

Por Exemplo:

try

{

SqlCommand cmd =

new SqlCommand("raiserror('Manual SQLException', 16, 1)",objConnection);

cmd.ExecuteNonQuery();

}

catch (SqlException sqlEx)

{

string msg = sqlEx.Message; //msg = "Manual SQLException"

}

O código acima irá lançar uma SqlExpcetion mas o problema aqui é que demora um tempo de ida e volta ao banco de dados para executar a função RaiseError, porém, como estou usando somente para testes, o round trip, no meu caso, não é relevante.

Log com .NET Enterprise Library

2010-04-08T10:42:00.000-07:00

Uma solução de log para a plataforma .NET é o Logging Application Block, que pertence à Enterprise Library (também conhecido como EntLib).

Além dessa biblioteca facilitar o uso de log, ela gera saídas que podem ser direcionadas para vários destinos. Algumas das possibilidades são:

O log de eventos do Windows
Uma mensagem de e-mail
Um banco de dados
Uma fila de mensagem
Um arquivo texto
Um evento WMI

Para o código a maneira como a informação será logada fica transparente já que isso é configurado no App.config ou Web.config.

Os principais elementos configurados são:

Formatters: definem o formato do texto a ser logado;
Trace Listeners: definem o destino do log;
Category Sources: permitem classificar os Trace Listeners em categorias.

Para vermos algumas funcionalidades do Logging do EntLib vamos criar uma aplicação para 'logar' informações a respeito de erros em processos no log de eventos do Windows. Vamos criar uma categoria para os logs de erro nos processos chamada “MyErro”.

Essa categoria vai possuir um Trace Listeners para o log de eventos do Windows, para simplificar vamos incluir apenas um Trace Listener, mas é possível adicionar outros como, por exemplo, um para log em arquivos, em banco de dados entre outros.

Para isso:

No Visual Studio, crie um novo projeto do tipo Console Application.
No projeto, adicione um novo item do tipo Application Configuration File.
No Solution Explorer clique com o botão direito no App.config e selecione Edit Enterprise Library Configuration.

Na tela que abriu, clique com o botão direito no item correspondente ao App.config e selecione New > Logging Application Block para criar um novo nível na árvore chamado Logging Application Block.

Caso não exista nenhum sub item dentro do item "Formatters", clique com o botão direito em "Formatters" e escolha New > Text Formatter .

Na janela Properties mude o nome para “txtFormatterTeste” e clique no botão “…” do Template. No Template Editor, mude o texto para “{timestamp} {severity} – Erro no processo {processName}”. Agora temos um Formatter que irá gerar mensagens do tipo “08/04/2010 14:13:21 Error – Erro no processo umProcesso”, caso queira mais informações basta adicionar as demais tags. Por padrão, ao criar um Text Formatter a mensagem inicial contém todas as tags .

Crie um Trace Listener do tipo Formatted EventLog Trace Listener. Na janela Properties mude o seu Formatter para 'txtFormatterTeste'.

Em Category Sources clique com o botão direito e vá em New > Category e renomeie-a para “MyErro”.

Clique com o botão direito na categoria “MyErro” e vá em New > Trace Listener Reference. Altere ReferencedTraceListener para Formatted EventLog TraceListener criado por você.

Salve o arquivo App.config que você está editando.

No Solution Explorer, adicione uma referência ao componente .NET chamado “Enterprise Library Logging Application Block”.

Edite o código de sua classe para esse (cuide o namespace e o nome da classe):

using System;

using Microsoft.Practices.EnterpriseLibrary.Logging;

using System.Diagnostics;

namespace EntLibTeste

{

class Program

{

static void Main(string[] args)

{

LogEntry logEntry = new LogEntry();

logEntry.Severity = TraceEventType.Error;

logEntry.ProcessName = "umProcesso";

logEntry.Categories.Add("MyErro");

Logger.Write(logEntry);

}

Execute a classe e você deverá ver a mensagem esperada no arquivo de log assim como no Event Viewer, dentro de “Application Log”.

Para encontrar mais detalhes e outras informações sobre o Logging Application Block visite a página MSDN Enterprise Library - Logging .