Reference.cs

Go to the documentation of this file.

using System.Runtime.Serialization;
using AnalyzeRe.Attributes;
 
// ReSharper disable once CheckNamespace (Want to hide the non-generic reference
//   to discourage use, but keep this next to related reference classes.)
// ReSharper disable NonReadonlyMemberInGetHashCode
//   We only compute the hashCode the first time it's needed, then never modify it.
//   Furthermore, the ref_id of a reference should never be changed after construction,
//   it's only modifiable for deserialization purposes.
namespace AnalyzeRe.APITypes
{
    public abstract class Reference : APIType, IReference
    {
        private int? _hashCode;
 
        #region Public Properties
        [DataMember(Order = 1)]
        public string reference_type { get; protected set; }
 
        [DataMember(Order = 2)]
        public string ref_id { get; protected set; }
 
        [DataMember(Order = 3)]
        [ServerGenerated]
        public string href { get; protected set; }
        #endregion Public Properties
 
        #region Constructors
        protected Reference(string ref_id, string href)
        {
            this.ref_id = ref_id;
            this.href = href;
        }
        #endregion Constructors
 
        #region Equality and Object overrides
        public override bool Equals(object obj)
        {
            return obj is IReference objReference &&
                ref_id != null &&
                Equals(ref_id, objReference.ref_id);
        }
 
        public override int GetHashCode()
        {
            if (!_hashCode.HasValue)
                _hashCode = ref_id?.GetHashCode() ?? base.GetHashCode();
            return _hashCode.Value;
        }
 
        public override string ToString()
        {
            return ref_id ?? "(empty)";
        }
        #endregion Equality and Object overrides
    }
}