スタンドアロン診断フィードのサンプル
DiagnosticsFeed サンプルでは、Windows Communication Foundation (WCF) を使用して配信するための RSS/Atom フィードを作成する方法を示します。 これは基本的な "Hello World" プログラムであり、オブジェクト モデルの基本と、Windows Communication Foundation (WCF) サービスでの設定方法を示しています。
WCF では、特殊なデータ型 SyndicationFeedFormatter を返すサービス操作として配信フィードがモデル化されています。 SyndicationFeedFormatter のインスタンスは、フィードを RSS 2.0 形式および Atom 1.0 形式の両方にシリアル化できます。 使用するコントラクトを次のサンプル コードに示します。
[ServiceContract(Namespace = "")]
interface IDiagnosticsService
{
[OperationContract]
//The [WebGet] attribute controls how WCF dispatches
//HTTP requests to service operations based on a URI suffix
//(the part of the request URI after the endpoint address)
//using the HTTP GET method. The UriTemplate specifies a relative
//path of 'feed', and specifies that the format is
//supplied using a query string.
[WebGet(UriTemplate="feed?format={format}")]
[ServiceKnownType(typeof(Atom10FeedFormatter))]
[ServiceKnownType(typeof(Rss20FeedFormatter))]
SyndicationFeedFormatter GetProcesses(string format);
}
GetProcesses
操作には、WCF からサービス操作に HTTP GET 要求をディスパッチする方法を制御し、送信されるメッセージの形式を指定できるようにする WebGetAttribute 属性で注釈が付けられています。
他の WCF サービスと同様に、配信フィードも任意のマネージド アプリケーション内でセルフホストできます。 配信サービスが適切に機能するには、特定のバインディング (WebHttpBinding) と、特定のエンドポイント動作 (WebHttpBehavior) が必要です。 新しい WebServiceHost クラスには、特定の構成を使用せずにこのようなエンドポイントを作成する際に便利な API が用意されています。
WebServiceHost host = new WebServiceHost(typeof(ProcessService), new Uri("http://localhost:8000/diagnostics"));
//The WebServiceHost will automatically provide a default endpoint at the base address
//using the proper binding (the WebHttpBinding) and endpoint behavior (the WebHttpBehavior)
または、IIS でホストされる .svc ファイルから WebServiceHostFactory を使用して、同等の機能を用意することもできます (この手法は、このサンプル コードでは示されません)。
<% @ServiceHost Language="C#|VB" Debug="true" Service="ProcessService" %>
このサービスは標準の HTTP GET を使用して要求を受け取るので、サービスへのアクセスには、RSS または ATOM に対応している任意のクライアントを使用できます。 たとえば、RSS 対応のブラウザーで http://localhost:8000/diagnostics/feed/?format=atom
または http://localhost:8000/diagnostics/feed/?format=rss
に移動して、このサービスの出力を表示できます。
また、WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法を使用して、命令型コードを使用して配信データを読み取り、処理することもできます。
XmlReader reader = XmlReader.Create( "http://localhost:8000/diagnostics/feed/?format=rss",
new XmlReaderSettings()
{
//MaxCharactersInDocument can be used to control the maximum amount of data
//read from the reader and helps prevent OutOfMemoryException
MaxCharactersInDocument = 1024 * 64
} );
SyndicationFeed feed = SyndicationFeed.Load(reader);
foreach (SyndicationItem i in feed.Items)
{
XmlSyndicationContent content = i.Content as XmlSyndicationContent;
ProcessData pd = content.ReadContent<ProcessData>();
Console.WriteLine(i.Title.Text);
Console.WriteLine(pd.ToString());
}
サンプルをセットアップ、ビルド、実行する
「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」で説明されているように、コンピューター上で HTTP および HTTPS のアドレスを登録するための適切なアクセス許可を持っていることを確認します。
ソリューションをビルドします。
コンソール アプリケーションを実行します。
コンソール アプリケーションの実行中に、RSS 対応のブラウザーを使用して
http://localhost:8000/diagnostics/feed/?format=atom
またはhttp://localhost:8000/diagnostics/feed/?format=rss
に移動します。