[ASP.NET] Crear y Publicar - Web Service (1/3)

 

Introducción

---

Un problema que se presenta regularmente luego de terminado el desarrollo de un proyecto web esta relacionado con la publicación y puesta en marca en un ambiente productivo, la idea del articulo será la de marcar los pasos para la creación y puesta en producción de un servicio web, así como también una página aspx, como veremos tratar un servicio o una pagina requieren los mismo pasos.

Se podría considerarse un servicio web (asmx) como una paginas aspx solo que sin una interfaz visual que se desplegué al usuario, los servicio permitirán que otras aplicaciones recuperen información publicada por medio de un protocolo conocido como es el http

En esta primera parte se analizaran:

• Crea un proyecto asp.net
• Agregar un web service al desarrollo web
• Consumir web service
• Actualizar configuración servicio

El ejemplo en el cual se basara la demostración consiste solo una lista de cursos que se obtiene de una base de datos. Como la publicación de un servicio es idéntica a la de una pagina web aprovecharemos el articulo para contemplar ambos escenarios.

 

Crear proyecto web

---

El primer paso será la creación del proyecto web

Es importante usar la opción que sea un Web Application

La estructura del proyecto del ejemplo incluye una db en carpeta de datos

Al ejecutar la pagina que lista los cursos se visualizara en el browser el resultado

Como es un ejemplo simple solo se hizo uso de un gridview junto a la ayuda de Entity Framework para resolver el acceso a datos

Por supuesto hasta ahora se hace uso del Visual Studio Developer Server, el cual es muy útil cuando se esta desarrollando, pero solo en esta etapa luego debe publicarse en el IIS

El Visual Studio creara por nosotros un server virtual en el puerto indicado en la configuración

 

Crear Servicio web

---

El próximo paso involucra la creación del servicio web, para ello agregaremos un nuevo ítem al proyecto web creado en el paso anterior

 

En el servicio se define un webmethod que liste los cursos

 

[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[System.ComponentModel.ToolboxItem(false)]
public class SchoolService : System.Web.Services.WebService
{

    [WebMethod]
    public List<CurseDTO> GetCurseList()
    {
        using (SchoolEntities context = new SchoolEntities())
        {
            return (from curse in context.Course
                   select new CurseDTO()
                   {
                       CurseId = curse.CourseID,
                       Title = curse.Title,
                       Department = curse.Department.Name
                   }).ToList();
        }
    }
}

public class CurseDTO
{
    public int CurseId {get; set;}
    public string Title { get; set; }
    public string Department {get; set;}
}

Si queremos ver la pantalla de inicio del servicio para validar que este correcto, solo será cuestión de navegarlo en el browser

Y hasta se puede invocar desde allí mismo

 

Consumir servicio web

---

Para consumir un servicio desde una aplicación cliente se agrega una referencia que creara el proxy, el cual no es mas que código para facilitar la invocación al servicio

En este caso como el servicio esta en la misma solución se descubre de forma directa, sino será necesario definir la url donde se publico el servicio

Si bien a simple vista pareciera que la referencia al servicio no hizo mucho

Si se habilita la opción superior de la barra del solution explorer se podrá descubrir mucho

La referencia al servicio crea código por nosotros, además de definir una sección en el app.config, en el cual se podrá cambiar la url sin necesidad de recompilar luego de hacer la implementación definitiva del servicio en el IIS

Consumir el servicio desde código solo implica crear la instancia del proxy para luego hacer uso del método definido

using School.UI.SchoolSvc;
.
.

CurseDTO[] curseList;
using (SchoolServiceSoapClient svc = new SchoolServiceSoapClient())
{
    curseList = svc.GetCurseList();
}

dgvCourse.DataSource = curseList;

Con esto alcanza para invocar al servicio que hostea el server virtual que crea el VS y cargar el grid con la misma lista que al principio mostramos en la pagina web

Algo que seguramente habrán notado en el código seguro se relaciona con la respuesta del web method, como puede ser que devuelve un array de entidades cuando el código del servicio deja bien claro que era una lista, bien eso se debe a como se configura la referencia, pero puede cambiarse si hace falta.

Y se define el tipo de dato para que sea una lista

Al recompilar el proyecto el código que genera la referencia al servicio también devuelve una lista.

Código

---

El ejemplo del código fue creado con Visual Studio 2008 y Sql Server Express 2008 R2

[C#]