GWT Highcharts - 快速指南

GWT Highcharts - 概述

GWT Highcharts 是一个基于 Java 的开源库,可在 GWT 应用程序中提供优雅且功能丰富的 Highcharts 可视化效果,并可与 GWT 小部件库一起使用。

功能

  • 兼容 - 支持所有现代浏览器以及 iPhone/iPad 浏览器和 Internet Explorer 6 及以上版本。现代浏览器使用 SVG 进行图形渲染,而在旧版 Internet Explorer 中,图形使用 VML 绘制。

  • 纯 Java - 无需 JavaScript,因为完整的 Highcharts API 以 Java 方法提供。

  • 无 Flash - 无需 Flash 播放器或 Java 等客户端插件,因为 Highcharts 使用原生浏览器技术,图表无需修改即可在现代移动设备上运行。

  • 简洁的语法 - 大多数方法都是可链接的,因此可以使用与 JSON 一样紧密的语法来管理图表的配置选项。

  • 动态 - 图表创建后,可以随时动态添加系列和点。支持事件挂钩。支持服务器交互。

  • 文档齐全 - Highcharts API 文档齐全,包含大量代码和语法示例。

GWT Highcharts - 环境设置

本教程将指导您如何准备开发环境以开始使用 Highcharts 和 GWT Framework 进行工作。本教程还将教您如何在设置 GWT 框架之前在您的机器上设置 JDK、Tomcat 和 Eclipse −

系统要求

GWT 需要 JDK 1.6 或更高版本,因此第一个要求是在您的机器上安装 JDK。

JDK 1.6 或更高版本。
内存 无最低要求。
磁盘空间 无最低要求。
操作系统 无最低要求。

按照给定的步骤设置您的环境以开始 GWT 应用程序开发。

步骤 1 - 验证计算机上的 Java 安装

现在打开控制台并执行以下 java 命令。

操作系统 任务 命令
Windows 打开命令控制台 c:\> java -version
Linux 打开命令终端 $ java -version
Mac 打开终端 machine:~ joseph$ java -version

让我们验证所有操作系统的输出

Sr.No. 操作系统和生成的输出
1

Windows

java version "1.6.0_21"

Java(TM) SE Runtime Environment (build 1.6.0_21-b07)

Java HotSpot(TM) Client VM (build 17.0-b17, mixed mode, sharing)

2

Linux

java version "1.6.0_21"

Java(TM) SE Runtime Environment (build 1.6.0_21-b07)

ava HotSpot(TM) Client VM (build 17.0-b17, mixed mode, sharing)

3

Mac

java version "1.6.0_21"

Java(TM) SE Runtime Environment (build 1.6.0_21-b07)

Java HotSpot(TM)64-Bit Server VM (build 17.0-b17, mixed mode, sharing)

第 2 步 - 设置 Java 开发工具包 (JDK)

如果您尚未安装 Java,则可以从 Oracle 的 Java 站点安装 Java 软件开发工具包 (SDK):Java SE 下载。您将在下载的文件中找到安装 JDK 的说明,按照给出的说明安装和配置设置。最后设置 PATH 和 JAVA_HOME 环境变量以引用包含 java 和 javac 的目录,通常分别为 java_install_dir/bin 和 java_install_dir。

设置 JAVA_HOME 环境变量以指向 Java 在您的计算机上安装的基本目录位置。例如

Sr.No. OS &输出
1

Windows

将环境变量 JAVA_HOME 设置为 C:\Program Files\Java\jdk1.6.0_21

2

Linux

export JAVA_HOME = /usr/local/java-current

3

Mac

export JAVA_HOME = /Library/Java/Home

将 Java 编译器位置附加到系统路径。

Sr.No. 操作系统和输出
1

Windows

将字符串 ;%JAVA_HOME%\bin 附加到系统变量 Path 的末尾。

2

Linux

export PATH=$PATH:$JAVA_HOME/bin/

3

Mac

不必需

或者,如果您使用集成开发环境 (IDE),如 Borland JBuilder、Eclipse、IntelliJ IDEA 或 Sun ONE Studio,请编译并运行一个简单的程序以确认 IDE 知道您在哪里安装了 Java,否则请按照 IDE 的给定文档进行正确设置。

步骤 3 - 设置 Eclipse IDE

本教程中的所有示例都是使用 Eclipse IDE 编写的。因此,我建议您根据您的操作系统在您的机器上安装最新版本的 Eclipse。

要安装 Eclipse IDE,请从 https://www.eclipse.org/downloads/ 下载最新的 Eclipse 二进制文件。下载安装程序后,将二进制分发版解压到方便的位置。例如在 Windows 上是 C:\eclipse,在 Linux/Unix 上是 /usr/local/eclipse,最后适当地设置 PATH 变量。

在 Windows 机器上执行以下命令即可启动 Eclipse,或者直接双击 eclipse.exe 即可

%C:\eclipse\eclipse.exe

在 Unix(Solaris、Linux 等)机器上执行以下命令即可启动 Eclipse −

$/usr/local/eclipse/eclipse

启动成功后,如果一切正常,则应显示以下结果 −

Eclipse 主页

步骤 4:安装 GWT SDK & Eclipse 插件

按照链接Eclipse 插件(包括 SDK)中给出的说明安装 GWT SDK &安装在您机器上的 Eclipse 版本的插件。

成功设置 GWT 插件后,如果一切正常,则应显示以下屏幕,其中 Google 图标 标有红色矩形,如下所示 −

Eclipse with Google

步骤 5:安装 Highcharts

从其下载页面下载最新的 Highcharts jar 并将其添加到项目的类路径中。

在 <project-name>.gwt.xml 文件中添加以下条目

<inherits name="org.moxieapps.gwt.highcharts.Highcharts"/>

在 <project-name>.html 文件中添加以下条目

<script src = "https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"/>
<script src = "https://code.highcharts.com/highcharts.js"/>
<script type="text/javascript" src="https://code.highcharts.com/highcharts-3d.js" />
<script type="text/javascript" src="https://code.highcharts.com/highcharts-more.js" />
<script src = "https://code.highcharts.com/modules/heatmap.js" />
<script src = "https://code.highcharts.com/modules/treemap.js" />

GWT Highcharts - 配置语法

在本章中,我们将展示使用 GWT 中的 Highcharts API 绘制图表所需的配置。

步骤 1:创建 GWT 应用程序

按照以下步骤更新我们在 GWT - 创建应用程序 一章中创建的 GWT 应用程序 −

步骤 描述
1 com.tutorialspoint 包下创建一个名为 HelloWorld 的项目,如 GWT - 创建应用程序 中所述章节。
2 按照以下说明修改 HelloWorld.gwt.xmlHelloWorld.htmlHelloWorld.java。其余文件保持不变。
3 编译并运行应用程序以验证实施逻辑的结果。

以下是修改后的模块描述符 src/com.tutorialspoint/HelloWorld.gwt.xml 的内容。

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <inherits name = 'com.google.gwt.user.User'/>
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>
   <entry-point class = 'com.tutorialspoint.client.HelloWorld'/>
   <inherits name="org.moxieapps.gwt.highcharts.Highcharts"/>
   <source path = 'client'/>
   <source path = 'shared'/>
</module>

以下是修改后的 HTML 主机文件 war/HelloWorld.html 的内容。

<html>
   <head>
      <title>GWT Highcharts Showcase</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
         <script src = "https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js" />
         <script src = "https://code.highcharts.com/highcharts.js" />
      </script>
   </head>
   <body>    
   </body>
</html>

了解完配置后,我们最后会看到更新后的HelloWorld.java。

第2步:创建配置

创建图表

配置图表的类型、标题和副标题。

Chart chart = new Chart()
   .setType(Type.SPLINE)
   .setChartTitleText("Monthly Average Temperature")
   .setChartSubtitleText("Source: WorldClimate.com");

xAxis

配置要在 X 轴上显示的股票行情。

XAxis xAxis = chart.getXAxis();
xAxis.setCategories("Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec");

yAxis

配置要在 Y 轴上显示的标题、图表线。

YAxis yAxis = chart.getYAxis();
yAxis.setAxisTitleText("Temperature °C");
yAxis.createPlotLine()
   .setValue(0)
   .setWidth(1)
   .setColor("#808080");  

工具提示

配置工具提示。在值(y 轴)后添加后缀。

ToolTip toolTip = new ToolTip();
toolTip.setValueSuffix("°C");
chart.setToolTip(toolTip);

图例

配置图例,与其他属性一起显示在图表右侧。

legend.setLayout(Legend.Layout.VERTICAL)
   .setAlign(Legend.Align.RIGHT)
   .setVerticalAlign(Legend.VerticalAlign.TOP)
   .setX(-10)
   .setY(100)
   .setBorderWidth(0);
chart.setLegend(legend);

series

配置要在图表上显示的数据。Series 是一个数组,该数组的每个元素代表图表上的一条线。

chart.addSeries(chart.createSeries()
   .setName("Tokyo")
   .setPoints(new Number[] {
      7.0, 6.9, 9.5, 14.5, 18.2, 21.5, 25.2,
      26.5, 23.3, 18.3, 13.9, 9.6
   })
);

chart.addSeries(chart.createSeries()
   .setName("New York")
   .setPoints(new Number[] {
      -0.2, 0.8, 5.7, 11.3, 17.0, 22.0, 24.8, 
      24.1, 20.1, 14.1, 8.6, 2.5
   })
);

chart.addSeries(chart.createSeries()
   .setName("Berlin")
   .setPoints(new Number[] {
      -0.9, 0.6, 3.5, 8.4, 13.5, 17.0, 18.6,
      17.9, 14.3, 9.0, 3.9, 1.0
   })
);

chart.addSeries(chart.createSeries()
   .setName("London")
   .setPoints(new Number[] {
      3.9, 4.2, 5.7, 8.5, 11.9, 15.2, 17.0, 
      16.6, 14.2, 10.3, 6.6, 4.8
   })
);

步骤 3:将图表添加到父面板。

我们正在将图表添加到根面板。

RootPanel.get().add(chart);

示例

请考虑以下示例以进一步了解配置语法 −

HelloWorld.java

package com.tutorialspoint.client;

import org.moxieapps.gwt.highcharts.client.Chart;
import org.moxieapps.gwt.highcharts.client.Legend;
import org.moxieapps.gwt.highcharts.client.Series.Type;
import org.moxieapps.gwt.highcharts.client.ToolTip;
import org.moxieapps.gwt.highcharts.client.XAxis;
import org.moxieapps.gwt.highcharts.client.YAxis;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.RootPanel;

public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      Chart chart = new Chart()
         .setType(Type.SPLINE)
         .setChartTitleText("Monthly Average Temperature")
         .setChartSubtitleText("Source: WorldClimate.com");

      XAxis xAxis = chart.getXAxis();
      xAxis.setCategories("Jan", "Feb", "Mar", "Apr", "May", "Jun",
         "Jul", "Aug", "Sep", "Oct", "Nov", "Dec");

      YAxis yAxis = chart.getYAxis();
      yAxis.setAxisTitleText("Temperature °C");
      yAxis.createPlotLine()
         .setValue(0)
         .setWidth(1)
         .setColor("#808080");

      ToolTip toolTip = new ToolTip();
      toolTip.setValueSuffix("°C");
      chart.setToolTip(toolTip);

      Legend legend = new Legend();
      legend.setLayout(Legend.Layout.VERTICAL)
         .setAlign(Legend.Align.RIGHT)
         .setVerticalAlign(Legend.VerticalAlign.TOP)
         .setX(-10)
         .setY(100)
         .setBorderWidth(0);
      chart.setLegend(legend);

      chart.addSeries(chart.createSeries()
         .setName("Tokyo")
         .setPoints(new Number[] {
            7.0, 6.9, 9.5, 14.5, 18.2, 21.5, 25.2,
            26.5, 23.3, 18.3, 13.9, 9.6
         })
      );

      chart.addSeries(chart.createSeries()
         .setName("New York")
         .setPoints(new Number[] {
            -0.2, 0.8, 5.7, 11.3, 17.0, 22.0, 24.8, 
            24.1, 20.1, 14.1, 8.6, 2.5
         })
      );

      chart.addSeries(chart.createSeries()
         .setName("Berlin")
         .setPoints(new Number[] {
            -0.9, 0.6, 3.5, 8.4, 13.5, 17.0, 18.6,
            17.9, 14.3, 9.0, 3.9, 1.0
         })
      );

      chart.addSeries(chart.createSeries()
         .setName("London")
         .setPoints(new Number[] {
            3.9, 4.2, 5.7, 8.5, 11.9, 15.2, 17.0, 
            16.6, 14.2, 10.3, 6.6, 4.8
         })
      );
      RootPanel.get().add(chart);
   }
}

结果

验证结果。

基本折线图

GWT Highcharts - 折线图

折线图用于绘制基于线/样条线的图表。在本节中,我们将讨论不同类型的基于线和样条线的图表。

Sr.No. 图表类型和描述
1 基本折线图

基本折线图。

2 带有数据标签

带有数据标签的图表。

3 时间序列,可缩放

带有时间序列的图表。

4 带倒置轴的样条线

具有倒置轴的样条线图。

5 带符号的样条线

使用符号表示热量/雨水的样条线图。

6 带绘图带的样条线

带绘图带的样条线图。

GWT Highcharts - 面积图

面积图用于绘制基于面积的图表。在本节中,我们将讨论不同类型的基于面积的图表。

Sr.No. 图表类型和描述
1 基本面积图

基本面积图。

2 具有负值的区域图

具有负值的面积图。

3 堆叠面积图

堆叠面积图另一个。

4 百分比面积

以百分比表示的数据图表。

5 缺少点的区域

数据中缺少点的图表。

6 倒置轴

使用倒置的轴。

7 面积样条线

使用样条线的面积图。

GWT Highcharts - 条形图

条形图用于绘制基于条形的图表。在本节中,我们将讨论不同类型的基于条形的图表。

Sr.No. 图表类型和描述
1 基本条形图

基本条形图。

2 堆叠条形图

条形图相互堆叠。

3 带负值的条形图

带负值的条形图值。

GWT Highcharts - 柱形图

柱形图用于绘制基于柱形的图表。在本节中,我们将讨论不同类型的基于柱形的图表。

Sr.No. 图表类型和描述
1 基本柱形图

基本柱形图。

2 具有负值的柱形图

具有负值的柱形图。

3 堆叠柱形图

柱形图堆叠在一个柱形图上另一个。

4 堆叠和分组列

带有堆叠和分组形式的列的图表。

5 带有堆叠百分比的列

带有堆叠百分比的图表。

6 带有旋转的列标签

列中带有旋转标签的柱形图。

7 列范围

使用范围的柱形图。

GWT Highcharts - 饼图

饼图用于绘制基于饼图的图表。在本节中,我们将讨论不同类型的基于饼图的图表。

Sr.No. 图表类型和描述
1 基本饼图

基本饼图。

2 带图例的饼图

带图例的饼图。

3 甜甜圈图

甜甜圈图表。

GWT Highcharts - 散点图

以下是基本散点图的示例。

我们已经在Highcharts 配置语法一章中看到了用于绘制图表的配置。

下面给出了一个基本散点图的示例。

配置

现在让我们看看其他配置/采取的步骤。

series

将图表类型配置为基于散点图。series.type 决定图表的系列类型。此处,默认值为"line"。

chart.addSeries(chart.createSeries()  
   .setName("Observations")  
   .setType(Type.SCATTER)  
   .setPoints(new Number[] {  
      1, 1.5, 2.8, 3.5, 3.9, 4.2  
   })  
);  

示例

HelloWorld.java

package com.tutorialspoint.client;

import org.moxieapps.gwt.highcharts.client.Chart;
import org.moxieapps.gwt.highcharts.client.Series.Type;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.RootPanel;

public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      final Chart chart = new Chart()  
         .setChartTitleText("Scatter plot");  

      chart.getXAxis()  
         .setMin(-0.5)  
         .setMax(5.5);  

      chart.getYAxis()  
         .setMin(0);  

      chart.addSeries(chart.createSeries()  
         .setName("Observations")  
         .setType(Type.SCATTER)  
         .setPoints(new Number[] {  
            1, 1.5, 2.8, 3.5, 3.9, 4.2  
         })  
      );  
      RootPanel.get().add(chart);
   }
}

结果

验证结果。

散点图

GWT Highcharts - 动态图表

动态图表用于绘制基于数据的图表,其中数据在图表呈现后可以更改。在本节中,我们将讨论不同类型的动态图表。

Sr.No. 图表类型和描述
1 样条线每秒更新一次

样条线图每秒更新一次。

2 单击以添加点

具有点添加功能的图表。

GWT Highcharts - 组合图表

组合图表用于绘制混合图表;例如,条形图和饼图。在本节中,我们将讨论不同类型的组合图表。

Sr.No. 图表类型和描述
1 柱形图、折线图和饼图

带有柱形图、折线图和饼图的图表。

2 双轴、折线图和柱形图

带有双轴、折线图和柱形图的图表。

3 多个轴

具有多个轴的图表。

4 带回归线的散点图

带回归线的散点图。

GWT Highcharts - 3D 图表

3D 图表用于绘制三维图表。在本节中,我们将讨论不同类型的 3D 图表。

Sr.No. 图表类型 &描述
1 3D 柱形图

3D 柱形图。

2 3D 散点图

3D 散点图。

3 3D 饼图

3D 饼图图表。

GWT Highcharts - 地图

地图图表用于绘制热图或树形图。在本节中,我们将讨论不同类型的地图图表。

Sr.No. 图表类型 &描述
1 热图

热图。

2 树形图

树形图。