No habrán posts por un tiempo :(

Hola a todos, por estos días no voy a poder publicar nuevos artículos en el blog dado a que me he cambiado de casa (para los jugadores de Halo, osea tengo un nuevo mapa) y hasta que hagan las conexiones de Internet en el nuevo edificio podría tomar algún tiempo. Así que los nuevos visitantes los invito a leer los posts anteriores, y a los viejos aprovechen y pongan sus comentarios jeje.

Sandcastle, genera y presenta la documentación XML de tu código.

 

En estos días he estado trabajando parcialmente en un proyecto de desarrollo de una API para un CMS, de tal forma que podamos extender y automatizar ciertas funcionalidades desde aplicaciones .Net como ASP.NET, Silverlight o Windows Client.

Como una forma de ayudarme a organizar el código y a cualquiera que use mi código, agregué comentarios XML a mis clases en C#, tratando de poner la descripción de los métodos al estilo de las clases de .Net. Esta interesante característica de documentación ofrece ayuda contextual en línea cuando alguien usa un método dentro de Visual Studio  (a manera de tool tips). El compilador de C# es capaz de extraer estos comentarios y generar un archivo XML usado por Visual Studio, pero también puede ser usado por otras aplicaciones como el caso de Sandcastle que se encarga de leer este tipo de archivos XML y aplicar reflexión al proyecto relacionado para extraer metadatos adicionales para generar una documentación completa al estilo MSDN.

Sandcastle es de Microsoft, gratis y de código abierto, pueden descargarlo desde el sitio en CodePlex. Adicionalmente les recomiendo descargar el Sandcastle Help File Builder que es la interfaz gráfica para la aplicación Sandcastle. Su forma de uso es simple y al estilo del extrañado NDoc, les dejo algunas capturas de pantalla de esta herramienta y cómo se ve la documentación generada:

¿Cómo comentar nuestro código?

 

/* ******************************************************

Este post trata de un tema muy importante que muchas veces pasamos por alto los programadores, el poner comentarios a nuestro código. Ya sea para nosotros o para otro que le toque la tarea de mantener nuestros programas, es de suma importancia y ayuda el agregar los comentarios lo suficientemente explicativos para entender lo que hace un método en particular, mmmm….No, ya en serio esto se trata de los mejores comentarios con los que me he topado el día de hoy domingo, la lista original y completa la pueden encontrar en StackOverflow.com , un ejemplo:

//
// Dear maintainer:
//
// Once you are done trying to ‘optimize’ this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
//
// total_hours_wasted_here = 16
//

Traducción

//
// Estimado desafortunado:
//
// Una vez que hayas terminado de intentar optimizar esta rutina,
// y te hayas dado cuenta el terrible error que fue,
// por favor incrementa el siguiente contador como advertencia
// para el siguiente tipo:
//
// total_horas_desperdiciadas_aquí = 16
//

NOTA: Todos los comentarios citados aquí son propiedad de sus respectivos programadores.

****************************************************** */

// TODO: Ingrese su comentario luego de esta línea.

ASP.NET MVC eBook Gratis

 

Más buenas noticias de ASP.NET MVC !!. Scott Guthrie nos trae este eBook con un tutorial que cubre el desarrollo de NerdDinner, una aplicación ASP.NET MVC. Es un excelente material para aprender más de este tema y punto de referencia sobre la arquitectura de las aplicaciones.

<< Descargar el libro

A primer vistazo se explica brevemente un poco de la estructura de proyectos en MVC, y luego manos a la obra, código, código y más código!!.

Algo además interesante de mencionar es que el eBook se distribuye bajo la licencia Creative Commons.

Este fin de semana será el momento para darle una buena leída y empezar a escribir código, tocará darle descanso al Halo3 este fin de semana. Thanks Scott !.

Otros enlaces recomendados sobre material relacionado a ASP.NET MVC:

1. http://www.asp.net/learn/mvc/#MVC_Overview
2. http://aspnet.codeplex.com/Wiki/View.aspx?title=MVC&referringTitle=Home

Quiero uno de estos !

iPod Touch de 16GB !!.

Tengo entre ceja y ceja este juguetito, estoy esperando que salga la nueva versión (estimo que por septiembre). Entre las características que me hacen optar por el iPod Touch están:

1. Cliente de correo.
2. Cliente de IM
3. Navegador Web
4. Reproduce video
5. Música + Genius
6. Fotos
7. Abrir PDFs
8. WiFi

Para los que piensen que mejor debería comprar un iPhone, y no es que le haga mala cara al teléfono de la manzana, PERO en temas de celulares prefiero mas pequeños, que puedan ser lanzados al suelo, rayados, robados, llevados a todo lado en el bolsillo junto con los sueltos.

Nuevo sitio Web de Oshyn, Inc.

No hace mucho acabamos de lanzamos nuestro nuevo sitio Web (Oshyn, Inc.), un importante rediseño visual con un estilo más moderno,  nuevo contenido y mayor información de interés para clientes y la comunidad. Los invito a que lo conozcan:

http://www.oshyn.com

Ya está disponible ASP.NET MVC

Finalmente fue liberada hace pocos días la versión final de ASP.NET MVC la cual pueden descargar desde la página de ASP.NET MVC:

http://www.asp.net/mvc/

Ya lo tengo instalado y la probaré en los siguientes días, antes había trabajado con otro patrón de diseño: el MVP que me pareció muy bueno; ahora voy a probar el ASP.NET MVC a ver que tal, hay buenos ejemplos, videos y documentación en la página oficial.

De MVC puedo decir que facilita mucho el tema de SEO (Search Engine Optimization) para tener URLs “amigables” y mas control en la parte del front-end.

¿Problemas al instalar SQL Server 2008 ?

El día de hoy descargué la versión Express de SQL Server 2008, pero al momento de la instalación esta terminaba con un error, el link de soporte indicaba que debía remover el SQL Native Client e intentarlo nuevamente, así que fui a la ventana de “Agregar o Quitar Programas” lo removí, intenté nuevamente la instalación y… error otra vez, el mismo mensaje. Hmmm.. dando una vistazo al LOG de instalación, este indicaba que el problema estaba realmente en el componente MSXML 6, regresé a “Agregar o Quitar Programas” para intentar remover el MSXML6 SP2, pero recibía otro mensaje de error que imposibilitaba quitarlo.

Buscando un poco por Internet, encontré la solución, resulta que con Windows XP Sp3 el SMXML6 SP2 se bloquea y no se puede remover, cuando SQL Server 2008 intenta instalar la versión anterior incluida en el instalador, se genera el error descrito anteriormente. La solución fue descargar “Windows Installer Clean Up” y remover el MSXML SP2, luego volver a instalar SQL Server 2008 y listo, la instalación fue exitosa.

Si tienen un ambiente con Windows XP SP3 y están con problemas similares de instalación de SQL Server 2008, prueben lo que les cuento, les podría solucionar su problema.

Tutorial Gráfico Silverlight: Consumiendo Servicios

 

En este tutorial veremos algunas cómo desarrollar un servicio sencillo y consumirlo desde una aplicación Silverlight 2, además usaremos el control DataGrid y el Popup control.

En el siguiente tutorial se mostrarán los pasos generales e importantes para crear un servicio WCF, crear una aplicación Silverlight 2 y consumir el servicio. Al final se provee un enlace al proyecto con el código fuente para que se lo descarguen y lo revisen a mayor detalle.

Requisitos:

• Visual Studio 2008 SP1
• Expression Blend 2
• Silverlight Tools para Visual Studio 2008
• Soliverlight Toolkit Marzo 2009

 

Paso 1: Crear un Servicio para Silverlight

Partiendo de una solución vacía, creamos un nuevo proyecto tipo ASP.NET Web Service, borramos el servicio que VS2008 crea de forma automática y agregamos un nuevo elemento tipo “Silverlight-enabled WCF Service” que llamaremos SimpleService.svc como se ve en la siguiente  figura:

Esto creará la siguiente plantilla para escribir nuestro servicio:

Nuestro leerá datos de un archivo XML y tendrá dos métodos, uno que retorne la lista completa de usuarios y otro que retorne un usuario en particular.

Al proyecto agregamos un nuevo archivo XML con los siguientes datos:

Y luego creamos una nueva clase para representar cada usuario:

Finalmente, escribimos el código complete del servicio:

Ejecutamos el proyecto y se nos deberá presentar la siguiente pantalla indicando que nuestro servicio está levantado.

 

Paso 2: Crear una nueva aplicación Silverlight

Agregamos un nuevo proyecto a la solución, de tipo “Silverlight Application” a la que llamaremos MySilverlightApp.

 

El asistente de VS2008 nos preguntará si deseamos crear una aplicación Web para hospedar y probar nuestra aplicación y presionamos OK:

Hasta este punto nuestra solución se verá algo así:

Usando Blend 2 o VS008 editamos el archivo Page.xaml para crear la interfaz gráfica de nuestra aplicación que estará formada por una caja de texto, dos botones y un Grid (Disponible en el Silverlight Toolkit Mazo 2009)

 

Desde VS2008 procedemos a enlazar los eventos Click de ambos botones al código en C#, esto se hace de forma sencilla desde VS2008:

 

Paso 3: Consumir el Servicio

Lo siguiente será agregar una referencia al servicio y escribir el código para consultar los datos. Para agregar la referencia al servicio damos clic derecho sobre la solución y seleccionamos “Add Service Reference”, del cuadro de dialogo seleccionamos nuestro servicio y presionamos aceptar:

Algo interesante es que en Silverlight todos los servicios son asincrónicos, de tal forma que en nuestro código tendremos que manejar los eventos de cuando se termine de ejecutar una operación, El código fuente de page.xaml.cs quedaría así:

 

Ejecutamos nuestra aplicación y se verá algo así:

Pero al presionar el botón “Find All” recibiremos una EXCEPCION al tratar de conectar con el servicio Web:

Esta se debe a un tema de seguridad de comunicación entre dominios, la forma de resolver esto es muy simple, se agrega un archivo XML en la raíz del servicio Web con las políticas de acceso para los clientes, el archivo se llama clientaccesspolicy.xml y tendrá el siguiente contenido:

Volvemos a probar nuestra aplicación y listo:

Hemos creado una aplicación en Silverlight que consume un servicio WCF y hemos configurado las políticas de acceso del cliente al servicio.

 

El proyecto completo lo pueden descargar desde aquí.

Nuevos navegadores: Safari 4 y Explorer 8

 

Hace poco Apple y Microsoft anunciaron las nuevas versiones de sus navegadores: Safari 4 de la compañía de la manzana (todavía en beta)  e Internet Explorer 8 de Microsoft (versión final liberada hace unos pocos días). Ambos cargados de nuevas características útiles tanto para desarrolladores como para los usuarios finales.

 

Con Internet Explorer 8 se anuncia básicamente los mismo que en las versiones anteriores: más seguro y más rápido, con modificaciones visuales mínimas, Live Search como motor de búsqueda predeterminado (el cuál ya cambié a Google), algo nuevo en IE que MS llama aceleradores, y la herramienta para desarrolladores que posibilita ver, analizar y editar el código fuente de una página. Para una lista completa de las características pueden visitar la página oficial de IE8.

Entre las principales mejoras a Safari 4 tenemos la incorporación de Cover Flow, la barra de pestañas se ha movido a la parte superior de la ventana, algo nuevo llamado Top Sites (un poco similar al Speed Dial de opera), y también incluye herramientas para el desarrollador. Más información en la página oficial de Safari.

 

Estadísticas sobre cuál es más rápido y otro tipo de comparaciones hay por todos lados, este post se centra más en mostrarles algo de lo nuevo que trae cada uno, así que tendremos muchas capturas de pantalla !!

 

Safari 4 – Top Sites. Nos muestra los sitios más visitados, aparece cada vez que abrimos un nuevo tab, por otro lado IE8 muestra una ventana simple con accesos directos a algunas funciones, pero con IE podemos ver vistas previas de las ventanas abiertas.

 

Se puede ver como en IE se agrupan por colores ventanas abiertas en secuencia desde una página.

 

IE8  – Aceleradores. Aparecen en un menú contextual cada vez que seleccionamos texto de una página, por ejemplo buscar en Google el texto marcado. Algo similar existe en Safari, pero IE8 tiene la posibilidad de agregar más aceleradores.

Herramientas para el desarrollador. Ambos navegadores incorporan herramientas similares a Firebug para Firefox que han probado ser muy útiles. En la siguiente captura podemos ver los navegadores lado a lado con la herramienta para desarrolladores. Además podemos notar como Apple siempre busca ofrecer una mayor área visual para el contenido mientras que en IE todas las barras de herramientas usan una buena parte de la ventana, en la imagen tuve que ocultar la barra de menú en IE8.

 

 

Cover Flow y más Cover Flow. Apple lo ha incorporado también en Safari 4. Lo podemos aprovechar cuando navegamos por los Favoritos o el Historial:

 

Apple  por primera vez aplicará el mismo “Look & Feel” a Safari 4 para la versión Windows, de esa forma se verá más integrado al estilo visual de Windows.

Esperemos que IE al ser el navegador más usado (no por elección – opinión personal), el IE8 8 no se convierta en un nuevo dolor de cabeza para los desarrolladores, ya que con cada nueva versión de IE le dan vuelta a la tortilla y eso que siempre dicen que hace uso de “estándares”, lo digo porque como han incorporado un “Modo Compatibilidad” para emular IE7 entonces probablemente los sitios que se veían “bien” con IE7 no se garantiza que sigan de esa misma forma con IE8. Eso es decisión de cada uno de nosotros el elegir cuál nos parezca mejor y cuál sigue un mejor camino.