/// <summary>
/// Builds an API URI
/// </summary>
/// <param name="command">The command to call.</param>
/// <param name="settings">The music client settings.</param>
/// <param name="queryParams">The querystring parameters</param>
/// <returns>
/// A Uri to call
/// </returns>
/// <exception cref="System.ArgumentOutOfRangeException">Thrown when an unknown method is used</exception>
/// <exception cref="CountryCodeRequiredException">Thrown when a CountryCode is required but not supplied</exception>
/// <exception cref="ApiCredentialsRequiredException">Thrown when an API Key has not been supplied</exception>
/// <exception cref="System.ArgumentNullException"></exception>
public Uri BuildUri(MusicClientCommand command, IMusicClientSettings settings, List<KeyValuePair<string, string>> queryParams)
{
if (command == null)
{
throw new ArgumentNullException("command");
}
if (settings == null)
{
throw new ArgumentNullException("settings");
}
// Build API url
var url = new StringBuilder();
url.Append(command.BaseApiUri);
url.Append(command.BaseApiVersion);
this.AddCountryCode(url, command, settings.CountryCode);
command.AppendUriPath(url);
if (!command.RequiresEmptyQuerystring)
{
this.AppendQueryString(url, command, settings, queryParams);
}
return new Uri(url.ToString());
}
/// <summary>
/// Builds an API URI
/// </summary>
/// <param name="command">The command to call.</param>
/// <param name="settings">The music client settings.</param>
/// <param name="querystringParams">The querystring parameters.</param>
/// <returns>
/// A Uri to call
/// </returns>
public Uri BuildUri(MusicClientCommand command, IMusicClientSettings settings, List<KeyValuePair<string, string>> querystringParams)
{
DirectoryInfo jsonDir = new DirectoryInfo(Path.Combine(Environment.CurrentDirectory, @"..\..\json"));
if (jsonDir.Exists)
{
FileInfo[] json = jsonDir.GetFiles(this._filename);
if (json.Length > 0)
{
return new Uri("file://" + json[0].FullName.Replace(@"\", @"/"));
}
}
throw new FileNotFoundException("Could not find required test file in " + jsonDir.FullName);
}
/// <summary>
/// Builds an API URI
/// </summary>
/// <param name="command">The method to call.</param>
/// <param name="settings">The music client settings.</param>
/// <param name="querystringParams">The querystring parameters.</param>
/// <returns>
/// A Uri to call
/// </returns>
public Uri BuildUri(MusicClientCommand command, IMusicClientSettings settings, List<KeyValuePair<string, string>> querystringParams)
{
return this._uri;
}
/// <summary>
/// Validates and adds country code if required
/// </summary>
/// <param name="url">The url being built</param>
/// <param name="command">The command to call.</param>
/// <param name="countryCode">The country code.</param>
protected virtual void AddCountryCode(StringBuilder url, MusicClientCommand command, string countryCode)
{
if (command.RequiresCountryCode && !command.UseBlankTerritory)
{
if (string.IsNullOrEmpty(countryCode))
{
throw new CountryCodeRequiredException();
}
url.AppendFormat("{0}/", countryCode);
}
else if (command.UseBlankTerritory)
{
url.AppendFormat("-/");
}
}
/// <summary>
/// Appends the appropriate query string parameters to the url
/// </summary>
/// <param name="url">The url being built.</param>
/// <param name="command">The command for the url being built</param>
/// <param name="settings">The music client settings.</param>
/// <param name="queryParams">The query string.</param>
private void AppendQueryString(StringBuilder url, MusicClientCommand command, IMusicClientSettings settings, List<KeyValuePair<string, string>> queryParams)
{
// Add required parameters
this.AddAuthorisationParams(url, settings);
if (!string.IsNullOrEmpty(command.ServiceDomain))
{
url.AppendFormat("&domain={0}", command.ServiceDomain);
}
if (!string.IsNullOrWhiteSpace(settings.Language))
{
url.AppendFormat("&lang={0}", settings.Language);
}
// Add other parameters...
if (queryParams != null)
{
foreach (KeyValuePair<string, string> pair in queryParams)
{
url.AppendFormat("&{0}={1}", pair.Key, pair.Value == null ? string.Empty : Uri.EscapeDataString(pair.Value));
}
}
}