SuperMap iDesktopX 11i 扩展开发之自定义启动程序

已于 2023-07-07 11:40:58 修改
阅读量602 收藏
点赞数
分类专栏： SuperMap 文章标签： java intellij idea 后端
于 2023-07-07 11:22:00 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/causal321/article/details/131592251
版权

目录

1. 背景

  SuperMap iDesktopX 是通过 SuperMap iObjects Java 核心库和 Java SE Development Kit（JDK）构建的一款企业级、插件式、跨平台桌面 GIS 应用与开发平台，可基于 Java 语言在 Windows 或 Linux 系统中进行扩展开发。

  SuperMap iDesktopX 应用程序是基于插件机制构建的，各个功能通过加载相应功能的插件实现，界面配置是插件 + 配置文件的方式。目前主要包含 2 种扩展开发的方式：1. 自定义启动程序扩展；2. 功能插件扩展。

  当程序启动时，后台需要一定的操作时间，在此期间，为了用户的更好体验，程序的启动界面可以友好的改善用户体验。本文主要介绍如何基于 SuperMap iDesktopX 自定义启动程序扩展开发。

2. 环境准备

  基于 SuperMap iDesktopX 进行扩展开发，所需的环境依赖均由 iDesktopX 提供，因此开发环境仅需要 iDesktopX 和 IDEA 足以满足需求。

软件版本下载地址说明
SuperMap iDesktopX11i 及其以上版本SuperMap iDesktopX 下载地址SuperMap iDesktopX 分别提供了安装包和精简绿色包 2 种，可根据实际项目需求下载合适的版本包
IntelliJ IDEA2020.3.x 及其以上版本IntelliJ IDEA 下载地址IntelliJ IDEA 是 java 编程语言的集成开发环境，在业界被公认为最好的 Java 开发工具

3. 新建项目

  SuperMap iDesktopX 的启动程序有以下 2 种创建方式：

3.1. 通过 SuperMap iDesktopX 扩展插件模板创建

  • SuperMap iDesktopX 11i 视图 菜单栏中提供了 新建二次开发工程 功能，此功能可直接基于 iDesktopX 扩展开发模板快速创建二次开发工程项目。
    新建 iDesktopX 扩展开发项目.png

  • 基于 iDesktopX 扩展开发模板新建的项目结构如下所示：
    从 iDesktopX 11i 新建的扩展开发项目结构.png

  基于 iDesktopX 扩展开发模板新建的项目，在模板中已配置 iDesktopX 扩展开发所需的环境依赖，因此无需再额外对项目配置环境依赖，可直接使用。

3.2. IDEA 新建 iDesktopX 扩展开发项目

  • IDEA 新建 Java 空项目

    • 新建项目
      IDEA 新建项目.png

    • 配置 Java 版本
      IDEA 新建 Java 项目.png

    • 不选择模板，创建空项目
      IDEA 新建 Java 空项目.png

    • 空项目结构
      IDEA 新建 Java 空项目结构.png

    • 新建自定义包
      在 src 目录下新建包.png

    • 新建入口类
      在包中新建入口类.png

    • 新建入口函数
      在入口类中添加入口函数main.png

  • 配置 iDesktopX 扩展开发环境依赖

    • 配置 iDesktopX 扩展开发依赖库

        SuperMap iDesktopX 扩展开发需要共计需要 4 个依赖库配置，分别是：

      • %SuperMap iDesktopX%\bin
      • %SuperMap iDesktopX%\lib
      • %SuperMap iDesktopX%\bundles\idesktop_bundles
      • %SuperMap iDesktopX%\bundles\require_bundles

      配置 iDesktopX 扩展开发环境依赖.png

    • 配置程序打包

        由于是 iDesktopX 启动程序扩展开发，因此打包时直接将 jar 包输出到 %SuperMap iDesktopX% 根目录位置即可，无需再输出到 iDesktopX 插件目录 （%SuperMap iDesktopX%\bundles\plugin_bundles）
      自定义启动程序打包配置.png

4. 自定义启动界面

  SuperMap iDesktopX 提供了对应的接口便于用户自定义程序启动界面以满足实际项目需求，如以下代码，其中 CStartupDialog 类是自定义的启动界面

// 设置自定义启动界面
SplashScreenUtilities splashScreenUtilitiesInstance = SplashScreenUtilities.getSplashScreenUtilitiesInstance();
splashScreenUtilitiesInstance.setStartupDialog(new CStartupDialog());

package com.supermap.startup;

import com.supermap.desktop.core.StartupDialogParameters;
import com.supermap.desktop.core.startup.IStartupDialog;
import com.supermap.desktop.core.utilties.FontUtilities;
import com.supermap.desktop.core.utilties.PathUtilities;
import com.supermap.desktop.core.utilties.ThreadUtilties;

import javax.swing.*;
import java.awt.*;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;

/**
 * 自定义 iDesktopX 11i 启动面板
 */
public class CStartupDialog extends JDialog implements IStartupDialog {

    private final JTextArea textArea;
    private boolean isDisposed = false;

    public CStartupDialog() {
        // 设置启动界面关闭功能
        addWindowListener(new WindowAdapter() {
            @Override
            public void windowClosed(WindowEvent e) {
                super.windowClosed(e);
                if (!isDisposed) {
                    System.exit(0);
                }
            }
        });
        setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE);

        setTitle("自定义启动界面");
        setBounds(0, 0, 600, 500);

        // 启动界面布局
        setLayout(new GridLayout(1, 2, 0, 0));
        JPanel leftPanel = new JPanel();
        add(leftPanel);
        JPanel rightPanel = new JPanel() {
            @Override
            protected void paintComponent(Graphics g) {
                super.paintComponent(g);

                // 绘制启动界面动画背景
                String iconPath = PathUtilities.getFullPathName("../resources/Frame/StartupIcon/Startup_Right100.gif");
                ImageIcon imageIcon = new ImageIcon(iconPath);
                Image image = imageIcon.getImage();
                g.drawImage(image, 0, 0, imageIcon.getIconWidth(), imageIcon.getIconHeight(), this);
            }
        };
        add(rightPanel);

        // 设置启动界面图标
        String iconPath = PathUtilities.getFullPathName("../resources/Frame/StartupIcon/Logo_32.png");
        ImageIcon imageIcon = new ImageIcon(iconPath);
        Image iconImage = imageIcon.getImage();
        setIconImage(iconImage);

        // 显示启动界面位置
        Toolkit toolkit = Toolkit.getDefaultToolkit();
        Dimension screenSize = toolkit.getScreenSize();
        this.setLocation(screenSize.width / 2 - this.getWidth() / 2, screenSize.height / 2 - this.getHeight() / 2);

        // 设置启动界面日志输出文本框
        Font defaultFont = FontUtilities.getDefaultFont();
        textArea = new JTextArea();
        textArea.setForeground(Color.BLACK);
        textArea.setOpaque(false);
        textArea.setEditable(false);
        textArea.setFont(defaultFont);
        textArea.setLineWrap(false);
        textArea.setWrapStyleWord(false);

        if (StartupDialogParameters.isPluginInfoVisible()) {
            JScrollPane scrollPane = new JScrollPane(textArea);
            scrollPane.setPreferredSize(new Dimension(280, 450));
            leftPanel.add(scrollPane);
        }
    }

    @Override
    public void update(String text) {
        textArea.append(text + "\n");
        textArea.setCaretPosition(textArea.getText().length());
    }

    @Override
    public void showDialog() {
        setVisible(true);
        ThreadUtilties.executeAfterDesktopVisible(this::doDispose, 1);
    }

    @Override
    public void dispose() {
        super.dispose();
    }

    public void doDispose() {
        isDisposed = true;
        dispose();
    }
}

  以上代码实现的自定义启动界面效果如下，该自定义启动界面实现仅做示例，用户可根据实际项目情况
iDesktopX 自定义启动界面.png

5. 自定义启动后操作

  当 SuperMap iDesktopX 界面加载完成后，会触发 ThreadUtilties.executeAfterDesktopVisible 绑定的事件，用户可直接在该事件中实现指定逻辑执行，如下所示，当 iDesktopX 启动后，加载指定工作空间并打开场景

ThreadUtilties.executeAfterDesktopVisible(() -> {
    // 打开默认工作空间
    Application activeApplication = Application.getActiveApplication();
    Workspace workspace = activeApplication.getWorkspace();
    WorkspaceConnectionInfo workspaceConnectionInfo = new WorkspaceConnectionInfo();
    workspaceConnectionInfo.setServer("sampleData/3D/CBDDataset/CBD.smwu");
    workspaceConnectionInfo.setType(WorkspaceType.SMWU);
    workspace.open(workspaceConnectionInfo);

    // 默认打开当前工作空间中的第一个场景
    Scenes scenes = workspace.getScenes();
    String sceneName = scenes.get(0);
    SwingUtilities.invokeLater(() -> {
        IFormScene sceneForm = (IFormScene) FormUtilities.fireNewWindowEvent(WindowType.SCENE, sceneName);
        sceneForm.openScene(sceneName);
    });
});

iDesktopX 启动后自动打开指定工作空间场景.gif

6. 修改启动方式

  SuperMap iDesktopX 提供了 2 种启动方式：1. bat (Windows) / sh (Linux) 脚本启动；2. exe (Windows) 可执行程序启动。以 Windows 操作系统为例，下面分别介绍自定义启动程序在 2 种启动方式上的应用。

  • 修改 iDesktopX 启动脚本

      iDesktopX 根目录下提供了 startup.bat 启动脚本，该脚本中默认配置的是以同级目录的 iDesktop.jar 作为启动入口，因此当自定义启动程序 CStartup.jar 包打包后，直接修改 startup.bat 启动脚本内容即可。

      仅需修改 CLASSPATH 的启动 jar 包和 java 命令启动入口类配置，如下图所示：

    修改 iDesktopX 启动脚本.png

  • 将自定义启动程序打包成 exe 可执行文件

      将 jar 包打包成 exe 可执行文件的方式有多种，用户可根据项目实际情况选择合适的方式。这里选择一种轻量级的打包工具 Launch4j 进行介绍。

      提供的 Launch4j 下载 地址中包含 launch4j.zip 程序压缩包以及 launch4j.xml 配置模板。

    Launch4j下载包结构.png

    • 将 launch4j.xml 文件放入 %SuperMap iDesktopX% 根目录

    • 双击运行 launch4j.exe 可执行程序

    • 导入 %SuperMap iDesktopX% 根目录下的 launch4j.xml 文件

    • 修改 Output file、Jar runtime path、Icon 参数配置

      修改 Launch4j 参数配置.png

    • 在 Launch4j 生成 exe 可执行文件后，可在 iDesktopX 根目录下双击执行

      Launch4j 生成的 exe 可执行文件.png

7. 总结

  本文详细介绍了如何基于 SuperMap iDesktopX 扩展开发自定义启动程序，从新建扩展开发到最终打包使用的完整流程，可供用户入门 iDesktopX 扩展开发自定义启动程序参考。

  此外，本教程还提供了根据上述教程开发的 SuperMap iDesktopX 11i 扩展开发之自定义启动程序 CStartup，也可以直接下载示例代码通过 IDEA 和 Launch4j 编译打包，调试运行。

程贤
关注
专栏目录
SuperMap iDesktopX模型数据集生成S3MB的GP模型Q&A
EliseJ的博客
12-27 1008
作者：姜尔 业务项目中，当大量模型数据汇总，需要统一发布前端浏览时，普通功能中需要多次添加数据分批缓存数据，难以避免人力损耗。此时，处理自动化GP模型的好处即可显现。构建自动化模型后，一键生成，不必人员跟随，省时省力。 本文主要介绍使用SuperMapiDesktopX搭建处理自动化模型，实现一键生成模型缓存S3MB。
SuperMap iDesktopX 11i (2023) 新特性之区域聚合图
weixin_40124722的博客
11-29 386
作者：Mei前言如果想要直观而且酷炫的展示地理信息数据空间分布上的规律，可使用单值图、类别图、渐进（数量）图、热力图等方法对数据进行渲染，但又想要在不同比例尺下缩放动态展示，比如查看某地各个区域的房价、GPD等分布情况，此时就可以用到聚合图。今年发布的iDesktopX 11.1.0版本中新增了一个专题图类别：区域聚合图。接下来就跟着小编学起来吧。
SuperMap GIS基础产品FAQ集锦(20240715)
最新发布
SuperMap技术控
07-22 1546
SuperMap GIS基础产品FAQ集锦(20240715)
SuperMap iDesktopX 11i 工作空间迁移插件详解
SuperMap技术控
12-14 397
SuperMap iDesktopX 11i 工作空间迁移插件，主要包括工作流程以及使用的关键功能点接口说明
SuperMap iDesktopX矢量金字塔
SuperMap技术控
12-29 427
实际项目经常会遇到千万级别的矢量数据，在桌面加载时小比例尺下显示速率会特别慢，缩放移动都需要长时间渲染，严重影响数据处理。SuperMap iDesktopX 11.1.0及之后的版本提供矢量金字塔功能。矢量金字塔可以大幅提升海量矢量数据在小比例尺下的显示效率，可实现地图浏览秒级响应。例如：千万级地类图斑数据创建矢量金字塔后，全幅显示性能提升10倍，全幅显示时只绘制了约14万个简化后的对象，且显示效果正确。接下来就一起来看看iDesktopX如何创建矢量金字塔吧！
SuperMap iDesktopX安装 ---（天钥普通PC机：龙芯CPU+UOS系统）
shanshanqwertyuiop的博客
06-04 1696
1.试用许可安装：新建目录/opt/SuperMap/License/ ，然后把许可拷贝到该目录即可。需要在root账户下进行操作 su root cd /opt mkdir SuperMap cd SuperMap mkdir License cp 许可文件A /opt/SuperMap/License/许可文件 2.把idesktopx拷贝到磁盘，然后解压。解压命令： tar -zxvf 安装包名称 3.启动。进入主目录，双击startup.sh 启动。 ...
SuperMap iDesktopX 11i 工作空间迁移插件
12-13
其中，"SuperMap iDesktopX 11i 工作空间迁移插件"是专为用户设计的一项重要扩展功能，它使得用户能够方便地迁移和管理基于数据库的工作空间，确保在不同环境或系统间的数据一致性与完整性。 工作空间在GIS中是至关...
SuperMap iDesktop 11i 中文帮助文档
05-29
超图产品SuperMap iDesktop 11i中文帮助手册，
SuperMap iDesktopX 11i中文帮助文档
09-14
SuperMap iDesktopX 11i中文帮助文档 官方文档 包含产品介绍、专题介绍、图文界面操作、二次开发指南、FAQ等
SuperMapiServer11i(2022)中文帮助文档
09-14
SuperMapiServer11i(2022)中文帮助文档 官方文档 包含产品介绍、使用指导、安装部署指南、支持环境、二次开发指导、FAQ等
浅谈SuperMap iDesktopX桌面扩展开发
SuperMap技术控
12-24 2718
作者：dongyx SuperMap iDesktopX是业界首款跨平台全功能桌面 GIS 软件，支持主流Linux操作系统，突破了专业桌面 GIS 软件只能运行于 Windows 环境的困境。提供空间数据生产及加工、空间大数据管理分析、可视化建模、服务发布等功能，可用于数据生产、加工、处理、分析以及制图。现在很多客户使用的场景不同，所以很多客户想利用扩展开发定制开发出属于自己应用场景的桌面软件。接下来我就谈一下如何对SuperMap iDesktopX 10.1.0版本进行定制开发。 SuperMap.
SuperMap iDesktop 11i 倾斜数据一键生成缓存
SuperMap技术控
11-22 285
作者：taco前言：在项目支持的过程中，发现会有一些客户对处理数据很烦恼。既要我设置这个参数，又要我设置那个参数，搞得头很大。为什么就不能一键三连呢？哦！不对一键跑出结果呢？对于生产数据人员，只要知道选哪个文件路径就够了。完全不想管，具体参数怎么设置啊。所以本篇文章提供了一个的工具供大家使用。
SuperMap iDesktopX 11i 提取倾斜摄影边界面
SuperMap技术控
10-12 763
提取倾斜摄影边界面
SuperMap iDesktopX 地图制图专栏目录（持续更新中）
SuperMap地图技术专栏
07-21 887
本专栏将分享地图制图相关的知识，结合SuperMap iDesktopX 软件分享一些实用制图技巧。
SuperMap iDesktopX 11i(2023) 之模型数据的材质操作
SuperMap技术控
11-29 681
SuperMap iDesktopX 11i是一款功能强大的地理信息系统软件，提供了丰富的功能和工具来处理和可视化地理数据。其中，对模型数据的材质操作是一项重要功能，它可以让用户对模型数据进行材质的设置和调整，以达到更好的可视化效果。本篇博客将介绍SuperMap iDesktopX 11i中的模型数据材质操作的相关功能，并提供一些实用的示例。
SuperMap iDesktopX 影像/栅格数据不用导入导出即可分析处理啦！
CX_Chan的博客
12-07 1685
往往下载的遥感影像都比较大，如果只想对影像/栅格进行简单的分析处理，例如裁剪、坐标系转换、坡度计算等，通过向udbx/udb数据源中导入数据集的形式往往又比较费时。那么有没有不用通过导入数据源，就能够直接对数据进行处理的方法呢？接下来小编就来讲解一下该方法是如何操作的，能够快速处理遥感/影像数据。
SuperMap iDesktopX扩展开发之GPA算子扩展
SuperMap技术控
05-30 1458
2.在IDEA中打开刚刚新建好的二次开发工程：如下图所示，SampleCode为新建工程，若勾选了导入二次开发示例代码，工程中还会加载二次开发示例模板SampleCodeTemplates目录。1.新建二次开发工程：视图->新建二次开发工程，在弹出框中设置工程名称、包名、版本等信息，选择扩展开发模板类型为GPA，该模板用于扩展GPA算子。Library Files 对话框中，同时选中以下 4 个目录，单击 OK 按钮后，选择 SampleCode，即可。选框等，用户在配置功能对话框界面时，直接调用即可。
SuperMap iDesktopX v10.1.0扩展开发指南：跨平台GIS软件的定制优势
SuperMap iDesktopX作为一款成熟的跨平台GIS开发工具，不仅在功能上表现出色，还通过灵活的扩展框架和友好的用户界面设计，为开发者和用户提供了高效、定制化的解决方案，是现代地理信息处理和可视化的重要工具。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值