|
|
|
|
# ECharts图表插件开发文档
|
|
|
|
|
|
|
|
|
|
## 关键接口解释
|
|
|
|
|
|
|
|
|
|
`IndependentChartProvider`
|
|
|
|
|
|
|
|
|
|
介绍:该接口的作用是扩展图表类型引擎部分,一般继承`AbstractIndependentEChartsProvider`就可以了
|
|
|
|
|
|
|
|
|
|
`IndependentChartUIProvider`
|
|
|
|
|
|
|
|
|
|
介绍:该接口的作用是扩展图表类型的设计器部分,一般继承`AbstractIndependentEChartsUI`就可以了
|
|
|
|
|
|
|
|
|
|
以上两个接口,都是在plugin.xml中进行配置以扩展图表类型的,使用class属性来对应相应的扩展类,plotID属性对应图表Plot类型
|
|
|
|
|
|
|
|
|
|
## 关键类解释
|
|
|
|
|
|
|
|
|
|
每实现一种新类型的图表,都需要实现抽象类`AbstractIndependentEChartsProvider`来扩展已有的图表类型引擎以及实现抽象类`AbstractIndependentEChartsUI`类扩展已有的图表类型的设计界面.
|
|
|
|
|
|
|
|
|
|
为了方便统一处理新的图表类型,我们继承内置的`com.fr.chart.chartattr.Chart`类实现一个全新的图表类[com.fr.solution.plugin.chart.echarts.ECharts](echarts.md).
|
|
|
|
|
|
|
|
|
|
### 继承了AbstractIndependentEChartsProvider的类需要实现以下方法
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表的名字
|
|
|
|
|
|
|
|
|
|
`public String getChartName()`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表的显示名字,会根据不同的语言设置显示不同的名字
|
|
|
|
|
|
|
|
|
|
`public String getChartUseName()`
|
|
|
|
|
|
|
|
|
|
// 该方法用户描述图表的子类型
|
|
|
|
|
|
|
|
|
|
`public Chart[] getChartTypes()`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表对应的图片,一般在设计界面和图表选择界面会看到该图片
|
|
|
|
|
|
|
|
|
|
`public String getChartImagePath()`
|
|
|
|
|
|
|
|
|
|
### 继承了AbstractIndependentEChartsUI的类需要实现以下方法
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述图表类型选择界面(一种图表还会有若干种子类型,所以需要这个界面)
|
|
|
|
|
|
|
|
|
|
[`public AbstractChartTypePane getPlotTypePane()`](echarts_type_pane.md)
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述此种图表类型的使用数据集数据时的数据设置界面
|
|
|
|
|
|
|
|
|
|
`public AbstractTableDataContentPane getTableDataSourcePane(Plot plot, ChartDataPane parent)`
|
|
|
|
|
|
|
|
|
|
// 该方法用于描述此种图表类型的使用单元格数据时的数据设置界面
|
|
|
|
|
|
|
|
|
|
`public AbstractReportDataContentPane getReportDataSourcePane(Plot plot, ChartDataPane parent)`
|
|
|
|
|
|
|
|
|
|
// 该方法用户描述此种类型的图表的小图标,一般在添加表单元素的选择界面可以看到
|
|
|
|
|
|
|
|
|
|
`public String getIconPath()`
|
|
|
|
|
|
|
|
|
|
### 所有新加的实现了XMLAble接口或者其子类的类,都必须要实现相等的判断方法,否者界面设计变化时无法正确检测到属性变化
|
|
|
|
|
|
|
|
|
|
`public boolean equals(Object ob)`
|
|
|
|
|
|
|
|
|
|
例如:ECharts,EChartsTooltip等
|
