alvinashcraft
shared this story
from 
Muhammad Rehan Saeed.
ASP.NET MVC Boilerplate
Internet Favicon Madness (Updated)
Securing the ASP.NET MVC Web.config (Updated)
NWebSec ASP.NET MVC Security Through HTTP Headers
Content Security Policy (CSP) for ASP.NET MVC
Building RSS/Atom Feeds for ASP.NET MVC
What is an RSS/Atom Feed
An RSS or Atom feed is a great way to push site updates to users. Essentially, it’s just an XML document which is constantly updated with fresh content and links.
There are numerous feed readers out there that all work in different ways but most just aggregate feeds from several sites into a single reading list. When a user subscribes to your sites feed and adds it to their list of subscriptions, each time you update your feed the fresh content will appear in their reading list.
Feed readers come in all shapes and sizes, even browsers have basic feed reading abilities. Here is a screen-shot of Firefox’s bookmarks side-bar, after adding the Visual Studio Magazine feed (Go ahead and try it yourself in Firefox). The bookmarks under the Blogs folder updates each time the feed updates.
Feed reading websites like Feedly and NewsBlur are fairly popular. Increasingly though, feed readers are actually just apps running on phones or tablets and these can even raise notifications when the feed changes and there is fresh content to read. Services like Feedly and NewsBlur also have their own apps too.
RSS vs Atom
The latest versions of RSS is 2.0, while Atom is 1.0. Atom 1.0 is a web standard and you can read the official IETF Atom 1.0 specification here. RSS is not a web standard and is actually owned by Harvard University.
Atom was created specifically to address problems in RSS 2.0 and is the newer and more well defined format. Both of these formats are now pretty ancient by web standards and enjoy widespread support. If you have a choice of format, go with Atom 1.0.
Atom 1.0 XML
So what does an Atom feed look like, well you can look at the official specification here or there is a simple but fully featured example below.
At the root of the XML we have the feed element which represents the Atom Feed. Within that, there is various meta-data about the feed at the top, including:
title – The title of the feed.
subtitle – A short description or subtitle of the feed.
id – A unique ID for the feed. No other feed on the internet should have the same ID.
rights – Copyright information.
updated – When the feed was last updated.
category – Zero or more categories the feed belongs to.
logo – A wide 2:1 ratio image representing the feed.
author – Zero or more authors of the feed.
contributor – Zero or more contributors of the feed.
link rel=”self” – A link to the feed itself.
link rel=”alternate” – A link to an alternative representation of the feed.
link rel=”hub” – A link to the PubSubHubbub hub. I’ll talk more about this further on.
icon – A square 1:1 ratio image representing the feed.
The entry elements are where it gets interesting, these are the actual ‘things’ in your feed you are describing. Each entry has meta-data which looks very similar to the meta-data we used to describe the feed itself.
id – A unique identifier to the entry. This can be a database row ID, it doesn’t have to be a GUID.
title – The title of the entry.
summary – A short summary for what the entry is about.
published – When the entry was published.
updated – When the entry was last changed.
author – Zero or more authors of the entry.
contributor- Zero or more contributors of the entry.
link rel=”alternate” – A link to an alternative representation of the entry.
link rel=”enclosure” – An image representing the entry.
category – The category of the entry.
rights – Some copyright information.
media:thumbnail – A thumbnail representing the entry. This is a non-standard extension to the Atom 1.0 specification created by Yahoo but is common enough to be used here.
One thing to note is that all of the links are full absolute URL’s. Relative URL’s are allowed but you have to specify a single base URI which is added to the start of all URL’s. Unfortunately, this feature is buggy in Firefox and so should not be used.
Implementing an Atom Feed
The Windows Communication Foundation (WCF) team at Microsoft has kindly implemented the SyndicationFeed class, giving us a nice API with which to generate the above Atom 1.0 XML (In actual fact this class also represents an RSS 2.0 feed and can be used to generate RSS 2.0 XML too). Since it was the WCF team at Microsoft who built it, they put it in the System.ServiceModel namespace. It doesn’t quite feel right there and will probably be split out into it’s own namespace (Indeed, I’ve raised this very question for the new DNX Core version of the .NET Framework which is currently missing SyndicationFeed). Creating a new feed is as simple as this:
Unfortunately, the property to set the icon does not exist on the SyndicationFeed, even though it is part of the official specification. Luckily for you I have created a quick extension method (Usage shown above) which allows us to set the icon.
I’ve also created an extension method to add a Yahoo media thumbnail to an Atom entry. This is a non-standard extension but worth the effort. To use non-standard extensions, requires adding a namespace to the feed element in the XML, that is what the AddYahooMediaNamespace method does towards the bottom.
The extension methods are shown below. They use extensibility points on the SyndicationFeed, that allows us to augment its functionality.
Creating feed entries is just as simple and is done using the SyndicationItem class. An example of creating the first entry is shown below.
Now it’s actually possible to include a full HTML page inside a feed entry. Alternatively, you can provide plain text content or as I have done, provide a link to the full content. I have shown how to do all three in the comments above.
The next step is to actually reply to the client with a HTTP response containing the Atom 1.0 XML. Although Atom is just XML, it has it’s own specific schema and has it’s own MIME type ‘application/atom+xml’. Furthermore, the XML must actually be returned using the UTF-8 character encoding as per the standard. So here is our controllers action returning the feed:
The above controller action is super simple, we take our SyndicationFeed and return it in a new AtomActionResult which is where all the magic happens. We also cache the response for a day, this is great for performance if your feed does not change very often. So what is AtomActionResult, well here is the code:
The above code is writing out the XML to the HTTP response in UTF-8 encoding and with the ‘application/atom+xml’ MIME type. By default the XML is written out all in one line which is good for performance but not very good for legibility, so we also detect whether the application is being debugged and if so, indent the XML for better legibility.
After all our hard work, we can now navigate to the controller action and view our feed. Here is Internet Explorer’s view of our Atom feed:
Images
RSS and Atom have been around for over a decade now and there is precious little information out there on how to create a feed. One of the areas that lacked information was the logo and icon images. All the specification says is that the ratios of the images should be a 2:1 rectangle and a 1:1 square respectively.
My advice to you and what I ended up doing is looking at various examples on the internet of feeds and copy the image sizes they were using. I ended up with images of size 48×48 and 96×48 which seemed a common size.
Adding a ‘Subscribe to this page’ Button
Firefox has a feature called ‘Subscribe to this page’ which is a button that users can add to their toolbar (The button is enabled by default on older versions of Firefox). The button detects whether the current page links to an RSS/Atom feed and if it does, the user can click on it to subscribe to the feed directly. Here is a quick screen-shot of the button:
To add this feature, we need to place a meta tag in the head of our page with a link to the Atom feed like so:
This is a pretty minor feature I admit but it has potential. By doing this, we are linking our page to the Atom feed. This can be read by search engines too, so potentially there could be some benefit in terms of Search Engine Optimization (SEO). Of course this is impossible to prove as search engines jealously guard how they manage their search rankings.
PubSubHubbub
The problem with feeds is that you have to pull the information from them. You are never notified of new changes to the feed, so clients have to constantly poll the feed to check for any new feed entries.
This is the problem that PubSubHubbub (I know, it has a terrible name!) solves. It’s been developed by Google and it’s actually an open standard, with the latest version of the standard being 0.4 at the time of writing.
There are already major platforms supporting it. Mostly they are Google products as you would expect but WordPress which powers a third of the worlds websites also supports it.
At the heart of it, you now have a hub that knows how to speak the PubSubHubbub standard language. When a feed is updated with a new entry, the website sends a message to the hub to tell it that the feed has been updated. Clients can then register for updates with the hub and get notified instantly when there is an update.
The coolest thing though is that all of this is super easy to implement, since Google provides us with a hub that we can use and we don’t need to write our own. We just need to add a line of XML in our Atom feed telling clients that we support PubSubHubbub and the URL to the hub we want to use:
Now when there is an update to the feed, we need to publish that update to the hub linked to above. We do that by calling the simple method below:
It’s as simple as that from the publishers side. On the client side, subscribing to the changes in the feed is only a little more complicated than this. I won’t cover that but you can find out more by reading the official specification.
Conclusion
As always, you can look at a full working example of all of this code on the ASP.NET MVC Boilerplate GitHub page.
The post Building RSS/Atom Feeds for ASP.NET MVC appeared first on Muhammad Rehan Saeed.
