From 37efb9be0e23b5f7267859efd5603b6bf6135d2f Mon Sep 17 00:00:00 2001
From: richie <richie@finereport.com>
Date: Fri, 19 Feb 2016 15:21:58 +0800
Subject: [PATCH] =?UTF-8?q?echarts=E5=BC=80=E5=8F=91=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 document/echarts.md                           |  1 +
 readme.md                                     | 43 +++++++++++++++++++
 .../ui/AbstractIndependentEChartsUI.java      |  1 +
 3 files changed, 45 insertions(+)
 create mode 100644 document/echarts.md
 create mode 100644 readme.md

diff --git a/document/echarts.md b/document/echarts.md
new file mode 100644
index 0000000..b642159
--- /dev/null
+++ b/document/echarts.md
@@ -0,0 +1 @@
+# ECharts类介绍
\ No newline at end of file
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..3eaa59a
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,43 @@
+# ECharts图表插件开发文档
+
+## 关键接口解释
+
+1. `IndependentChartProvider`
+介绍:该接口的作用是扩展图表类型引擎部分,一般继承`AbstractIndependentEChartsProvider`就可以了
+2. `IndependentChartUIProvider`
+介绍:该接口的作用是扩展图表类型的设计器部分,一般继承`AbstractIndependentEChartsUI`就可以了
+
+以上两个接口,都是在plugin.xml中进行配置以扩展图表类型的,使用class属性来对应相应的扩展类,plotID属性对应图表Plot类型
+
+## 关键类解释
+每实现一种新类型的图表,都需要实现抽象类`AbstractIndependentEChartsProvider`来扩展已有的图表类型引擎以及实现抽象类`AbstractIndependentEChartsUI`类扩展已有的图表类型的设计界面.
+
+为了方便统一处理新的图表类型,我们继承内置的`com.fr.chart.chartattr.Chart`类实现一个全新的图表类[com.fr.solution.plugin.chart.echarts.ECharts](document/echarts.md).
+
+### 继承了AbstractIndependentEChartsProvider的类需要实现以下方法
+
+// 该方法用于描述图表的名字
+`public String getChartName()`
+
+// 该方法用于描述图表的显示名字,会根据不同的语言设置显示不同的名字
+`public String getChartUseName()`
+
+// 该方法用户描述图表的子类型
+`public Chart[] getChartTypes()`
+
+// 该方法用于描述图表对应的图片,一般在设计界面和图表选择界面会看到该图片
+`public String getChartImagePath()`
+
+### 继承了AbstractIndependentEChartsUI的类需要实现以下方法
+
+// 该方法用于描述图表类型选择界面(一种图表还会有若干种子类型,所以需要这个界面)
+`public AbstractChartTypePane getPlotTypePane()`
+
+// 该方法用于描述此种图表类型的使用数据集数据时的数据设置界面
+`public AbstractTableDataContentPane getTableDataSourcePane(Plot plot, ChartDataPane parent)`
+
+// 该方法用于描述此种图表类型的使用单元格数据时的数据设置界面
+`public AbstractReportDataContentPane getReportDataSourcePane(Plot plot, ChartDataPane parent)`
+
+// 该方法用户描述此种类型的图表的小图标,一般在添加表单元素的选择界面可以看到
+`public String getIconPath()`
diff --git a/src/com/fr/solution/plugin/chart/echarts/common/ui/AbstractIndependentEChartsUI.java b/src/com/fr/solution/plugin/chart/echarts/common/ui/AbstractIndependentEChartsUI.java
index a3727d1..6ec514b 100644
--- a/src/com/fr/solution/plugin/chart/echarts/common/ui/AbstractIndependentEChartsUI.java
+++ b/src/com/fr/solution/plugin/chart/echarts/common/ui/AbstractIndependentEChartsUI.java
@@ -3,6 +3,7 @@ package com.fr.solution.plugin.chart.echarts.common.ui;
 import com.fr.design.chart.fun.impl.AbstractIndependentChartUI;
 import com.fr.design.gui.frpane.AttributeChangeListener;
 import com.fr.design.mainframe.chart.AbstractChartAttrPane;
+import com.fr.design.mainframe.chart.gui.type.AbstractChartTypePane;
 
 /**
  * Created by richie on 16/2/18.