PDF de programación - Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

Desarrollo de un servicio web para el envío de correos utilizando
C# y su correspondiente cliente consumidor utilizando Java

Versión 0.1

Jorge Iván Meza Martínez
http://www.jorgeivanmeza.com/
<[email protected]>

2008

http://www.jorgeivanmeza.com/ - 1

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

Introducción

Este documento describe como desarrollar un servicio web muy simple para el envío de correos
electrónicos en el lenguaje de programación C# utilizando la herramientas de programación gratuita
Visual Web Development Express en su versión 2008. De igual manera se describe como desarrollar
un cliente que consuma este servicio web en el lenguaje de programación Java utilizando la
herramienta de programación gratuita NetBeans en su versión 6,0,1.

El desarrollo de este software tiene fines académicos únicamente y no se espera que supla algún tipo
de necesidad o que sea útil para ser utilizado en servidores en producción. No se toman ningún
tipo de medidas de seguridad ni se contempla la utilización de servidores SMTP que requieran
autenticación.

Desarrollo del servicio web utlizando C#.

Para el desarrollo del servicio web se utilizará Visual Web Developer Express en su versión 2008 el
cual puede ser descargado gratuitamente de la siguiente dirección.

http://www.microsoft.com/express/

Se inicia el ambiente de desarrollo haciendo click sobre su correspondiente ícono en el escritorio, el
cual se puede encontrar también a través del Menú de Inicio > Todos los programas > Microsoft
Visual Web Developer 2008 Express.

Se inicia un nuevo proyecto seleccionando el menú File > New Website o de manera alternativa
presionando las teclas Mayúsculas+Alt+N.

http://www.jorgeivanmeza.com/ - 2

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

Se especifican las siguientes opciones en el díalogo de creación de sitios web.

Template: ASP.NET Web Service.
Location: File System = G:\Proyectos\WS_Taller\servicio.
Language: Visual C#.

Presione el botón OK para aceptar los valores anteriores.

Téngase en cuenta que con los valores anteriores los archivos del proyecto se van a crear en la
ruta especificada y utilizando el lenguaje de programación C#.NET. Personalice estas opciones según
sus requerimientos.

http://www.jorgeivanmeza.com/ - 3

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

En el Solution Explorer abra el archivo Service.asmx haciendo doble click izquierdo sobre él o
haciendo click derecho sobre él y eligiendo la opción Open.

Modifique el valor Class a MailService el cual es el servicio web que estamos implementando.

<%@ WebService Language="C#" CodeBehind="~/App_Code/Service.cs" Class="MailService" %>

Repita el proceso anterior abriendo ahora el archivo Service.cs que se encuentar bajo la rama
App_Code del Solution Explorer. Realice las siguientes modificaciones al código.

Agregue una referencia al namespace Net.Mail al comienzo del código.

using System.Net.Mail;

Modifique el nombre de la clase y del constructor a MailService.

// ...
public class MailService : System.Web.Services.WebService
{
public MailService ()
{
}
// ...

Agregue la implementación del método send como web service para enviar el correo electrónico con el
siguiente contenido.

[WebMethod]
public string send(string fromUser, string toUser,
string subject, string body,
string smtpServer)
{
// Indica el mensaje que se le va a retornar al usuario al final de la
// operación. "OK" significa que el envío del mensaje fue exitoso.
string response = "OK";

http://www.jorgeivanmeza.com/ - 4

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

// Se crea el objeto para el envío de correos electrónicos indicándole
// la dirección del servidor SMTP a utilizarse.
SmtpClient client = new SmtpClient(smtpServer);
// Se especifica la dirección del remitente del mensaje.
MailAddress from = new MailAddress(fromUser);

// Se especifica la dirección del receptor del mensaje.
MailAddress to = new MailAddress(toUser);
// Se especifica el contenido del mensaje.
MailMessage message = new MailMessage(from, to);
message.Body = body + Environment.NewLine + Environment.NewLine;
message.Body += "Mensaje enviado utilizando el servicio web MailService.";
message.BodyEncoding = System.Text.Encoding.UTF8;
// Se especifica el tema del mensaje.
message.Subject = subject;
message.SubjectEncoding = System.Text.Encoding.UTF8;
// Se realiza el envío el mensaje creado anteriormente.
try
{
client.Send(message);
}
catch (SmtpException smtpe)
{
// En caso de suceder problemas enviando el mensaje, la descripción del
// problema sucedido es enviada al cliente que consumió el servicio.
response = smtpe.Message;
}
// Se realiza la limpieza de los recursos.
message.Dispose();
// Se retorna el mensaje de respuesta: "OK" o el mensaje de error sucedido.
return response;
}

Para probar el servicio desde el Visual Web Developer Express utlice las opciones Start Debugging o
Start Without Debugging bajo el menú Debug para iniciar el servicio con o sin información de
depuración respectivamente. Opcionalmente es posible utilizar las combinaciones de teclas F5 o
Ctrl+F5 para realizar las mismas acciones.

Es posible ejecutar el ASP.NET Development Server desde la línea de comando obviando la necesidad
de tener abierto el Visual Web Developer Express, para esto ejecute los siguientes comandos en una
ventana de Símbolo del sistema.

prompt> set DEVSRV=C:\Program Files\Common Files\microsoft
shared\DevServer\9.0\

http://www.jorgeivanmeza.com/ - 5

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

prompt> "%DEVSRV%"\webdev.webserver.exe /path:"G:\Proyectos\WS_Taller\servicio"
/vpath:/MailService

La ubicación del programa webdev.webserver.exe puede variar según la versión del .NET
Framework que se tenga instalada.

Para consultar el documento WSDL1 relacionado haga click en el enlace descripción de servicios, para
probar el servicio web haga click sobre el servicio send.

Especifique valores para los siguientes parámetros y presione el botón Invocar para probar el servicio
web.

1 Web Services Description Language - http://en.wikipedia.org/wiki/Web_Services_Description_Language

http://www.jorgeivanmeza.com/ - 6

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

fromUser – dirección del usuario remitente.
toUser – dirección del usuario receptor.
subject – tema del mensaje.
body – cuerpo del mensaje.
smtpServer – dirección IP del servidor SMTP que se va a utlizar.

Nótese como estas variables coinciden con los parámetros de la función send implementada.

Si el envío del mensaje es exitoso deberá obtenerse la respuesta de éxito: OK, tal y como se
muestra en la siguiente imagen.

En caso de suceder un error se deberá obtener como respuesta una descripción de este, de manera
similar a la mostrada en la siguiente imagen.

Para detener el servicio web que se está probando haga click derecho sobre el icono del ASP.NET
Development Server y elija la opción Stop tal y como se muestra a continuación.

Desarrollo del cliente del servicio web utlizando Java.

http://www.jorgeivanmeza.com/ - 7

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

Para el desarrollo del cliente se utilizará NetBeans en su versión 6,0,1 el cual puede ser descargado
gratuitamente de la siguiente dirección.

http://www.netbeans.org/

Se inicia el ambiente de desarrollo haciendo click sobre su correspondiente ícono en el escritorio, el
cual se puede encontrar también a través del Menú de Inicio > Todos los programas > NetBeans >
NetBeans IDE 6,0,1.

Cree un nuevo proyecto seleccionando el menú File > New Project o presionando la combinación de
teclas Mayúsculas+Ctrl+N.

Seleccione una aplicación Java de escritorio: Java > Java Desktop Application. Presione el botón
Next para continuar.

http://www.jorgeivanmeza.com/ - 8

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

Especifique las siguientes opciones del proyecto.

Project Name: cliente
Project Location: G:\Proyectos\WS_Taller

Tenga en cuenta que deberá personalizar la variable Project Location según sus propios
http://www.jorgeivanmeza.com/ - 9

Desarrollo de un servicio web para el envío de correos utilizando C# y su correspondiente cliente consumidor utilizando Java,

requerimientos.

Presione el botón Finish para aceptar la creación del proyecto con la información anterior.

Agregue la referencia del servicio web al proyecto haciendo click derecho sobre el proyecto cliente y
seleccionando los menúes New > Web Service Client ....

Realice la especificación de los siguientes valores necesarios.

Seleccione la opción WSDL URL.
Especifique la ubicación del servicio web: http://localhost/MailService/Service.asmx.
Package: cliente

http://www.jorgeivanmeza.com/ - 10

Desarrollo de un servicio web para el env