Поделиться через

Как создать базовый канал Atom

  • Статья

Windows Communication Foundation (WCF) позволяет создавать службу, предоставляющую веб-канал синдикации. В этом разделе рассматривается процесс создания службы синдикации, предоставляющей веб-канал синдикации Atom.

Создание базовой службы синдикации

  1. Определите контракт службы с помощью интерфейса, отмеченного атрибутом WebGetAttribute. Каждая операция, предоставляемая как веб-канал синдикации, должна возвращать объект Atom10FeedFormatter.

    [ServiceContract]
public interface IBlog
{
    [OperationContract]
    [WebGet]
    Atom10FeedFormatter GetBlog();
}
    Bb412177.note(ru-ru,VS.100).gifПримечание
    Все операции службы, которые применяют атрибут WebGetAttribute, сопоставляются с запросами HTTP GET. Чтобы сопоставить операцию с другим методом HTTP, используйте WebInvokeAttribute. Дополнительные сведения см. в разделе Как создать простую веб-службу WCF HTTP.

  2. Реализуйте контракт службы.

    public class BlogService : IBlog
{
    public Atom10FeedFormatter GetBlog()
    {
        SyndicationFeed feed = new SyndicationFeed("My Blog Feed", "This is a test feed", new Uri("http://SomeURI"), "FeedOneID", new DateTimeOffset(DateTime.Now));
        feed.Authors.Add(new SyndicationPerson("someone@microsoft.com"));
        feed.Categories.Add(new SyndicationCategory("How To Sample Code"));
        feed.Description = new TextSyndicationContent("This is a sample that illistrates how to expose a feed using ATOM with WCF");

        SyndicationItem item1 = new SyndicationItem(
            "Item One",
            "This is the content for item one",
            new Uri("https://localhost/Content/One"),
            "ItemOneID",
            DateTime.Now);

        SyndicationItem item2 = new SyndicationItem(
            "Item Two",
            "This is the content for item two",
            new Uri("https://localhost/Content/Two"),
            "ItemTwoID",
            DateTime.Now);

        SyndicationItem item3 = new SyndicationItem(
            "Item Three",
            "This is the content for item three",
            new Uri("https://localhost/Content/three"),
            "ItemThreeID",
            DateTime.Now);
        List<SyndicationItem> items = new List<SyndicationItem>();

        items.Add(item1);
        items.Add(item2);
        items.Add(item3);

        feed.Items = items;
        return new Atom10FeedFormatter(feed);
    }
}

  3. Создайте объект SyndicationFeed, затем добавьте автора, категорию и описание.

    SyndicationFeed feed = new SyndicationFeed("My Blog Feed", "This is a test feed", new Uri("http://SomeURI"), "FeedOneID", new DateTimeOffset(DateTime.Now));
feed.Authors.Add(new SyndicationPerson("someone@microsoft.com"));
feed.Categories.Add(new SyndicationCategory("How To Sample Code"));
feed.Description = new TextSyndicationContent("This is a sample that illistrates how to expose a feed using ATOM with WCF");

  4. Создайте несколько объектов SyndicationItem.

    SyndicationItem item1 = new SyndicationItem(
    "Item One",
    "This is the content for item one",
    new Uri("https://localhost/Content/One"),
    "ItemOneID",
    DateTime.Now);

SyndicationItem item2 = new SyndicationItem(
    "Item Two",
    "This is the content for item two",
    new Uri("https://localhost/Content/Two"),
    "ItemTwoID",
    DateTime.Now);

SyndicationItem item3 = new SyndicationItem(
    "Item Three",
    "This is the content for item three",
    new Uri("https://localhost/Content/three"),
    "ItemThreeID",
    DateTime.Now);

  5. Добавьте объекты SyndicationItem в веб-канал.

    List<SyndicationItem> items = new List<SyndicationItem>();

items.Add(item1);
items.Add(item2);
items.Add(item3);

feed.Items = items;

  6. Возвратите веб-канал.

    return new Atom10FeedFormatter(feed);

Размещение службы

  1. Создайте объект WebServiceHost.

    Uri baseAddress = new Uri("https://localhost:8000/BlogService/");
WebServiceHost svcHost = new WebServiceHost(typeof(BlogService), baseAddress);

  2. Откройте узел службы, загрузите веб-канал из службы, отобразите веб-канал и дождитесь нажатия клавиши ВВОД пользователем.

    svcHost.Open();
Console.WriteLine("Service is running");

XmlReader reader = XmlReader.Create("https://localhost:8000/BlogService/GetBlog");
SyndicationFeed feed = SyndicationFeed.Load(reader);
Console.WriteLine(feed.Title.Text);
Console.WriteLine("Items:");
foreach (SyndicationItem item in feed.Items)
{
    Console.WriteLine("Title: {0}", item.Title.Text);
    Console.WriteLine("Content: {0}", ((TextSyndicationContent)item.Content).Text);
}
Console.WriteLine("Press <ENTER> to quit...");
Console.ReadLine();
svcHost.Close();

Вызов GetBlog() c HTTP GET

  1. Откройте Internet Explorer, введите URL-адрес https://localhost:8000/BlogService/GetBlog и нажмите клавишу ВВОД.

    URL-адрес содержит базовый адрес службы (https://localhost:8000/BlogService), относительный адрес конечной точки и вызываемую операцию службы.

Вызов GetBlog() из кода

  1. Создайте XmlReader с базовым адресом и вызываемым методом.

    XmlReader reader = XmlReader.Create("https://localhost:8000/BlogService/GetBlog");

  2. Вызовите статический метод Load, передав ему только что созданный объект XmlReader.

    SyndicationFeed feed = SyndicationFeed.Load(reader);

    Это вызывает операцию службы и заполняет новый SyndicationFeed с помощью модуля форматирования, возвращенного от операции службы.

  3. Откройте объект веб-канала.

    Console.WriteLine(feed.Title.Text);
Console.WriteLine("Items:");
foreach (SyndicationItem item in feed.Items)
{
    Console.WriteLine("Title: {0}", item.Title.Text);
    Console.WriteLine("Summary: {0}", ((TextSyndicationContent)item.Summary).Text);
}

Пример

Ниже приведен полный код этого примера.

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.ServiceModel;
using System.Xml;
using System.ServiceModel.Description;
using System.ServiceModel.Syndication;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;

namespace Service
{
    [ServiceContract]
    public interface IBlog
    {
        [OperationContract]
        [WebGet]
        Atom10FeedFormatter GetBlog();
    }

    public class BlogService : IBlog
    {
        public Atom10FeedFormatter GetBlog()
        {
            SyndicationFeed feed = new SyndicationFeed("My Blog Feed", "This is a test feed", new Uri("http://SomeURI"), "FeedOneID", new DateTimeOffset(DateTime.Now));
            feed.Authors.Add(new SyndicationPerson("someone@microsoft.com"));
            feed.Categories.Add(new SyndicationCategory("How To Sample Code"));
            feed.Description = new TextSyndicationContent("This is a sample that illistrates how to expose a feed using ATOM with WCF");

            SyndicationItem item1 = new SyndicationItem(
                "Item One",
                "This is the content for item one",
                new Uri("https://localhost/Content/One"),
                "ItemOneID",
                DateTime.Now);

            SyndicationItem item2 = new SyndicationItem(
                "Item Two",
                "This is the content for item two",
                new Uri("https://localhost/Content/Two"),
                "ItemTwoID",
                DateTime.Now);

            SyndicationItem item3 = new SyndicationItem(
                "Item Three",
                "This is the content for item three",
                new Uri("https://localhost/Content/three"),
                "ItemThreeID",
                DateTime.Now);
            List<SyndicationItem> items = new List<SyndicationItem>();

            items.Add(item1);
            items.Add(item2);
            items.Add(item3);

            feed.Items = items;
            return new Atom10FeedFormatter(feed);
        }
    }

    public class Host
    {
        static void Main(string[] args)
        {
            Uri baseAddress = new Uri("https://localhost:8000/BlogService/");
            WebServiceHost svcHost = new WebServiceHost(typeof(BlogService), baseAddress);
            try
            {
                svcHost.Open();
                Console.WriteLine("Service is running");

                XmlReader reader = XmlReader.Create("https://localhost:8000/BlogService/GetBlog");
                SyndicationFeed feed = SyndicationFeed.Load(reader);
                Console.WriteLine(feed.Title.Text);
                Console.WriteLine("Items:");
                foreach (SyndicationItem item in feed.Items)
                {
                    Console.WriteLine("Title: {0}", item.Title.Text);
                    Console.WriteLine("Content: {0}", ((TextSyndicationContent)item.Content).Text);
                }
                Console.WriteLine("Press <ENTER> to quit...");
                Console.ReadLine();
                svcHost.Close();
            }
            catch (CommunicationException ce)
            {
                Console.WriteLine("An exception occurred: {0}", ce.Message);
                svcHost.Abort();
            }
        }
    }
}

Компиляция кода

При компиляции приведенного выше кода задайте ссылки на файлы System.ServiceModel.dll и System.ServiceModel.Web.dll.

См. также

Справочник

WebHttpBinding
WebGetAttribute