MPAndroidChart系列源码解读（二）

util工具包已看完，下面准备Interface接口定义理解，以便于下次data包的理解，先打好基础再说

dataprovider

ChartInterface

数据提供接口，在众多接口中我们先从基类接口入手，ChartInterface定义了Chart需要用到的基本方法（上图UML拖拽到新窗口查看可以清晰查看不受压缩影响）

/** * 该接口提供chart视图已知的尺寸、界限、范围、 * Interface that provides everything there is to know about the dimensions, * bounds, and range of the chart. * * @author Philipp Jahoda */
public interface ChartInterface {

    /** * 不管放大还是平移，返回x轴的x最小值 * Returns the minimum x-value of the chart, regardless of zoom or translation. * * @return */
    float getXChartMin();

    /** * 不管放大还是平移，返回x轴的x最大值 * Returns the maximum x-value of the chart, regardless of zoom or translation. * * @return */
    float getXChartMax();

    /** * 不管放大还是平移，返回y轴的y最小值 * Returns the minimum y-value of the chart, regardless of zoom or translation. * * @return */
    float getYChartMin();

    /** * 不管放大还是平移，返回y轴的y最大值 * Returns the maximum y-value of the chart, regardless of zoom or translation. * * @return */
    float getYChartMax();

    /** * x轴上的描绘的所有值的size * @return */
    int getXValCount();


    int getWidth();

    int getHeight();

    /** * 获取Chart的中心点 * @return */
    PointF getCenterOfView();

    /** * 获取chart的中心点，考虑了偏移量因素 * @return */
    PointF getCenterOffsets();

    /** * 获取内容视图的Rect测量到的范围 * @return */
    RectF getContentRect();

    /** * chart图标labText被绘制之前，定制自己的格式，这里已经有了一个默认的格式DefaultValueFormatter实例 * @return */
    ValueFormatter getDefaultValueFormatter();

    /** *返回已设置图表的chartdata对象 * @return */
    ChartData getData();
}

BarLineScatterCandleBubbleDataProvider

Line Scatter Candle Bubble的公共数据提供者，而各自的具体实现继承该父类

public interface BarLineScatterCandleBubbleDataProvider extends ChartInterface {

    /** * 根据AxisDependency获取构造函数内初始化的矩阵变换器 * AxisDependency LEFT RIGHT:枚举指定数据集应绘制轴，或左或右 * @param axis * @return */
    Transformer getTransformer(AxisDependency axis);

    /** * 获取显示的最大数量 * @return */
    int getMaxVisibleCount();

    /** * 是否颠倒反向 * AxisBase基类下面的两个子类YAxis XAxis，根据AxisDependency方向选择子类调用其自身isInverted * @param axis * @return */
    boolean isInverted(AxisDependency axis);

    /** * x轴上的值（最小）的可见性 * @return */
    int getLowestVisibleXIndex();

    /** * x轴上的值（最大）的可见性 * @return */
    int getHighestVisibleXIndex();

    /** * 获取封装数据的对象,在chart通过泛型获取对象 * @return */
    BarLineScatterCandleBubbleData getData();
}

BarDataProvider

BarDataProvider内部方法并没有在BarChart里面直接调用，通过find usages发现基本都是在Renderer子类调用，具体下次细解

public interface BarDataProvider extends BarLineScatterCandleBubbleDataProvider {

    /** * BarChart所需要的BarData数据对象（setData传入） * @return */
    BarData getBarData();

    /** * 是否能绘制阴影 * @return */
    boolean isDrawBarShadowEnabled();

    /** * 是否绘制在bar上面的值 * @return */
    boolean isDrawValueAboveBarEnabled();

    /** * 绘制判断是否允许高亮显示 * @return */
    boolean isDrawHighlightArrowEnabled();
}

BubbleDataProvider

public interface BubbleDataProvider extends BarLineScatterCandleBubbleDataProvider {

    /** * 弹出泡泡类的Chart的数据对象 * * @return */
    BubbleData getBubbleData();
}

CandleDataProvider

public interface CandleDataProvider extends BarLineScatterCandleBubbleDataProvider {

    /** * 烛形物图标类的数据 * @return */
    CandleData getCandleData();
}

LineDataProvider

public interface LineDataProvider extends BarLineScatterCandleBubbleDataProvider {

    /** * LineChar图表的数据对象 * @return */
    LineData getLineData();

    /** * Y轴的数据封装对象 * @param dependency * @return */
    YAxis getAxis(YAxis.AxisDependency dependency);
}

ScatterDataProvider

public interface ScatterDataProvider extends BarLineScatterCandleBubbleDataProvider {

    /** * 分散性图表的数据对象 * @return */
    ScatterData getScatterData();
}

datasets

数据设置相关接口，下面是他们之间的关系的uml图，碍于截图问题一分为二，抱歉！！（如果你的浏览器支持缩放页面可以放大后查看清晰uml图结构）

IDataSet

/** * Created by Philipp Jahoda on 21/10/15. */
public interface IDataSetextends Entry> {

    /** ###### ###### DATA RELATED METHODS ###### ###### */

    /** * 返回Y轴上的最小值 * returns the minimum y-value this DataSet holds * * @return */
    float getYMin();

    /** * 返回Y轴上的最大值 * returns the maximum y-value this DataSet holds * * @return */
    float getYMax();

    /** * 返回Y轴上的显示数据Entry的总数量 * Returns the number of y-values this DataSet represents -> the size of the y-values array * -> yvals.size() * * @return */
    int getEntryCount();

    /** * 根据索引计算出索引范围内值的最大值和最小值 * Calculates the minimum and maximum y value (mYMin, mYMax). From the specified starting to ending index. * * @param start starting index in your data list * @param end ending index in your data list */
    void calcMinMax(int start, int end);

    /** * 根据索引值返回Entry，如果没有索引对应的对象则返回最近的对象，如果没有对象则返回空，建议不要过度使用 * Returns the first Entry object found at the given xIndex with binary * search. If the no Entry at the specified x-index is found, this method * returns the index at the closest x-index. Returns null if no Entry object * at that index. INFORMATION: This method does calculations at runtime. Do * not over-use in performance critical situations. * * @param xIndex * @param rounding determine to round up/down/closest if there is no Entry matching the provided x-index * @return */
    T getEntryForXIndex(int xIndex, DataSet.Rounding rounding);

    T getEntryForXIndex(int xIndex);

    List getEntriesForXIndex(int xIndex);

    T getEntryForIndex(int index);

    int getEntryIndex(int xIndex, DataSet.Rounding rounding);

    int getEntryIndex(T e);

    float getYValForXIndex(int xIndex);

    float[] getYValsForXIndex(int xIndex);

     int getIndexInEntries(int xIndex);

    /** * 动态添加到数据集的结尾。这也将重新计算最小值和最大值、count * Adds an Entry to the DataSet dynamically. * Entries are added to the end of the list. * This will also recalculate the current minimum and maximum * values of the DataSet and the value-sum. * * @param e */
    boolean addEntry(T e);

    /** * 删除一条数据，如果成功了要重新计算最大值和最小值以及数据集的count * Removes an Entry from the DataSets entries array. This will also * recalculate the current minimum and maximum values of the DataSet and the * value-sum. Returns true if an Entry was removed, false if no Entry could * be removed. * * @param e */
    boolean removeEntry(T e);

    /** * 有序添加一条数据，并且要重新计算最大值和最小值以及数据集的count * Adds an Entry to the DataSet dynamically. * Entries are added to their appropriate index respective to it's x-index. * This will also recalculate the current minimum and maximum * values of the DataSet and the value-sum. * * @param e */
    void addEntryOrdered(T e);

    /** * 移除第一条数据 * Removes the first Entry (at index 0) of this DataSet from the entries array. * Returns true if successful, false if not. * * @return */
    boolean removeFirst();

    /** * 移除最后一条数据 * Removes the last Entry (at index size-1) of this DataSet from the entries array. * Returns true if successful, false if not. * * @return */
    boolean removeLast();

    /** * 移除数据集指定位置的数据对象 * Removes the Entry object that has the given xIndex from the DataSet. * Returns true if an Entry was removed, false if no Entry could be removed. * * @param xIndex */
    boolean removeEntry(int xIndex);

    /** * 检查数据集是否包含指定对象，在性能不好的情况下不建议使用 * Checks if this DataSet contains the specified Entry. Returns true if so, * false if not. NOTE: Performance is pretty bad on this one, do not * over-use in performance critical situations. * * @param entry * @return */
    boolean contains(T entry);

    /** * 清除所有的DataSet值，不用再重新计算 * Removes all values from this DataSet and does all necessary recalculations. */
    void clear();


    /** ###### ###### STYLING RELATED (& OTHER) METHODS ###### ###### */

    /** * 获取描述数据集的标签值 * Returns the label string that describes the DataSet. * * @return */
    String getLabel();

    /** * 设置描述数据集的标签 * Sets the label string that describes the DataSet. * * @param label */
    void setLabel(String label);

    /** * 获取轴的方向 * Returns the axis this DataSet should be plotted against. * * @return */
    YAxis.AxisDependency getAxisDependency();

    /** * 设置轴方向 * Set the y-axis this DataSet should be plotted against (either LEFT or * RIGHT). Default: LEFT * * @param dependency */
    void setAxisDependency(YAxis.AxisDependency dependency);

    /** * 获取所有数据对应的颜色值集合 * returns all the colors that are set for this DataSet * * @return */
    List getColors();

    /** * 获取给定数据集的颜色 * Returns the first color (index 0) of the colors-array this DataSet * contains. This is only used for performance reasons when only one color is in the colors array (size == 1) * * @return */
    int getColor();

    /** * 给定数据集的索引颜色值 * Returns the color at the given index of the DataSet's color array. * Performs a IndexOutOfBounds check by modulus. * * @param index * @return */
    int getColor(int index);

    /** * 判断是否支持高亮显示 * returns true if highlighting of values is enabled, false if not * * @return */
    boolean isHighlightEnabled();

    /** * 设置触摸是否支持高亮显示 * If set to true, value highlighting is enabled which means that values can * be highlighted programmatically or by touch gesture. * * @param enabled */
    void setHighlightEnabled(boolean enabled);

    /** * 设置用于绘制图表的格式化值类。如果没有格式化设置，图表会自动确定选择默认的格式（关于小数）的所有值，getdefaultvalueformatter() * Sets the formatter to be used for drawing the values inside the chart. If * no formatter is set, the chart will automatically determine a reasonable * formatting (concerning decimals) for all the values that are drawn inside * the chart. Use chart.getDefaultValueFormatter() to use the formatter * calculated by the chart. * * @param f */
    void setValueFormatter(ValueFormatter f);

    /** * 获取格式化类 * Returns the formatter used for drawing the values inside the chart. * * @return */
    ValueFormatter getValueFormatter();

    /** * 设置文字颜色 * Sets the color the value-labels of this DataSet should have. * * @param color */
    void setValueTextColor(int color);

    /** * 设置文字颜色（不同位置对应文字的不同颜色值） * Sets a list of colors to be used as the colors for the drawn values. * * @param colors */
    void setValueTextColors(List colors);

    /** * 设置字体 * Sets a Typeface for the value-labels of this DataSet. * * @param tf */
    void setValueTypeface(Typeface tf);

    /** * 设置文字大小 * Sets the text-size of the value-labels of this DataSet in dp. * * @param size */
    void setValueTextSize(float size);

    /** * 返回图表上的文字颜色 * Returns only the first color of all colors that are set to be used for the values. * * @return */
    int getValueTextColor();

    /** * 返回图表上index对应位置的文字颜色 * Returns the color at the specified index that is used for drawing the values inside the chart. * Uses modulus internally. * * @param index * @return */
    int getValueTextColor(int index);

    /** * 返回图表上文字的字体 * Returns the typeface that is used for drawing the values inside the chart * * @return */
    Typeface getValueTypeface();

    /** * 返回chart图表上的文字大小 * Returns the text size that is used for drawing the values inside the chart * * @return */
    float getValueTextSize();

    /** * 动态设置Y轴的值是否要绘制 * set this to true to draw y-values on the chart NOTE (for bar and * linechart): if "maxvisiblecount" is reached, no values will be drawn even * if this is enabled * * @param enabled */
    void setDrawValues(boolean enabled);

    /** * 是否绘制Y轴的值 * Returns true if y-value drawing is enabled, false if not * * @return */
    boolean isDrawValuesEnabled();

    /** * 动态设置DataSet的可见性 * Set the visibility of this DataSet. If not visible, the DataSet will not * be drawn to the chart upon refreshing it. * * @param visible */
    void setVisible(boolean visible);

    /** * 在chart中是否可见，默认隐藏 * Returns true if this DataSet is visible inside the chart, or false if it * is currently hidden. * * @return */
    boolean isVisible();
}

IBarLineScatterCandleBubbleDataSet

/** * Created by philipp on 21/10/15. */
public interface IBarLineScatterCandleBubbleDataSet<T extends Entry> extends IDataSet<T> {

    /** * 返回绘制高亮显示的颜色值 * Returns the color that is used for drawing the highlight indicators. * * @return */
    int getHighLightColor();
}

IBarDataSet

/** * Created by philipp on 21/10/15. */
public interface IBarDataSet extends IBarLineScatterCandleBubbleDataSet {

    /** * 返回Bar直接的间隙 * Returns the space between bars as the actual value (0 - 1.0f) * * @return */
    float getBarSpace();

    /** * 是否放进堆栈 * Returns true if this DataSet is stacked (stacksize > 1) or not. * * @return */
    boolean isStacked();

    /** * 返回的最大条数 * Returns the maximum number of bars that can be stacked upon another in * this DataSet. This should return 1 for non stacked bars, and > 1 for stacked bars. * * @return */
    int getStackSize();

    /** * bar的阴影颜色 * Returns the color used for drawing the bar-shadows. The bar shadows is a * surface behind the bar that indicates the maximum value. * * @return */
    int getBarShadowColor();

    /** * bar边框的宽度 * Returns the width used for drawing borders around the bars. * If borderWidth == 0, no border will be drawn. * * @return */
    float getBarBorderWidth();

    /** * 绘制bar边框有暗色 * Returns the color drawing borders around the bars. * * @return */
    int getBarBorderColor();

    /** * 高亮显示的透明度 * Returns the alpha value (transparency) that is used for drawing the * highlight indicator. * * @return */
    int getHighLightAlpha();


    /** * 柱状图相关的，LegendRenderer准备所需要的标签文字和颜色时会被调用 * Returns the labels used for the different value-stacks in the legend. * This is only relevant for stacked bar entries. * * @return */
    String[] getStackLabels();
}

IBubbleDataSet

/** * Created by philipp on 21/10/15. */
public interface IBubbleDataSet extends IBarLineScatterCandleBubbleDataSet {

    /** * 设置泡泡的宽度 * Sets the width of the circle that surrounds the bubble when highlighted, * in dp. * * @param width */
    void setHighlightCircleWidth(float width);

    /** * X轴最大值 * @return */
    float getXMax();

    /** * X轴最小值 * @return */
    float getXMin();

    /** * 用于计算shapeSize * @return */
    float getMaxSize();

    boolean isNormalizeSizeEnabled();

    /** * 泡泡的宽度 * Returns the width of the highlight-circle that surrounds the bubble * @return */
    float getHighlightCircleWidth();
}

ICandleDataSet

/** * Created by philipp on 21/10/15. */
public interface ICandleDataSet extends ILineScatterCandleRadarDataSet {


    float getBarSpace();

    boolean getShowCandleBar();

    float getShadowWidth();

    int getShadowColor();

    int getNeutralColor();

    int getIncreasingColor();

    int getDecreasingColor();

    /** * 画笔的style（打开时） * Returns paint style when open < close * * @return */
    Paint.Style getIncreasingPaintStyle();

    /** * 画笔的Style（关闭时） * Returns paint style when open > close * * @return */
    Paint.Style getDecreasingPaintStyle();

    /** * CandleChart图表的阴影颜色 * Is the shadow color same as the candle color? * * @return */
    boolean getShadowColorSameAsCandle();
}

ILineDataSet

/** * Created by Philpp Jahoda on 21/10/15. */
public interface ILineDataSet extends ILineRadarDataSet {

    /** *线的绘制模式 * * @return */
    LineDataSet.Mode getMode();
    float getCubicIntensity();

    @Deprecated
    boolean isDrawCubicEnabled();

    @Deprecated
    boolean isDrawSteppedEnabled();

    float getCircleRadius();

    int getCircleColor(int index);

    boolean isDrawCirclesEnabled();

    int getCircleHoleColor();

    /** *是否启用小圆点 * * @return */
    boolean isDrawCircleHoleEnabled();

    /** * Returns the DashPathEffect that is used for drawing the lines. * * @return */
    DashPathEffect getDashPathEffect();

    /** *是否启用虚线效果 * Returns true if the dashed-line effect is enabled, false if not. * If the DashPathEffect object is null, also return false here. * * @return */
    boolean isDashedLineEnabled();

    /** * 返回填充的formatter * Returns the FillFormatter that is set for this DataSet. * * @return */
    FillFormatter getFillFormatter();
}

ILineRadarDataSet

/** * Created by Philipp Jahoda on 21/10/15. */
public interface ILineRadarDataSetextends Entry> extends ILineScatterCandleRadarDataSet {

    /** * 填充颜色 * * @return */
    int getFillColor();

    /** * 填充图Drawable * * @return */
    Drawable getFillDrawable();

    /** * 填充透明度默认值85 * * @return */
    int getFillAlpha();

    float getLineWidth();

    /** * 数据集是否画满（表面） * * @return */
    boolean isDrawFilledEnabled();

    /** * 设置为true,如果数据集应该画满(表面),,禁用将带来巨大的性能提升。请注意,这个方法使用canvas.clipPath(…)方法来画填充区域。 * 设备与API级别< 18(Android 4.3),硬件加速的图表被关闭。默认值是错误的 * @param enabled */
    void setDrawFilled(boolean enabled);
}

ILineScatterCandleRadarDataSet

/** * Created by Philipp Jahoda on 21/10/15. */
public interface ILineScatterCandleRadarDataSetextends Entry> extends IBarLineScatterCandleBubbleDataSet {

    /** * 是否垂直突出标线 * Returns true if vertical highlight indicator lines are enabled (drawn) * @return */
    boolean isVerticalHighlightIndicatorEnabled();

    /** * 是否水平突出标线 * Returns true if vertical highlight indicator lines are enabled (drawn) * @return */
    boolean isHorizontalHighlightIndicatorEnabled();

    /** *返回高亮显示是线宽 * Returns the line-width in which highlight lines are to be drawn. * @return */
    float getHighlightLineWidth();

    /** * 高亮破折线 * Returns the DashPathEffect that is used for highlighting. * @return */
    DashPathEffect getDashPathEffectHighlight();
}

IPieDataSet

/** * Created by Philipp Jahoda on 03/11/15. */
public interface IPieDataSet extends IDataSet {

    /** * 获取饼图间距 * Returns the space that is set to be between the piechart-slices of this * DataSet, in pixels. * * @return */
    float getSliceSpace();

    /** * 选中的饼状图的位移量 * Returns the distance a highlighted piechart slice is "shifted" away from * the chart-center in dp. * * @return */
    float getSelectionShift();

    /** * 获取X值在饼状图的位置是内部还是外部 * * @return */
    PieDataSet.ValuePosition getXValuePosition();

    /** * 获取Y值在饼状图的位置是内部还是外部 * * @return */
    PieDataSet.ValuePosition getYValuePosition();

    /** * 饼状图外部指示线的颜色 * When valuePosition is OutsideSlice, indicates line color */
    int getValueLineColor();

    /** * 饼状图外部指示线的宽度 * When valuePosition is OutsideSlice, indicates line width */
    float getValueLineWidth();

    /** * 饼状图外部指示线的偏移百分比对应大小 * When valuePosition is OutsideSlice, indicates offset as percentage out of the slice size */
    float getValueLinePart1OffsetPercentage();
    float getValueLinePart1Length();
    float getValueLinePart2Length();
    boolean isValueLineVariableLength();

}

IRadarDataSet

/** * 透明度 stoke相关属性配置 * Created by Philipp Jahoda on 03/11/15. */
public interface IRadarDataSet extends ILineRadarDataSet<Entry> {

    /// flag indicating whether highlight circle should be drawn or not
    boolean isDrawHighlightCircleEnabled();

    /// Sets whether highlight circle should be drawn or not
    void setDrawHighlightCircleEnabled(boolean enabled);

    int getHighlightCircleFillColor();

    /// The stroke color for highlight circle.
    /// If Utils.COLOR_NONE, the color of the dataset is taken.
    int getHighlightCircleStrokeColor();

    int getHighlightCircleStrokeAlpha();

    float getHighlightCircleInnerRadius();

    float getHighlightCircleOuterRadius();

    float getHighlightCircleStrokeWidth();

}

IScatterDataSet

/** * Created by philipp on 21/10/15. */
public interface IScatterDataSet extends ILineScatterCandleRadarDataSet {

    /** * shape的size大小 * Returns the currently set scatter shape size * * @return */
    float getScatterShapeSize();

    /** * 获取ScatterShape * Returns all the different scattershapes the chart uses * * @return */
    ScatterChart.ScatterShape getScatterShape();

    /** * ScatterChart的shape的半径 * Returns radius of the hole in the shape * * @return */
    float getScatterShapeHoleRadius();

    /** * ScatterChart的shape颜色值 * Returns the color for the hole in the shape * * @return */
    int getScatterShapeHoleColor();
}

不得不承认，这篇写的非常搓的，感觉就是流水代码，感觉个别方法解释有误，欢迎指出！！不要看得太仔细，简单的一晃而过吧