path: root/samples/DotNetOpenAuth.ApplicationBlock/OAuth2/WindowsLive/WindowsLiveGraph.cs

//-----------------------------------------------------------------------
// <copyright file="WindowsLiveGraph.cs" company="Andrew Arnott">
//     Copyright (c) Andrew Arnott. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------

namespace DotNetOpenAuth.ApplicationBlock {
	using System;
	using System.Collections.Generic;
	using System.IO;
	using System.Linq;
	using System.Runtime.Serialization;
	using System.Runtime.Serialization.Json;
	using System.Text;

	//// Documentation: http://msdn.microsoft.com/en-us/library/live/hh243648.aspx#user

	[DataContract]
	public class WindowsLiveGraph : IOAuth2Graph {
		private static DataContractJsonSerializer jsonSerializer = new DataContractJsonSerializer(typeof(WindowsLiveGraph));

		/// <summary>
		/// Gets or sets the user's ID.
		/// </summary>
		[DataMember(Name = "id", IsRequired = true)]
		public string Id { get; set; }

		/// <summary>
		/// Gets or sets the user's full name.
		/// </summary>
		[DataMember(Name = "name", IsRequired = true)]
		public string Name { get; set; }

		/// <summary>
		/// Gets or sets the user's first name.
		/// </summary>
		[DataMember(Name = "first_name")]
		public string FirstName { get; set; }

		/// <summary>
		/// Gets or sets the user's last name.
		/// </summary>
		[DataMember(Name = "last_name")]
		public string LastName { get; set; }

		/// <summary>
		/// Gets or sets the URL of the user's profile page.
		/// </summary>
		[DataMember(Name = "link")]
		public Uri Link { get; set; }

		/// <summary>
		/// Gets or sets the day of the user's birth date, or null if no birth date is specified.
		/// </summary>
		[DataMember(Name = "birth_day")]
		public int? BirthDay { get; set; }

		/// <summary>
		/// Gets or sets the month of the user's birth date, or null if no birth date is specified.
		/// </summary>
		[DataMember(Name = "birth_month")]
		public int? BirthMonth { get; set; }

		/// <summary>
		/// Gets or sets the year of the user's birth date, or null if no birth date is specified.
		/// </summary>
		[DataMember(Name = "birth_year")]
		public int? BirthYear { get; set; }

		/// <summary>
		/// Gets or sets an array that contains the user's work info.
		/// </summary>
		[DataMember(Name = "work")]
		public WindowsLiveWorkProfile[] Work { get; set; }

		/// <summary>
		/// Gets or sets the user's gender. Valid values are "male", "female", or null if the user's gender is not specified.
		/// </summary>
		[DataMember(Name = "gender")]
		public string Gender { get; set; }

		/// <summary>
		/// Gets or sets the user's email addresses.
		/// </summary>
		[DataMember(Name = "emails")]
		public WindowsLiveEmails Emails { get; set; }

		/// <summary>
		/// Gets or sets the user's postal addresses.
		/// </summary>
		[DataMember(Name = "addresses")]
		public WindowsLiveAddresses Addresses { get; set; }

		/// <summary>
		/// Gets or sets the user's phone numbers.
		/// </summary>
		[DataMember(Name = "phones")]
		public WindowsLivePhones Phones { get; set; }

		/// <summary>
		/// Gets or sets the user's locale code.
		/// </summary>
		[DataMember(Name = "locale", IsRequired = true)]
		public string Locale { get; set; }

		/// <summary>
		/// Gets or sets the time, in ISO 8601 format, at which the user last updated the object.
		/// </summary>
		[DataMember(Name = "updated_time")]
		public string UpdatedTime { get; set; }

		public string Email {
			get {
				return this.Emails.Account;
			}
		}

		public Uri AvatarUrl { get; set; }

		public DateTime? BirthdayDT {
			get {
				if (this.BirthYear.HasValue && this.BirthMonth.HasValue && this.BirthDay.HasValue) {
					return new DateTime(this.BirthYear.Value, this.BirthMonth.Value, this.BirthDay.Value);
				}

				return null;
			}
		}

		public HumanGender GenderEnum {
			get {
				if (this.Gender == "male") {
					return HumanGender.Male;
				} else if (this.Gender == "female") {
					return HumanGender.Female;
				}

				return HumanGender.Unknown;
			}
		}

		public static WindowsLiveGraph Deserialize(string json) {
			if (string.IsNullOrEmpty(json)) {
				throw new ArgumentNullException("json");
			}

			return Deserialize(new MemoryStream(Encoding.UTF8.GetBytes(json)));
		}

		public static WindowsLiveGraph Deserialize(Stream jsonStream) {
			if (jsonStream == null) {
				throw new ArgumentNullException("jsonStream");
			}

			return (WindowsLiveGraph)jsonSerializer.ReadObject(jsonStream);
		}

		[DataContract]
		public class WindowsLiveEmails {
			/// <summary>
			/// Gets or sets the user's preferred email address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "preferred")]
			public string Preferred { get; set; }

			/// <summary>
			/// Gets or sets the email address that is associated with the account.
			/// </summary>
			[DataMember(Name = "account", IsRequired = true)]
			public string Account { get; set; }

			/// <summary>
			/// Gets or sets the user's personal email address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "personal")]
			public string Personal { get; set; }

			/// <summary>
			/// Gets or sets the user's business email address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "business")]
			public string Business { get; set; }

			/// <summary>
			/// Gets or sets the user's "alternate" email address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "other")]
			public string Other { get; set; }
		}

		[DataContract]
		public class WindowsLivePhones {
			/// <summary>
			/// Gets or sets the user's personal phone number, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "personal")]
			public string Personal { get; set; }

			/// <summary>
			/// Gets or sets the user's business phone number, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "business")]
			public string Business { get; set; }

			/// <summary>
			/// Gets or sets the user's mobile phone number, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "mobile")]
			public string Mobile { get; set; }
		}

		[DataContract]
		public class WindowsLiveAddress {
			/// <summary>
			/// Gets or sets the street address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "street")]
			public string Street { get; set; }

			/// <summary>
			/// Gets or sets the second line of the street address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "street_2")]
			public string Street2 { get; set; }

			/// <summary>
			/// Gets or sets the city of the address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "city")]
			public string City { get; set; }

			/// <summary>
			/// Gets or sets the state of the address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "state")]
			public string State { get; set; }

			/// <summary>
			/// Gets or sets the postal code of the address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "postal_code")]
			public string PostalCode { get; set; }

			/// <summary>
			/// Gets or sets the region of the address, or null if one is not specified.
			/// </summary>
			[DataMember(Name = "region")]
			public string Region { get; set; }
		}

		[DataContract]
		public class WindowsLiveAddresses {
			/// <summary>
			/// Gets or sets the user's personal postal address.
			/// </summary>
			[DataMember(Name = "personal")]
			public WindowsLiveAddress Personal { get; set; }

			/// <summary>
			/// Gets or sets the user's business postal address.
			/// </summary>
			[DataMember(Name = "business")]
			public WindowsLiveAddress Business { get; set; }
		}

		[DataContract]
		public class WindowsLiveWorkProfile {
			/// <summary>
			/// Gets or sets info about the user's employer.
			/// </summary>
			[DataMember(Name = "employer")]
			public WindowsLiveEmployer Employer { get; set; }

			/// <summary>
			/// Gets or sets info about the user's employer.
			/// </summary>
			[DataMember(Name = "position")]
			public WindowsLivePosition Position { get; set; }
		}

		[DataContract]
		public class WindowsLiveEmployer {
			/// <summary>
			/// Gets or sets the name of the user's employer, or null if the employer's name is not specified.
			/// </summary>
			[DataMember(Name = "name")]
			public string Name { get; set; }
		}

		[DataContract]
		public class WindowsLivePosition {
			/// <summary>
			/// Gets or sets the name of the user's work position, or null if the name of the work position is not specified.
			/// </summary>
			[DataMember(Name = "name")]
			public string Name { get; set; }
		}
	}
}