using System;
|
using System.Globalization;
|
using System.IO;
|
using System.Net;
|
using System.Security;
|
using System.Text.RegularExpressions;
|
using System.Web;
|
using System.Xml;
|
|
namespace TwitterLib
|
{
|
/// <summary>
|
/// .NET wrapper for interacting with the Twitter API
|
/// </summary>
|
public class TwitterNet : IServiceApi
|
{
|
#region Private Fields
|
private string username;
|
private SecureString password;
|
private string publicTimelineUrl;
|
private string friendsTimelineUrl;
|
private string userTimelineUrl;
|
private string repliesTimelineUrl;
|
private string directMessagesUrl;
|
private string updateUrl;
|
private string friendsUrl;
|
private string followersUrl;
|
private string userShowUrl;
|
private string sendMessageUrl;
|
private string destroyUrl;
|
private string destroyDirectMessageUrl;
|
private string createFriendshipUrl;
|
private string format;
|
private IWebProxy webProxy;
|
|
private User currentLoggedInUser;
|
|
// REMARK: might need to fix this for globalization
|
private readonly string twitterCreatedAtDateFormat = "ddd MMM dd HH:mm:ss zzzz yyyy"; // Thu Apr 26 01:36:08 +0000 2007
|
private readonly string twitterSinceDateFormat = "ddd MMM dd yyyy HH:mm:ss zzzz";
|
|
private static int characterLimit;
|
private string clientName;
|
|
#endregion
|
|
#region Public Properties
|
|
public User CurrentlyLoggedInUser
|
{
|
get
|
{
|
if (null == currentLoggedInUser)
|
{
|
currentLoggedInUser = Login();
|
}
|
return currentLoggedInUser;
|
}
|
set
|
{
|
currentLoggedInUser = value;
|
}
|
}
|
|
/// <summary>
|
/// Twitter username
|
/// </summary>
|
public string UserName
|
{
|
get { return (null == currentLoggedInUser ? currentLoggedInUser.Name: String.Empty) ; }
|
}
|
|
/// <summary>
|
/// Twitter password
|
/// </summary>
|
public SecureString Password
|
{
|
get { return password; }
|
set { password = value; }
|
}
|
|
/// <summary>
|
/// Web proxy to use when communicating with the Twitter service
|
/// </summary>
|
public IWebProxy WebProxy
|
{
|
get { return webProxy; }
|
set { webProxy = value; }
|
}
|
|
/// <summary>
|
/// Url to the Twitter Public Timeline. Defaults to http://twitter.com/statuses/public_timeline
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string PublicTimelineUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(publicTimelineUrl))
|
return "http://twitter.com/statuses/public_timeline";
|
else
|
return publicTimelineUrl;
|
}
|
set { publicTimelineUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the Twitter Friends Timeline. Defaults to http://twitter.com/statuses/friends_timeline
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string FriendsTimelineUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(friendsTimelineUrl))
|
return "http://twitter.com/statuses/friends_timeline";
|
else
|
return friendsTimelineUrl;
|
}
|
set { friendsTimelineUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the user's timeline. Defaults to http://twitter.com/statuses/user_timeline
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string UserTimelineUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(userTimelineUrl))
|
return "http://twitter.com/statuses/user_timeline";
|
else
|
return userTimelineUrl;
|
}
|
set { userTimelineUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the 20 most recent replies (status updates prefixed with @username posted by users who are friends with the user being replied to) to the authenticating user.
|
/// Defaults to http://twitter.com/statuses/user_timeline
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string RepliesTimelineUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(repliesTimelineUrl))
|
return "http://twitter.com/statuses/replies";
|
else
|
return repliesTimelineUrl;
|
}
|
set { repliesTimelineUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the list of the 20 most recent direct messages sent to the authenticating user. Defaults to http://twitter.com/direct_messages
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string DirectMessagesUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(directMessagesUrl))
|
return "http://twitter.com/direct_messages";
|
else
|
return directMessagesUrl;
|
}
|
set { directMessagesUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the Twitter HTTP Post. Defaults to http://twitter.com/statuses/update
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string UpdateUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(updateUrl))
|
return "http://twitter.com/statuses/update";
|
else
|
return updateUrl;
|
}
|
set { updateUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the user's friends. Defaults to http://twitter.com/statuses/friends
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string FriendsUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(friendsUrl))
|
return "http://twitter.com/statuses/friends";
|
else
|
return friendsUrl;
|
}
|
set { friendsUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to the user's followers. Defaults to http://twitter.com/statuses/followers
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string FollowersUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(followersUrl))
|
return "http://twitter.com/statuses/followers";
|
else
|
return followersUrl;
|
}
|
set { followersUrl = value; }
|
}
|
|
/// <summary>
|
/// Returns extended information of a given user, specified by ID or screen name as per the required id parameter below.
|
/// This information includes design settings, so third party developers can theme their widgets according to a given user's preferences.
|
/// Defaults to http://twitter.com/users/show/
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string UserShowUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(userShowUrl))
|
return "http://twitter.com/users/show/";
|
else
|
return userShowUrl;
|
}
|
set { userShowUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to sends a new direct message to the specified user from the authenticating user. Defaults to http://twitter.com/direct_messages/new
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string SendMessageUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(sendMessageUrl))
|
return "http://twitter.com/direct_messages/new";
|
else
|
return sendMessageUrl;
|
}
|
set { sendMessageUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to destroy a status from the authenticating user. Defaults to http://twitter.com/statuses/destroy
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string DestroyUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(destroyUrl))
|
return "http://twitter.com/statuses/destroy/";
|
else
|
return destroyUrl;
|
}
|
set { destroyUrl = value; }
|
}
|
|
/// <summary>
|
/// Url to destroy a direct message from the authenticating user. Defaults to http://twitter.com/direct_messages/destroy/
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string DestroyDirectMessageUrl
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(destroyDirectMessageUrl))
|
return "http://twitter.com/direct_messages/destroy/";
|
else
|
return destroyDirectMessageUrl;
|
}
|
set { destroyDirectMessageUrl = value; }
|
}
|
|
|
|
public string CreateFriendshipUrl
|
{
|
get {
|
if (string.IsNullOrEmpty(createFriendshipUrl))
|
{
|
return "http://twitter.com/friendships/create/";
|
}
|
else
|
{
|
return createFriendshipUrl;
|
}
|
}
|
set { createFriendshipUrl = value; }
|
}
|
|
/// <summary>
|
/// The format of the results from the twitter API. Ex: .xml, .json, .rss, .atom. Defaults to ".xml"
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if Twitter API urls have been changed on http://groups.google.com/group/twitter-development-talk/web/api-documentation
|
/// </remarks>
|
public string Format
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(format))
|
return ".xml";
|
else
|
return format;
|
}
|
set { format = value; }
|
}
|
|
/// <summary>
|
/// The number of characters available for the Tweet text. Defaults to 140.
|
/// </summary>
|
/// <remarks>
|
/// This value should only be changed if the character limit on Twitter.com has been changed.
|
/// </remarks>
|
public static int CharacterLimit
|
{
|
get
|
{
|
if (characterLimit == 0)
|
return 140;
|
else
|
return characterLimit;
|
}
|
set { characterLimit = value; }
|
}
|
|
/// <summary>
|
/// The name of the current client. Defaults to "Witty"
|
/// </summary>
|
/// <remarks>
|
/// This value can be changed if you're using this Library for your own twitter client
|
/// </remarks>
|
public string ClientName
|
{
|
get
|
{
|
if (string.IsNullOrEmpty(clientName))
|
return "witty";
|
else
|
return clientName;
|
}
|
set { clientName = value; }
|
}
|
|
#endregion
|
|
#region Constructors
|
|
/// <summary>
|
/// Unauthenticated constructor
|
/// </summary>
|
public TwitterNet()
|
{
|
}
|
|
/// <summary>
|
/// Authenticated constructor
|
/// </summary>
|
public TwitterNet(string username, SecureString password)
|
{
|
this.username = username;
|
this.password = password;
|
}
|
|
/// <summary>
|
/// Authenticated constructor with Proxy
|
/// </summary>
|
public TwitterNet(string username, SecureString password, IWebProxy webProxy)
|
{
|
this.username = username;
|
this.password = password;
|
this.webProxy = webProxy;
|
}
|
|
#endregion
|
|
#region Public Methods
|
|
#region Timeline Methods
|
|
/// <summary>
|
/// Retrieves the public timeline
|
/// </summary>
|
public TweetCollection GetPublicTimeline()
|
{
|
return RetrieveTimeline(Timeline.Public);
|
}
|
|
/// <summary>
|
/// Retrieves the public timeline. Narrows the result to after the since date.
|
/// </summary>
|
public TweetCollection GetPublicTimeline(string since)
|
{
|
return RetrieveTimeline(Timeline.Public, since);
|
}
|
|
/// <summary>
|
/// Retrieves the friends timeline
|
/// </summary>
|
public TweetCollection GetFriendsTimeline()
|
{
|
if (!string.IsNullOrEmpty(username))
|
return RetrieveTimeline(Timeline.Friends);
|
else
|
return RetrieveTimeline(Timeline.Public);
|
}
|
|
/// <summary>
|
/// Retrieves the friends timeline. Narrows the result to after the since date.
|
/// </summary>
|
public TweetCollection GetFriendsTimeline(string since)
|
{
|
if (!string.IsNullOrEmpty(username))
|
return RetrieveTimeline(Timeline.Friends, since);
|
else
|
return RetrieveTimeline(Timeline.Public, since);
|
}
|
|
/// <summary>
|
/// Retrieves the friends timeline. Narrows the result to after the since date.
|
/// </summary>
|
public TweetCollection GetFriendsTimeline(string since, string userId)
|
{
|
return RetrieveTimeline(Timeline.Friends, since, userId);
|
}
|
|
public TweetCollection GetUserTimeline(string userId)
|
{
|
return RetrieveTimeline(Timeline.User, "", userId);
|
}
|
|
public TweetCollection GetReplies()
|
{
|
return RetrieveTimeline(Timeline.Replies);
|
}
|
|
#endregion
|
|
/// <summary>
|
/// Returns the authenticated user's friends who have most recently updated, each with current status inline.
|
/// </summary>
|
public UserCollection GetFriends()
|
{
|
return GetFriends(CurrentlyLoggedInUser.Id);
|
}
|
|
/// <summary>
|
/// Returns the user's friends who have most recently updated, each with current status inline.
|
/// </summary>
|
public UserCollection GetFriends(int userId)
|
{
|
UserCollection users = new UserCollection();
|
|
// Twitter expects http://twitter.com/statuses/friends/12345.xml
|
string requestURL = FriendsUrl + "/" + userId + Format;
|
|
int friendsCount = 0;
|
|
// Since the API docs state "Returns up to 100 of the authenticating user's friends", we need
|
// to use the page param and to fetch ALL of the users friends. We can find out how many pages
|
// we need by dividing the # of friends by 100 and rounding any remainder up.
|
// merging the responses from each request may be tricky.
|
if (currentLoggedInUser != null && currentLoggedInUser.Id == userId)
|
{
|
friendsCount = CurrentlyLoggedInUser.FollowingCount;
|
}
|
else
|
{
|
// need to make an extra call to twitter
|
User user = GetUser(userId);
|
friendsCount = user.FollowingCount;
|
}
|
|
int numberOfPagesToFetch = (friendsCount / 100) + 1;
|
|
string pageRequestUrl = requestURL;
|
|
for (int count = 1; count <= numberOfPagesToFetch; count++)
|
{
|
pageRequestUrl = requestURL + "?page=" + count;
|
|
// Create the web request
|
HttpWebRequest request = WebRequest.Create(pageRequestUrl) as HttpWebRequest;
|
|
// Add credendtials to request
|
request.Credentials = new NetworkCredential(username, TwitterNet.ToInsecureString(password));
|
|
try
|
{
|
// Get the Response
|
using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
|
{
|
// Get the response stream
|
StreamReader reader = new StreamReader(response.GetResponseStream());
|
|
// Create a new XmlDocument
|
XmlDocument doc = new XmlDocument();
|
|
// Load data
|
doc.Load(reader);
|
|
// Get statuses with XPath
|
XmlNodeList nodes = doc.SelectNodes("/users/user");
|
|
foreach (XmlNode node in nodes)
|
{
|
User user = new User();
|
user.Id = int.Parse(node.SelectSingleNode("id").InnerText);
|
user.Name = node.SelectSingleNode("name").InnerText;
|
user.ScreenName = node.SelectSingleNode("screen_name").InnerText;
|
user.ImageUrl = node.SelectSingleNode("profile_image_url").InnerText;
|
user.SiteUrl = node.SelectSingleNode("url").InnerText;
|
user.Location = node.SelectSingleNode("location").InnerText;
|
user.Description = node.SelectSingleNode("description").InnerText;
|
|
users.Add(user);
|
}
|
|
}
|
}
|
catch (WebException webExcp)
|
{
|
// Get the WebException status code.
|
WebExceptionStatus status = webExcp.Status;
|
// If status is WebExceptionStatus.ProtocolError,
|
// there has been a protocol error and a WebResponse
|
// should exist. Display the protocol error.
|
if (status == WebExceptionStatus.ProtocolError)
|
{
|
// Get HttpWebResponse so that you can check the HTTP status code.
|
HttpWebResponse httpResponse = (HttpWebResponse)webExcp.Response;
|
|
switch ((int)httpResponse.StatusCode)
|
{
|
case 304: // 304 Not modified = no new tweets so ignore error.
|
break;
|
case 400: // rate limit exceeded
|
throw new RateLimitException("Rate limit exceeded. Clients may not make more than 70 requests per hour. Please try again in a few minutes.");
|
case 401: // unauthorized
|
throw new SecurityException("Not Authorized.");
|
default:
|
throw;
|
}
|
}
|
}
|
}
|
return users;
|
}
|
|
public User GetUser(int userId)
|
{
|
User user = new User();
|
|
// Twitter expects http://twitter.com/users/show/12345.xml
|
string requestURL = UserShowUrl + userId + Format;
|
|
// Create the web request
|
HttpWebRequest request = WebRequest.Create(requestURL) as HttpWebRequest;
|
|
// Add credendtials to request
|
request.Credentials = new NetworkCredential(username, TwitterNet.ToInsecureString(password));
|
|
// Add configured web proxy
|
request.Proxy = webProxy;
|
|
using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
|
{
|
// Get the response stream
|
StreamReader reader = new StreamReader(response.GetResponseStream());
|
|
// Load the response data into a XmlDocument
|
XmlDocument doc = new XmlDocument();
|
doc.Load(reader);
|
|
// Get statuses with XPath
|
XmlNode userNode = doc.SelectSingleNode("user");
|
|
if (userNode != null)
|
{
|
user.Id = int.Parse(userNode.SelectSingleNode("id").InnerText);
|
user.Name = userNode.SelectSingleNode("name").InnerText;
|
user.ScreenName = userNode.SelectSingleNode("screen_name").InnerText;
|
user.ImageUrl = userNode.SelectSingleNode("profile_image_url").InnerText;
|
user.SiteUrl = userNode.SelectSingleNode("url").InnerText;
|
user.Location = userNode.SelectSingleNode("location").InnerText;
|
user.Description = userNode.SelectSingleNode("description").InnerText;
|
user.BackgroundColor = userNode.SelectSingleNode("profile_background_color").InnerText;
|
user.TextColor = userNode.SelectSingleNode("profile_text_color").InnerText;
|
user.LinkColor = userNode.SelectSingleNode("profile_link_color").InnerText;
|
user.SidebarBorderColor = userNode.SelectSingleNode("profile_sidebar_border_color").InnerText;
|
user.SidebarFillColor = userNode.SelectSingleNode("profile_sidebar_fill_color").InnerText;
|
| user.FollowingCount = int.Parse(userNod |
