Explanation.cs

Go to the documentation of this file.

/* 
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

using System;
using System.Collections.Generic;

namespace Lucene.Net.Search
{
    
    [Serializable]
    public class Explanation
    {
        private float value;        // the value of this node
        private System.String description;  // what it represents
        private List<Explanation> details;  // sub-explanations
        
        public Explanation()
        {
        }
        
        public Explanation(float value, System.String description)
        {
            this.value = value;
            this.description = description;
        }

        public virtual bool IsMatch
        {
            get { return (0.0f < Value); }
        }


        public virtual float Value
        {
            get { return value; }
            set { this.value = value; }
        }

        public virtual string Description
        {
            get { return description; }
            set { this.description = value; }
        }

        protected internal virtual string Summary
        {
            get { return Value + " = " + Description; }
        }

        public virtual Explanation[] GetDetails()
        {
            if (details == null)
                return null;
            return details.ToArray();
        }

        public virtual void  AddDetail(Explanation detail)
        {
            if (details == null)
                details = new List<Explanation>();
            details.Add(detail);
        }
        
        public override System.String ToString()
        {
            return ToString(0);
        }

        protected internal virtual System.String ToString(int depth)
        {
            System.Text.StringBuilder buffer = new System.Text.StringBuilder();
            for (int i = 0; i < depth; i++)
            {
                buffer.Append("  ");
            }
            buffer.Append(Summary);
            buffer.Append("\n");
            
            Explanation[] details = GetDetails();
            if (details != null)
            {
                for (int i = 0; i < details.Length; i++)
                {
                    buffer.Append(details[i].ToString(depth + 1));
                }
            }
            
            return buffer.ToString();
        }
        
        public virtual System.String ToHtml()
        {
            System.Text.StringBuilder buffer = new System.Text.StringBuilder();
            buffer.Append("<list>\n");
            
            buffer.Append("<item>");
            buffer.Append(Summary);
            buffer.Append("<br />\n");
            
            Explanation[] details = GetDetails();
            if (details != null)
            {
                for (int i = 0; i < details.Length; i++)
                {
                    buffer.Append(details[i].ToHtml());
                }
            }
            
            buffer.Append("</item>\n");
            buffer.Append("</list>\n");
            
            return buffer.ToString();
        }
        
        [Serializable]
        public abstract class IDFExplanation
        {
            public abstract float Idf { get; }

            public abstract System.String Explain();
        }
    }
}