//============================================================ // ICOMPARABLE IMPLEMENTATION //============================================================ #region CompareTo(object obj) /// <summary> /// Compares the current instance with another object of the same type. /// </summary> /// <param name="obj">An object to compare with this instance.</param> /// <returns>A 32-bit signed integer that indicates the relative order of the objects being compared.</returns> /// <exception cref="ArgumentException">The <paramref name="obj"/> is not the expected <see cref="Type"/>.</exception> public int CompareTo(object obj) { //------------------------------------------------------------ // If target is a null reference, instance is greater //------------------------------------------------------------ if (obj == null) { return(1); } //------------------------------------------------------------ // Determine comparison result using property state of objects //------------------------------------------------------------ ApmlProfile value = obj as ApmlProfile; if (value != null) { int result = ApmlProfile.CompareSequence(this.ExplicitConcepts, value.ExplicitConcepts); result = result | ApmlProfile.CompareSequence(this.ExplicitSources, value.ExplicitSources); result = result | ApmlProfile.CompareSequence(this.ImplicitConcepts, value.ImplicitConcepts); result = result | ApmlProfile.CompareSequence(this.ImplicitSources, value.ImplicitSources); result = result | String.Compare(this.Name, value.Name, StringComparison.OrdinalIgnoreCase); return(result); } else { throw new ArgumentException(String.Format(null, "obj is not of type {0}, type was found to be '{1}'.", this.GetType().FullName, obj.GetType().FullName), "obj"); } }
/// <summary> /// Compares the current instance with another object of the same type. /// </summary> /// <param name="obj">An object to compare with this instance.</param> /// <returns>A 32-bit signed integer that indicates the relative order of the objects being compared.</returns> /// <exception cref="ArgumentException">The <paramref name="obj"/> is not the expected <see cref="Type"/>.</exception> public int CompareTo(object obj) { if (obj == null) { return(1); } ApmlProfile value = obj as ApmlProfile; if (value != null) { int result = ApmlProfile.CompareSequence(this.ExplicitConcepts, value.ExplicitConcepts); result = result | ApmlProfile.CompareSequence(this.ExplicitSources, value.ExplicitSources); result = result | ApmlProfile.CompareSequence(this.ImplicitConcepts, value.ImplicitConcepts); result = result | ApmlProfile.CompareSequence(this.ImplicitSources, value.ImplicitSources); result = result | String.Compare(this.Name, value.Name, StringComparison.OrdinalIgnoreCase); return(result); } else { throw new ArgumentException(String.Format(null, "obj is not of type {0}, type was found to be '{1}'.", this.GetType().FullName, obj.GetType().FullName), "obj"); } }
/// <summary> /// Modifies the <see cref="ApmlDocument"/> to match the data source. /// </summary> /// <param name="resource">The <see cref="ApmlDocument"/> to be filled.</param> /// <exception cref="ArgumentNullException">The <paramref name="resource"/> is a null reference (Nothing in Visual Basic).</exception> public void Fill(ApmlDocument resource) { //------------------------------------------------------------ // Validate parameter //------------------------------------------------------------ Guard.ArgumentNotNull(resource, "resource"); //------------------------------------------------------------ // Create namespace resolver //------------------------------------------------------------ XmlNamespaceManager manager = ApmlUtility.CreateNamespaceManager(this.Navigator.NameTable); //------------------------------------------------------------ // Attempt to fill syndication resource //------------------------------------------------------------ XPathNavigator headNavigator = this.Navigator.SelectSingleNode("apml:APML/apml:Head", manager); if (headNavigator != null) { resource.Head.Load(headNavigator, this.Settings); } XPathNavigator bodyNavigator = this.Navigator.SelectSingleNode("apml:APML/apml:Body", manager); if (bodyNavigator != null) { if (bodyNavigator.HasAttributes) { string defaultProfileAttribute = bodyNavigator.GetAttribute("defaultprofile", String.Empty); if (!String.IsNullOrEmpty(defaultProfileAttribute)) { resource.DefaultProfileName = defaultProfileAttribute; } } XPathNodeIterator profileIterator = bodyNavigator.Select("apml:Profile", manager); if (profileIterator != null && profileIterator.Count > 0) { int counter = 0; while (profileIterator.MoveNext()) { ApmlProfile profile = new ApmlProfile(); counter++; if (profile.Load(profileIterator.Current, this.Settings)) { if (this.Settings.RetrievalLimit != 0 && counter > this.Settings.RetrievalLimit) { break; } ((Collection<ApmlProfile>)resource.Profiles).Add(profile); } } } XPathNodeIterator applicationIterator = bodyNavigator.Select("apml:Applications/apml:Application", manager); if (applicationIterator != null && applicationIterator.Count > 0) { while (applicationIterator.MoveNext()) { ApmlApplication application = new ApmlApplication(); if (application.Load(applicationIterator.Current, this.Settings)) { resource.Applications.Add(application); } } } } SyndicationExtensionAdapter adapter = new SyndicationExtensionAdapter(this.Navigator.SelectSingleNode("apml:APML", manager), this.Settings); adapter.Fill(resource, manager); }
//============================================================ // CLASS SUMMARY //============================================================ /// <summary> /// Provides example code for the ApmlProfile class. /// </summary> public static void ClassExample() { #region ApmlProfile ApmlDocument document = new ApmlDocument(); document.DefaultProfileName = "Work"; document.Head.Title = "Example APML file for apml.org"; document.Head.Generator = "Written by Hand"; document.Head.EmailAddress = "*****@*****.**"; document.Head.CreatedOn = new DateTime(2007, 3, 11, 13, 55, 0); // Create home attention profile ApmlProfile homeProfile = new ApmlProfile(); homeProfile.Name = "Home"; homeProfile.ImplicitConcepts.Add(new ApmlConcept("attention", 0.99m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("content distribution", 0.97m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("information", 0.95m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("business", 0.93m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("alerting", 0.91m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("intelligent agents", 0.89m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("development", 0.87m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("service", 0.85m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("user interface", 0.83m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("experience design", 0.81m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("site design", 0.79m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("television", 0.77m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("management", 0.75m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitConcepts.Add(new ApmlConcept("media", 0.73m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); ApmlSource apmlSpecSource = new ApmlSource(); apmlSpecSource.Key = "http://feeds.feedburner.com/apmlspec"; apmlSpecSource.Name = "APML.org"; apmlSpecSource.Value = 1.00m; apmlSpecSource.MimeType = "application/rss+xml"; apmlSpecSource.From = "GatheringTool.com"; apmlSpecSource.UpdatedOn = new DateTime(2007, 3, 11, 13, 55, 0); apmlSpecSource.Authors.Add(new ApmlAuthor("Sample", 0.5m, "GatheringTool.com", new DateTime(2007, 3, 11, 13, 55, 0))); homeProfile.ImplicitSources.Add(apmlSpecSource); homeProfile.ExplicitConcepts.Add(new ApmlConcept("direct attention", 0.99m)); ApmlSource techCrunchSource = new ApmlSource(); techCrunchSource.Key = "http://feeds.feedburner.com/TechCrunch"; techCrunchSource.Name = "Techcrunch"; techCrunchSource.Value = 0.4m; techCrunchSource.MimeType = "application/rss+xml"; techCrunchSource.Authors.Add(new ApmlAuthor("ExplicitSample", 0.5m)); homeProfile.ExplicitSources.Add(techCrunchSource); document.AddProfile(homeProfile); // Create work attention profile ApmlProfile workProfile = new ApmlProfile(); workProfile.Name = "Work"; homeProfile.ExplicitConcepts.Add(new ApmlConcept("Golf", 0.2m)); ApmlSource workTechCrunchSource = new ApmlSource(); workTechCrunchSource.Key = "http://feeds.feedburner.com/TechCrunch"; workTechCrunchSource.Name = "Techcrunch"; workTechCrunchSource.Value = 0.4m; workTechCrunchSource.MimeType = "application/atom+xml"; workTechCrunchSource.Authors.Add(new ApmlAuthor("ProfessionalBlogger", 0.5m)); homeProfile.ExplicitSources.Add(workTechCrunchSource); document.AddProfile(workProfile); ApmlApplication sampleApplication = new ApmlApplication("sample.com"); sampleApplication.Data = "<SampleAppEl />"; document.Applications.Add(sampleApplication); #endregion }
/// <summary> /// Adds the supplied <see cref="ApmlProfile"/> to the current instance's <see cref="Profiles"/> collection. /// </summary> /// <param name="profile">The <see cref="ApmlProfile"/> to be added.</param> /// <returns><b>true</b> if the <see cref="ApmlProfile"/> was added to the <see cref="Profiles"/> collection, otherwise <b>false</b>.</returns> /// <exception cref="ArgumentNullException">The <paramref name="profile"/> is a null reference (Nothing in Visual Basic).</exception> public bool AddProfile(ApmlProfile profile) { //------------------------------------------------------------ // Local members //------------------------------------------------------------ bool wasAdded = false; //------------------------------------------------------------ // Validate parameter //------------------------------------------------------------ Guard.ArgumentNotNull(profile, "profile"); //------------------------------------------------------------ // Add profile to collection //------------------------------------------------------------ ((Collection<ApmlProfile>)this.Profiles).Add(profile); wasAdded = true; return wasAdded; }
/// <summary> /// Removes the supplied <see cref="ApmlProfile"/> from the current instance's <see cref="Profiles"/> collection. /// </summary> /// <param name="profile">The <see cref="ApmlProfile"/> to be removed.</param> /// <returns><b>true</b> if the <see cref="ApmlProfile"/> was removed from the <see cref="Profiles"/> collection, otherwise <b>false</b>.</returns> /// <remarks> /// If the <see cref="Profiles"/> collection of the current instance does not contain the specified <see cref="ApmlProfile"/>, will return <b>false</b>. /// </remarks> /// <exception cref="ArgumentNullException">The <paramref name="profile"/> is a null reference (Nothing in Visual Basic).</exception> public bool RemoveProfile(ApmlProfile profile) { //------------------------------------------------------------ // Local members //------------------------------------------------------------ bool wasRemoved = false; //------------------------------------------------------------ // Validate parameter //------------------------------------------------------------ Guard.ArgumentNotNull(profile, "profile"); //------------------------------------------------------------ // Remove profile from collection //------------------------------------------------------------ if (((Collection<ApmlProfile>)this.Profiles).Contains(profile)) { ((Collection<ApmlProfile>)this.Profiles).Remove(profile); wasRemoved = true; } return wasRemoved; }