|
|
|
|
# ECharts图表插件开发文档
|
|
|
|
|
|
|
|
|
|
## 开发文档
|
|
|
|
|
[详细开发文档点击这里查看](https://kms.finedevelop.com/pages/viewpage.action?pageId=81570214&focusedCommentId=83937068#comment-83937068)
|
|
|
|
|
|
|
|
|
|
## 关键接口解释
|
|
|
|
|
|
|
|
|
|
`ChartTypeProvider`
|
|
|
|
|
|
|
|
|
|
介绍:该接口的作用是扩展图表类型引擎部分,一般继承`AbstractEChartsType`就可以了
|
|
|
|
|
|
|
|
|
|
`ChartTypeUIProvider`
|
|
|
|
|
|
|
|
|
|
介绍:该接口的作用是扩展图表类型的设计器部分,一般继承`AbstractEChartsTypeUI`就可以了
|
|
|
|
|
|
|
|
|
|
以上两个接口,都是在plugin.xml中进行配置以扩展图表类型的,使用class属性来对应相应的扩展类,plotID属性对应图表类型ID
|
|
|
|
|
|
|
|
|
|
## 关键类解释
|
|
|
|
|
|
|
|
|
|
每实现一种新类型的图表,都需要实现抽象类`AbstractEChartsType`来扩展已有的图表类型引擎以及实现抽象类`AbstractEChartsTypeUI`类扩展已有的图表类型的设计界面.
|
|
|
|
|
|
|
|
|
|
为了方便统一处理新的图表类型,我们继承内置的`com.fr.chart.impl.AbstractChartWithData`类实现一个全新的图表类[com.fr.solution.plugin.chart.echarts.common.base.AbstractECharts](echarts.md).
|
|
|
|
|
|
|
|
|
|
### 继承了AbstractEChartsType的类需要实现以下方法
|
|
|
|
|
|
|
|
|
|
// 该方法用户描述图表的子类型，饼图、玫瑰饼图等。
|
|
|
|
|
|
|
|
|
|
`public Chart[] getChartTypes()`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 继承了AbstractEChartsTypeUI的类需要实现以下方法
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表类型选择界面(一种图表还会有若干种子类型,所以需要这个界面)
|
|
|
|
|
|
|
|
|
|
[`public AbstractChartTypePane getPlotTypePane()`](echarts_type_pane.md)
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表的名字
|
|
|
|
|
|
|
|
|
|
`public String getChartName()`
|
|
|
|
|
|
|
|
|
|
// 该方法用户描述此种类型的图表的小图标,一般在添加表单元素的选择界面可以看到
|
|
|
|
|
|
|
|
|
|
`public String getIconPath()`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表的子类型的名字
|
|
|
|
|
|
|
|
|
|
`public String[] getSubName()`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表对应的图片,图表选择界面使用
|
|
|
|
|
|
|
|
|
|
`public String[] getDemoImagePath()`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述此种图表类型的数据配置界面。默认是分类系列值。
|
|
|
|
|
|
|
|
|
|
`public AbstractDataPane getChartDataPane(AttributeChangeListener listener)`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 所有新加的实现了XMLAble接口或者其子类的类,都必须要实现相等的判断方法,否者界面设计变化时无法正确检测到属性变化
|
|
|
|
|
|
|
|
|
|
`public boolean equals(Object ob)`
|
|
|
|
|
|
|
|
|
|
例如:AbstractECharts,EChartsTooltip等
|
