Tag Archives: asp.net

[ASP.NET MVC] Iniciando con las plantillas ASP.NET Boilerplate

Hola a todos, una de los temas que más discusión tiene cuando se va a iniciar un proyecto Web es el tipo de aplicación que se va a desarrollar así como la arquitectura sobre la cual se va a construir la aplicación, luego de definir esos puntos comenzamos a crear una estructura básica de nuestra solución, donde generalmente creamos algunos proyectos que casi siempre vamos a utilizar, proyectos y/o componentes como la capa de presentación, el acceso a datos, la lógica de negocio, el dominio y algunos elementos transversales como seguridad, logging, etc.

Adicional a lo anterior, usualmente agregamos algunos componentes/herramientas en cada uno de los proyectos creados con los cuales vamos a trabajar ya sea porque son los que más conocemos, los que más nos gustan, el que esta de moda, en fin, podemos tener un sin fin de motivos para usarlos, algunos de esas herramientas pueden incluir un contenedor de de inyección de dependencias, una herramienta de log para los errores, algunas librerías/framework JavaScript entre otros.

Para solucionar el problema anterior, podemos trabajar con algo que se conoce como plantillas ASP.NET Boilerplate, el cual nos ofrece un marco de trabajo inicial que ya viene con varias características comunes necesarias en la mayoría de los proyectos, así entonces tenemos:

En el lado del servidor:

  • ASP.NET MVC
  • ASP.NET Web API
  • Castle Windsor
  • Log4Net
  • AutoMapper
  • ASP.NET Boilerplate

En el lado cliente:

  • Twitter Bootstrap
  • jQuery
  • jQueryUI
  • jQuery.Validation
  • jQuery.blockUI
  • jQuery.Spinjs
  • Moment.js
  • Modernizr
  • ASP.NET Boilerplate

boilerplate3

Para iniciar a trabajar, debemos ir a la página oficial ASP.NET Boilerplate y lo primero será escoger entre una aplicación de tipo SPA con Angularjs o con Durandaljs (depende lo que más te guste) y una clásica aplicación Web, luego viene la elección del ORM, acá es posible escoger entre Entity Framework o NHibernate, y finalmente el nombre del proyecto, una vez que hemos realizado esos tres sencillos pasos seleccionamos Create My Project:

boilerplate1

Una vez descargo el proyecto, al abrirlo desde Visual Studio vamos a encontrar una aplicación construida que contiene 5 proyectos:

boilerplate2

Y listo, ya tenemos un muy buen punto de partida sobre el cual seguir desarrollando nuestra aplicación, por el momento dejo el post hasta acá, sin embargo publicaré otro sobre como seguir trabajando con este template.

Espero les haya gustado y aprovechen está excelente herramienta, saludos.

[ASP.NET Web API] Routing por atributos en Web API 2

Hola a todos, aunque ya hace un buen tiempo que ha salido la versión 2 de Web API, una de las características que más me ha gustado es el nuevo tipo de routing que tenemos disponible conocido como routing por atributos (attribute routing), el cual básicamente permite definir el routing desde nuestros controladores, además que nos ayuda a solucionar problemas cotidianos que teníamos en versiones anteriores.

Partamos de un sencillo controlador como el siguiente:

public class CustomerController : ApiController
{
	readonly List<Customer> customers = new List<Customer>()
	{
		new Customer() { Id = 1, Name = "Walker", LastName = "Sosa" },
		new Customer() { Id = 2, Name = "Reese", LastName = "Todd" },
		new Customer() { Id = 3, Name = "Jason", LastName = "Woodward" },
		new Customer() { Id = 4, Name = "Samuel", LastName = "Cole" },
		new Customer() { Id = 5, Name = "Harding", LastName = "Mcgowan" }
	};

	public IEnumerable<Customer> Get()
	{
		return customers;
	}

	public Customer GetById(int id)
	{
		return customers.Where(c => c.Id == id).FirstOrDefault();
	}

	public Customer GetByName(string name)
	{
		return customers.Where(c => c.Name.ToLower().Contains(name.ToLower())).FirstOrDefault();
	}
}

Y la clase Customer

public class Customer
{
	public int Id { get; set; }

	public string Name { get; set; }

	public string LastName { get; set; }
}

Ahora si probamos el servicio, tenemos un problema si hacemos una petición del tipo <domain>/api/customer/sam:

routing

Para solucionarlo vamos a aprovechar el nuevo tipo de routing por atributos disponible desde Web API 2 y superior, lo primero entonces es habilitarlo, para ello añadimos la línea config.MapHttpAttributeRoutes(); en el archivo que defina nuestras rutas, generalmente en la carpeta App_Start, clase WebApiConfig, por lo tanto la clase ahora se ve:

public static void Register(HttpConfiguration config)
{
	config.MapHttpAttributeRoutes();

	config.Routes.MapHttpRoute(
		name: "DefaultApi",
		routeTemplate: "api/{controller}/{id}",
		defaults: new { id = RouteParameter.Optional }
	);
}

El siguiente paso es decorar nuestro controlador con el atributo RoutePrefixAttribute, en este caso [RoutePrefixAttribute(“api/customertask”)], este atributo permite definir un nombre diferente al nombre del controlador para ser utilizado:

[RoutePrefixAttribute("api/customertask")]
public class CustomerController : ApiController
{
	...
}

Para los métodos GetById y GetByName usamos el atributo Route:

[Route("{id:int}")]
public Customer GetById(int id)
{
	return customers.Where(c => c.Id == id).FirstOrDefault();
}

[Route("{name:alpha}")]
public Customer GetByName(string name)
{
	return customers.Where(c => c.Name.ToLower().Contains(name.ToLower())).FirstOrDefault();
}

Finalmente nuestro controlador quedaría:

[RoutePrefixAttribute("api/customertask")]
public class CustomerController : ApiController
{
	readonly List<Customer> customers = new List<Customer>()
	{
		new Customer() { Id = 1, Name = "Walker", LastName = "Sosa" },
		new Customer() { Id = 2, Name = "Reese", LastName = "Todd" },
		new Customer() { Id = 3, Name = "Jason", LastName = "Woodward" },
		new Customer() { Id = 4, Name = "Samuel", LastName = "Cole" },
		new Customer() { Id = 5, Name = "Harding", LastName = "Mcgowan" }
	};

	[Route("")]
	public IEnumerable<Customer> Get()
	{
		return customers;
	}

	[Route("{id:int}")]
	public Customer GetById(int id)
	{
		return customers.Where(c => c.Id == id).FirstOrDefault();
	}

	[Route("{name:alpha}")]
	public Customer GetByName(string name)
	{
		return customers.Where(c => c.Name.ToLower().Contains(name.ToLower())).FirstOrDefault();
	}
}

Luego de los cambios, las siguientes llamados funcionan sin problema:

  • http://<domain>/api/customertask -> Método Get()
  • http://<domain>/api/customertask/2 -> Método GetById(int id)
  • http://<domain>/api/customertask/sam -> Método GetByName(string name)

Si quieren profundizar en el tema les recomiendo el siguiente link: Attribute Routing in Web API 2

Espero les sea de utilidad, saludos!

[ASP.NET] Subiendo archivos a un blob storage con RadCloudUpload

Hola a todos, actualmente es muy común que en las aplicaciones Web el cargue de archivos se haga a un storage en la nube, y generalmente es necesario crear todo el código para implementar dicha funcionalidad, sin embargo Telerik nos hace la vida más sencilla ya que en su gama de controles ahora disponemos de RadCloudUpload, control que en esencia nos permite realizar la subida de un archivo a un storage en la nube (Azure, Amazon S3 y Telerik Backend Services).

Pues bien, su implementación es bastante sencilla y la vamos a realizarm para cargar archivos a un blob storage de Microsoft Azure, una vez añadimos el control, como es costumbre tenemos algunas opciones para comenzar su parametrización como:

  • Tamaño del archivo
  • Proveedor del storage
  • Extensiones permitidas
  • Posibilidad de subir múltiples archivos
  • Skin

cloudupload1

Como hemos seleccionado en el proveedor Azure, se habilita un wizard para ingresar los datos del storage:

cloudupload3

No olvides agregar por Nuget el paquete Windows Azure Storage:

cloudupload2

Y listo, ya es solo probar, una vista previa del control funcionando:

cloudupload4

Si luego requieren cambiar los datos del storage, todos los datos se han replicado en el web.config:

<telerik.web.ui>
	<radCloudUpload>
	  <storageProviders>
		<add name="Azure" type="Telerik.Web.UI.AzureProvider" 
			 accountKey="681o+9PweN+2k....." 
			 accountName="demomvcsignalr" 
			 blobContainer="democloudupload" 
			 ensureContainer="true" 
			 uncommitedFilesExpirationPeriod="1" 
			 defaultEndpointsProtocol="" />
	  </storageProviders>
	</radCloudUpload>
</telerik.web.ui>

Saludos!

[ASP.NET] Integrando ASP.NET con Telerik ASP.NET AJAX

Hola a todos, muchos sabrán de mi gusto por los controles y herramientas de Telerik, así que quiero comenzar a compartir regularmente post sobre sus productos. En esta ocasión vamos a ver cómo es de sencillo integrar los controles ASP.NET AJAX en una aplicación nueva de tipo Web Forms, tarea que Telerik nos pone bastante fácil (con un wizard :)).

Una vez ya tienes instalados los controles, y te recomiendo utilices el Telerik Control Panel (luego hablamos hablaremos de él), tenemos un template que nos va a llevar paso a paso:

Primero seleccionamos el template Telerik Web Application:

telerik 1

Luego se abre un wizard en donde podemos configurar algunas partes importantes del proyecto, iniciando con el tema a utilizar y si se desea agregar una referencia de los assemblies a la solución:

telerik 2

En el siguiente paso es posible establecer algunas opciones, como por ejemplo si usar CDN entre otras:

telerik 3

Luego si queremos tener soporte para jQuery y templates:

telerik 4

Y finalmente si queremos usar Telerik Data Access, el ORM de Telerik (que la verdad va bastante bien):

telerik 5

Y listo, ya solo queda usar y aprovechar la potencia de los controles!

Saludos!

[ASP.NET MVC] Soporte para enumeraciones en ASP.NET MVC 5.1

Hola a todos, uno de las características que le hacia falta a ASP.NET MVC era el soporte nativo para trabajar con enumeraciones, sin embargo ya en la versión 5.1 (ojo que todavía es RC) ya se dispone de un helper dedicado para trabajar con enumeraciones, así que vamos a verlo (Revisa más características en este link).

Lo primero que debes hacer es descargar e instalar el update Visual Studio 2013 Update 1 RC, una vez instalado creamos un nuevo proyecto y añadimos el paquete Microsoft ASP.NET MVC, como todavía no es oficial asegúrate de seleccionar Include Prerelease:

enums

O bien por el Package Manager Console con: Install-Package Microsoft.AspNet.Mvc -Version 5.1.0-rc1 –Pre

Ahora, vamos a crear una enumeración que va a manejar los tipos de clientes:

public enum ClientType
{ 
	Free = 0,
	VIP = 1,
	Gold = 2,
	Platinum = 3
}

Y un modelo:

public class Client
{
	public int ClientId { get; set; }

	public string Name { get; set; }

	public ClientType ClientType { get; set; }
}

Ahora creamos un controlador, para el ejemplo solo voy a crear las acciones para crear (no te fijes si crea o no, porque no lo hace):

public class ClientController : Controller
{
	// GET: /Client/Create
	public ActionResult Create()
	{
		return View();
	}

	 // POST: /Client/Create
	[HttpPost]
	public ActionResult Create(Client client)
	{
		ViewBag.type = client.ClientType;
		return View();
	} 
}

Y finalmente la vista:

@model Enums.Models.Client

@{
    ViewBag.Title = &quot;Create&quot;;
}

&lt;h2&gt;Create&lt;/h2&gt;

@using (Html.BeginForm()) 
{
    @Html.AntiForgeryToken()
    
    &lt;div class=&quot;form-horizontal&quot;&gt;
        &lt;h4&gt;Client&lt;/h4&gt;
        &lt;hr /&gt;
        @Html.ValidationSummary(true)

        &lt;div class=&quot;form-group&quot;&gt;
            @Html.LabelFor(model =&gt; model.Name, new { @class = &quot;control-label col-md-2&quot; })
            &lt;div class=&quot;col-md-10&quot;&gt;
                @Html.EditorFor(model =&gt; model.Name)
                @Html.ValidationMessageFor(model =&gt; model.Name)
            &lt;/div&gt;
        &lt;/div&gt;

        &lt;div class=&quot;form-group&quot;&gt;
            @Html.LabelFor(model =&gt; model.ClientType, new { @class = &quot;control-label col-md-2&quot; })
            &lt;div class=&quot;col-md-10&quot;&gt;
                @Html.EnumDropDownListFor(model =&gt; model.ClientType)
                @Html.ValidationMessageFor(model =&gt; model.ClientType)
            &lt;/div&gt;
        &lt;/div&gt;

        &lt;div class=&quot;form-group&quot;&gt;
            &lt;div class=&quot;col-md-offset-2 col-md-10&quot;&gt;
                &lt;input type=&quot;submit&quot; value=&quot;Create&quot; class=&quot;btn btn-default&quot; /&gt;
            &lt;/div&gt;
        &lt;/div&gt;
    &lt;/div&gt;
}

Ahora al probar la aplicación, se genera correctamente una lista con las opciones de la enumeración:

client

Y si damos click en Create y revisamos lo que pasa en la acción Create, observamos que el valor seleccionado se mapea correctamente con la propiedad del modelo:

modelo

Espero el post les sea interesante, saludos!

[ASP.NET Web API] Web API VIII – Trabajando con los ActionName

Hola a todos, volviendo con la serie sobre ASP.NET Web API, en esta oportunidad quiero mostrarles como podemos personalizar el nombre de las acciones y además poder tener dos o más métodos que trabajen con el mismo verbo HTTP y una misma firma.

Para personalizar el nombre de las acciones, es necesario decorar cada acción con el atributo ActionName y especificar el nombre que deseamos utilizar:

[ActionName(&quot;nombre_de_la_acción&quot;)]

Para nuestro ejemplo vamos a crear una nueva acción con el nombre GetPersonByOtherId(Int32 id), dicha acción obedece al verbo Http Get y tiene la misma firma que la acción GetPerson, adicionalmente decoramos las acciones con el atributo ActionName y le asignamos un nombre (si en este caso la lógica de cada acción es la misma):

[ActionName(&quot;getbyid&quot;)]
public Person GetPerson(Int32 id)
{
	Person person = db.Person.Find(id);
	if (person == null)
	{
	   throw new HttpResponseException(Request.CreateResponse(HttpStatusCode.NotFound));
	}

	return person;
}

[ActionName(&quot;getbyotherid&quot;)]
public Person GetPersonByOtherId(Int32 id)
{
	Person person = db.Person.Find(id);
	if (person == null)
	{
		throw new HttpResponseException(Request.CreateResponse(HttpStatusCode.NotFound));
	}

	return person;
}

Adicionalmente agregamos un nuevo elemento en nuestro HTML:

&lt;input id=&quot;btnSearch2&quot; type=&quot;button&quot; value=&quot;Search by Other Id&quot; data-bind=&quot;click:getPersonByOtherId&quot; /&gt;

Ahora modificamos el ViewModel y agregamos la función getPersonById, así como en la función getPersonById hacemos un pequeño cambio a la url que se esta llamando, en este caso agregando el nombre de la acción:

...
self.getPersonById= function () {
	var url = '/api/person/getbyid/' + self.id();
	$.getJSON(url)
		.done(function (data) {
			self.name(data.Name);
			self.lastname(data.LastName);
			self.twitter(data.Twitter);
		})
		.fail(function (erro) {
			self.clearForm();
	});
},

self.getPersonByOtherId = function () {
	var url = '/api/person/getbyotherid/' + self.id();
	$.getJSON(url)
		.done(function (data) {
			self.name(data.Name);
			self.lastname(data.LastName);
			self.twitter(data.Twitter);
		})
		.fail(function (erro) {
			self.clearForm();
		});
},
...

Luego es necesario agregar una nueva ruta en la tabla de routing, en este caso en la clase WebApiConfig:

config.Routes.MapHttpRoute(
	name: &quot;ApiByOtherId&quot;,
	routeTemplate: &quot;api/{controller}/{action}/{id}&quot;,
	defaults: new { id = RouteParameter.Optional }
);

Y ahora si ejecutamos y probamos podemos ver como en efecto los ActionName funcionan correctamente:

ActionName

Espero el post les haya gustado, hasta el próximo!

Descarga el ejemplo!

[ASP.NET] Como obtener el Gravatar del usuario

Hola a todos, en los próximos post que serán cortos quiero mostrar algunas pequeñas funcionalidades que nos ayudarán a realizar pequeñas mejoras a nuestras aplicaciones y/o implementar funcionalidades muy especificas a nuestros desarrollos.

En este post vamos a revisar como usando la dirección de correo electrónico obtenemos el Gravatar del usuario, primero que todo si alguno no lo sabe el Gravatar es una imagen que podemos utilizar en algunas páginas Web, más info: Gravatar.

Ya entrando en materia lo primero es tener un muy sencillo formulario con una caja de texto para ingresar el email y un botón para obtener el Gravatar:

&lt;h1&gt;Gravatar&lt;/h1&gt;
&lt;hr /&gt;
&lt;asp:Label ID=&quot;lblEmail&quot; runat=&quot;server&quot; Text=&quot;Email:&quot;&gt;&lt;/asp:Label&gt;
&lt;asp:TextBox ID=&quot;txtEmail&quot; runat=&quot;server&quot; Width=&quot;250px&quot;&gt;&lt;/asp:TextBox&gt;
&lt;asp:Button ID=&quot;btnGetGravatar&quot; runat=&quot;server&quot; OnClick=&quot;BtnGetGravatarClick&quot; Text=&quot;Get Gravatar&quot; /&gt;
&lt;br /&gt;
&lt;asp:Image ID=&quot;imgGravatar&quot; runat=&quot;server&quot; /&gt;

Luego necesitamos añadir el paquete ASP.NET Web Helpers Library utilizando Nuget:

image

Y finalmente en el evento click del botón:

protected void BtnGetGravatarClick(object sender, EventArgs e)
{
	if (!string.IsNullOrEmpty(txtEmail.Text))
	{
		var gravatar = Microsoft.Web.Helpers.Gravatar.GetUrl(txtEmail.Text);
		imgGravatar.ImageUrl = gravatar;
	}
}

Si probamos e ingresamos un correo, en este caso he ingresado el mío tenemos:

image

Espero les sea de utilidad, les dejo el ejemplo, saludos!

Descarga el ejemplo!

[ASP.NET Web API] Filtros de validación

Realmente ando muy contento trabajando con Web API, sobretodo por su facilidad de uso, sin embargo, unos de los puntos que debemos tener presente cuando creando servicios REST con Web API es la seguridad y la creación de filtros para no exponer sin consideración las acciones de nuestros servicios, para solucionar dicho problema es posible crear filtros y realizar todas esas validaciones necesarias.

Los filtros pueden ser aplicados en diferentes niveles:

  • A nivel de clase
  • A nivel de acción
  • A nivel global

Para crear un filtro, se debe crear una clase que herede de ActionFilterAttribute y luego sobrescribir el método OnActionExecuting, para ver el tema en acción crearemos un filtro para validar que el dominio del cual están realizando la petición sea conocido, por lo tanto creamos la clase FilterDomainAttribute:

public class FilterDomainAttribute : ActionFilterAttribute
{
	public override void OnActionExecuting(System.Web.Http.Controllers.HttpActionContext actionContext)
	{
		var domain = &quot;dominio&quot;;
		if (!string.Equals(actionContext.Request.RequestUri.Host, domain, StringComparison.OrdinalIgnoreCase))
		{
			actionContext.Response = new HttpResponseMessage(HttpStatusCode.Unauthorized)
				{
					Content = new StringContent(&quot;Petición no autorizada&quot;)
				};
		}
	}
}

Entonces, creamos la clase FilterDomainAttribute la cual hereda de ActionFilterAttribute, luego hacemos un override al método OnActionExecuting y allí lo que hacemos es obtener el dominio con actionContext.Request.RequestUri.Host y se compara en este caso con el valor de la variable domain, en caso de no ser un dominio válido retornamos el mensaje “Petición no autorizada” con el estado de no autorizado HttpStatusCode.Unauthorized.

Ahora, creamos un controller (muy sencillo) para el manejo de clientes, entonces la clase Client:

public class Client
{
	public int ClientId { get; set; }
	public string Name { get; set; }
	public string Twitter { get; set; }
}

Y el controlador:

public class ClientController : ApiController
{
	private readonly IEnumerable&lt;Client&gt; clients = new List&lt;Client&gt;() {
		new Client (){ ClientId = 1, Name = &quot;Julio&quot;, Twitter = &quot;@julitogtu&quot;},
		new Client (){ ClientId = 2, Name = &quot;Juan&quot;, Twitter = &quot;@JuanKRuiz&quot;},
		new Client (){ ClientId = 3, Name = &quot;Nicolas&quot;, Twitter = &quot;@nicolocodev&quot;},

	};

	public IEnumerable&lt;Client&gt; GetAll()
	{
		return clients;
	}

	public Client GetById(int id)
	{
		return new Client() { ClientId = 1, Name = &quot;Julio&quot;, Twitter = &quot;@julitogtu&quot; };
	}
}

Para utilizar el filtro a nivel de clase o a nivel de acción lo único que se debe utilizar es decorar bien sea la clase o la acción con el atributo creado (no olvidar referenciar el namespace ActionFilter.Filter):

[FilterDomain]
public class ClientController : ApiController

[FilterDomain]
public IEnumerable GetAll()

Algo interesante es que es posible escribir solo FilterDomain, y recuerden que el nombre de la clase es FilterDomainAttribute.

Y ahora, si se quiere aplicar el filtro a nivel global se debe ir al global.asax y definirlo en el Application_Start:

GlobalConfiguration.Configuration.Filters.Add(new FilterDomainAttribute());

Si quieren ver otros ejemplos relacionados les recomiendo dos post del master Gonzalo:

Les dejo el código del ejemplo: Descarga el ejemplo!

Saludos!

1 2 3 8