/// <summary>
/// Merge this set of tokens with another set of tokens.
/// </summary>
/// <param name="newTokens">The new tokens to merge with.</param>
/// <remarks>Any token that isn't an empty string in <paramref name="newTokens"/>
/// will replace the token in this <see cref="Tokens"/> object. Useful for when you have
/// a new set of access tokens.</remarks>
public void MergeWith(Tokens newTokens)
{
if (!String.IsNullOrEmpty(newTokens.ConsumerKey))
{
this.ConsumerKey = newTokens.ConsumerKey;
}
if (!String.IsNullOrEmpty(newTokens.ConsumerSecret))
{
this.ConsumerSecret = newTokens.ConsumerSecret;
}
if (!String.IsNullOrEmpty(newTokens.AccessToken))
{
this.AccessToken = newTokens.AccessToken;
}
if (!String.IsNullOrEmpty(newTokens.AccessTokenSecret))
{
this.AccessTokenSecret = newTokens.AccessTokenSecret;
}
}
/// <summary>
/// Set the tokens that should be used for this request.
/// </summary>
/// <param name="oauthTokens">A <see cref="Tokens"/> object containing the Consumer and/or Access tokens.</param>
/// <returns>Itself to chain.</returns>
/// <remarks>This is equivalent to setting <see cref="OAuthRequestWrapper.RequestTokens"/>.</remarks>
public OAuthRequestWrapper WithTokens(Tokens oauthTokens)
{
if (oauthTokens == null)
{
throw new ArgumentException("oauthTokens cannot be null", "oauthTokens");
}
RequestTokens = oauthTokens;
return this;
}
/// <summary>
/// For the Request and Access Token stages, makes the request and parses out the OAuth tokens from
/// the server.
/// </summary>
/// <param name="request">The request that needs to be signed with OAuth.</param>
/// <param name="callback"></param>
/// <returns>A <see cref="Tokens"/> object containing the Access Token and Access Secret provided by the OAuth server.</returns>
/// <remarks>You typically call this when making a request to get the users access tokens and combine this with the <see cref="Tokens.MergeWith"/> function.</remarks>
/// <example>
/// <code>
/// var request = WebRequest.Create("https://api.twitter.com/oauth/request_token") { Method = "POST" };
/// request.SignRequest(RequestTokens)
/// .WithCallback("oob")
/// .InHeader();
///
/// var accessTokens = request.GetOAuthTokens();
/// RequestTokens.MergeWith(accessTokens);
/// </code>
/// In the above example, the <see cref="WebRequest"/> is created, and signed with a specific set of <see cref="Tokens"/>. A call to <see cref="GetOAuthTokens"/>
/// is made and then merged with the original Request Tokens.
/// </example>
/// <exception cref="WebException">Thrown when the <paramref name="request"/> encounters an error.</exception>
public static void GetOAuthTokensAsync(this WebRequest request, Action<Tokens, Exception> callback)
{
var newTokens = new Tokens();
string output;
WebResponse response = null;
StreamReader responseStreamReader = null;
Exception thrownException = null;
request.BeginGetResponse((responseResult) =>
{
try
{
try
{
response = request.EndGetResponse(responseResult);
responseStreamReader = new StreamReader(response.GetResponseStream());
output = responseStreamReader.ReadToEnd();
if (!String.IsNullOrEmpty(output))
{
var dataValues = UrlHelper.ParseQueryString(output);
if (!dataValues.ContainsKey("oauth_token")
|| !dataValues.ContainsKey("oauth_token_secret"))
{
var ex = new Exception("Response did not contain oauth_token and oauth_token_secret. Response is contained in Data of exception.");
ex.Data.Add("ResponseText", output);
ex.Data.Add("RequestUri", request.RequestUri);
ex.Data.Add("RequestMethod", request.Method);
ex.Data.Add("RequestHeaders", request.Headers);
ex.Data.Add("ResponseHeaders", response.Headers);
throw ex;
}
newTokens.AccessToken = dataValues["oauth_token"];
newTokens.AccessTokenSecret = dataValues["oauth_token_secret"];
}
}
catch (Exception ex)
{
thrownException = ex;
}
if (thrownException != null)
{
callback(null, thrownException);
}
else
{
callback(newTokens, null);
}
}
finally
{
try { if (responseStreamReader != null) responseStreamReader.Dispose(); }
catch
{
// ignored
}
try { if (response != null) ((IDisposable)response).Dispose(); }
catch
{
// ignored
}
}
}, null);
}
/// <summary>
/// For the Request and Access Token stages, makes the request and parses out the OAuth tokens from
/// the server.
/// </summary>
/// <param name="request">The request that needs to be signed with OAuth.</param>
/// <returns>A <see cref="Tokens"/> object containing the Access Token and Access Secret provided by the OAuth server.</returns>
/// <remarks>You typically call this when making a request to get the users access tokens and combine this with the <see cref="Tokens.MergeWith"/> function.</remarks>
/// <example>
/// <code>
/// var request = WebRequest.Create("https://api.twitter.com/oauth/request_token") { Method = "POST" };
/// request.SignRequest(RequestTokens)
/// .WithCallback("oob")
/// .InHeader();
///
/// var accessTokens = request.GetOAuthTokens();
/// RequestTokens.MergeWith(accessTokens);
/// </code>
/// In the above example, the <see cref="WebRequest"/> is created, and signed with a specific set of <see cref="Tokens"/>. A call to <see cref="GetOAuthTokens"/>
/// is made and then merged with the original Request Tokens.
/// </example>
/// <exception cref="WebException">Thrown when the <paramref name="request"/> encounters an error.</exception>
public static Tokens GetOAuthTokens(this WebRequest request)
{
var newTokens = new Tokens();
string output;
using (var responseStream = request.GetResponse())
{
using (var response = new StreamReader(responseStream.GetResponseStream()))
{
output = response.ReadToEnd();
}
}
if (!String.IsNullOrEmpty(output))
{
var dataValues = UrlHelper.ParseQueryString(output);
newTokens.AccessToken = dataValues["oauth_token"];
newTokens.AccessTokenSecret = dataValues["oauth_token_secret"];
}
return newTokens;
}
/// <summary>
/// Begin signing this <see cref="WebRequest"/> object with OAuth using the tokens provided.
/// </summary>
/// <param name="request">The request that needs to be signed with OAuth.</param>
/// <param name="withTokens">The <see cref="Tokens"/> to use to sign the request with.</param>
/// <returns>An <see cref="DangerouslyDelicious.SimpleOAuthXamarin.OAuthRequestWrapper"/> used to provide the required parameters for OAuth signing.</returns>
public static OAuthRequestWrapper SignRequest(this WebRequest request, Tokens withTokens)
{
return new OAuthRequestWrapper(request) { RequestTokens = withTokens };
}