首页 > 其他分享 >Jmix 如何将外部数据直接显示在界面?

Jmix 如何将外部数据直接显示在界面?

时间:2023-04-07 11:22:14浏览次数:37  
标签:存储 Task 界面 外部 Jmix Project DTO 数据 public

题图

企业级应用中,通常一个业务系统并不是孤立存在的,而是需要与企业、部门或者是外部的已有系统进行集成。一般而言,系统集成的数据和接口交互方式通常有以下几种:

  1. 文件传输:通过文件传输的方式将数据传递给其他系统,例如使用 FTP 或 SFTP 等协议传送文件。这种交互方式适合单向或批量数据传输。
  2. Web 服务 API:使用 API 与其他系统进行通信,一般采用 SOAP 或 REST 等通信协议。这种交互方式可用于实现单向或双向数据传输。
  3. 数据库交互:使用数据库共享的方式,或者通过数据库连接进行数据交换。这种交互方式在双向数据同步和实时数据交换方面非常有效。但是一定要注意数据权限控制和数据安全。
  4. 消息队列:通过消息队列进行数据的收发,而无需与其他系统直接通信。消息队列可用于处理大量数据以及异步数据传输的情况。

不论使用那种方式进行通信和传输,在主系统(即,正在实施的系统)中,还需要考虑的一个问题是,第三方系统过来的数据需不需要保存?如果主系统要基于接入的数据进行进一步处理,则通常需要保存数据。而有时候由于数据安全方面的原因,亦或是考虑到本地存储数据后还存在数据同步与重复存储的问题,第三方系统的数据过来后,主系统并不需要存储数据,只是提供展示和操作界面。

本文中,我们以常见的 REST API 通信为例,看看 Jmix 应用是如何直接使用外部数据的(这里我们不存储外部数据)。

外部数据源

我们假设外部数据源通过 REST API 提供关于项目(project)和任务(task)的 CRUD 接口。

定义 DTO 和 Service

首先,我们在主系统中定义两个 DTO 实体:ProjectTask,用 Jmix Studio 可以直接创建 DTO 实体:

Studio 创建 DTO

然后,在主系统中我们需要定义两个 Services,专门用来对 ProjectTask 实体进行 CRUD 操作,而这些操作里面,其实是调用了外部系统提供的 REST 接口,以 TaskService 为例:

@Component
public class TaskService {

    public static final String TASKS_BASE_URL = "http://localhost:18080/tasks";

    @Autowired
    private RestTemplate restTemplate;

    public List<Task> loadTasks() {
        Task[] tasks = restTemplate.getForObject(TASKS_BASE_URL, Task[].class);
        return Arrays.asList(tasks);
    }

    public Task saveTask(Task task) {
        String url = task.getId() != null ?
                TASKS_BASE_URL + "/"  + task.getId() :
                TASKS_BASE_URL;
        ResponseEntity<Task> response = restTemplate.postForEntity(url, task, Task.class);
        return response.getBody();
    }

    public void deleteTask(Task task) {
        restTemplate.delete(TASKS_BASE_URL + "/" + task.getId());
    }
}

Project DTO 的创建过程和 ProjectService 的内容与上面步骤类似,这里就不再赘述。

第一种方式:使用代理

第一种方式是使用数据加载代理和提交代理方法,将原本使用 DataManager 进行数据加载和写入的相应方法替换为使用我们自定义的服务:

使用代理的方式

这里,我们选择 Task DTO 和它的列表页和编辑页作为示例。

首先,在列表页添加数据加载的代理,在界面选中数据加载器后,双击代理方法中的 <empty> 标签,Studio 会自动生成方法并跳转到方法定义,添加自定义逻辑:

加载数据代理

然后,在编辑页添加数据提交代理,这里需要在 XML 中选中 data 节点,然后双击生成 commitDelegate

保存数据代理

这样就完成了我们需要实现的功能。是不是很简单?

第二种方式:自定义数据存储

Jmix 中,数据存储可以进行自定义,通过自定义的数据存储,可以像处理 JPA 实体一样,使用 DataManager 处理 DTO 实体。在检测到 DTO 实体关联到某个自定义存储后,DataManager 会将 CRUD 操作都通过代理执行,并且能处理对 DTO 实体的引用。具体实现框架如下:

使用自定义数据存储的方式

可以看到,使用这种方式不需要对界面中的实体操作进行拦截,而是将所有对于外部系统的接口调用都交给 DataManager 通过数据存储进行分发。

这里,我们选择 Project DTO 作为示例,创建相应的数据存储:

  1. 创建 ProjectDataStore 实现 DataStore 接口:
@Component("sample_ProjectDataStore")
@Scope(BeanDefinition.SCOPE_PROTOTYPE)
public class ProjectDataStore implements DataStore {

    // 注入 ProjectService 用于具体的操作
    @Autowired
    private ProjectService projectService;

    // 后面需要实现接口中的方法,主要是通过 projectService 对数据进行 CRUD,这里省略。
    ...
}
  1. 创建一个实现 StoreDescriptor 接口的类。必须是一个 Spring 单例 bean,其中 getBeanName() 方法必须返回上一步创建的 bean 的名称:
@Component("sample_ProjectDataStoreDescriptor")
public class ProjectDataStoreDescriptor implements StoreDescriptor {

    @Override
    public String getBeanName() {
        return "sample_ProjectDataStore";
    }

    @Override
    public boolean isJpa() {
        return false;
    }
}
  1. application.properties 中添加对数据存储的配置:
# 如果有多个,则以逗号分隔
jmix.core.additional-stores = projectds
# 配置名称为 jmix.core.storeDescriptor_<store_name>
jmix.core.store-descriptor_projectds = sample_ProjectDataStoreDescriptor

  1. Project 实体添加 @Store 注解:
@Store(name = "projectds")
@JmixEntity
public class Project {
    ...
}

通过这几步,我们完成了数据存储的实现和配置。Project 的列表页和编辑也不需要做任何改动,并且,任何通过 DataManagerProject DTO 的操作就像操作 JPA 实体一样方便,可以在服务层和 UI 层调用。

结论

如果外部 API 提供了丰富的操作接口,比如 CRUD、分页、排序甚至支持某种查询语言,那么我们推荐创建一个自定义的数据存储。这种为数据操作 Service 提供自定义数据存储的方式,更贴近 Jmix 原生的开发方式。另外,如果需要的话,自定义的数据存储也可以继承 AbstractDataStore 类,这个类是 Jmix 内置 JpaDataStore 的父类。通过这个类派生可以使用框架提供的一些机制,比如数据访问安全和对外部数据的审计。

但是如果外部 API 只提供了几个简单的接口,这种情况我们建议直接在 UI 层使用数据读写代理的方式。

示例的完整代码请访问 GitHub

标签:存储,Task,界面,外部,Jmix,Project,DTO,数据,public
From: https://www.cnblogs.com/jmix/p/jmix-external-data.html

相关文章

  • android打造的最简单计算器界面
    先看图:这里主要是锻炼一下TableLayout布局,注意其中的android:stretchColumns="0,1,2,3"属性,该属性可以控制每列的宽的权重,类似weight,由于这里4列都是“平等的”,所以是“0,1,2,3”,全部布局文件如下:<?xmlversion="1.0"encoding="utf-8"?><LinearLayoutxmlns:an......
  • K8S 高可用外部 etcd 运行时 (三) 使用Flannel网络
    kubectlapply-fkube-flannel.yml---kind:NamespaceapiVersion:v1metadata:name:kube-flannellabels:k8s-app:flannelpod-security.kubernetes.io/enforce:privileged---kind:ClusterRoleapiVersion:rbac.authorization.k8s.io/v1metadata:......
  • K8S 高可用外部 etcd , Docker 容器运行时 (三) 加入K8S集群
    control-plane上执行1、#证如果过期了,可以使用下面命令生成新证书上传,这里会打印出certificatekey,后面会用到kubeadminitphaseupload-certs--upload-certs#你还可以在【init】期间指定自定义的--certificate-key,以后可以由join使用。要生成这样的密钥,可以使用以下......
  • 报错:‘VUE-CLI-SERVICE‘ 不是内部或外部命令,也不是可运行的程序 或批处理文件。
    启动前端的项目,命输入npmrundev时,报错:'vue-cli-service'不是内部或外部命令,也不是可运行的程序或批处理文件。如图:1、管理员身份打开 2.输入set-ExecutionPolicyRemoteSigned 3、选择A4、Pycharm-Terminal执行命令:npminstall需要安装一会儿,稍安勿躁,安装完成......
  • 若依界面修改
    阿里图标一( ̄︶ ̄*))图片白嫖一((* ̄3 ̄)╭*********专栏略长====爆肝万字====细节狂魔====请准备好一键三连*********运行成功后:idea后台正常先挂着我习惯用VScode操作当然如果有两台机子一个挂后台一个改前端就更好了只需修改vue.config.js配置文件即可eg:按 Win+R打开......
  • LabVIEW调用第三方exe软件或操作操作控制第三方软件界面的控件,如操控烧录软件等
    LabVIEW调用第三方exe软件或操作操作控制第三方软件界面的控件,如操控烧录软件等除了模拟鼠标和键盘来实现之后,还可以考虑另外一种方式,使用窗口句柄来直接操作程序如下面图片实例,操作串口助手,修改串口和波特率,并写入数据和读取数据这种方式可以避免电脑的分辨率变化和位置移动等......
  • ***4完善登录界面和界面跳转
    1.button跳转【基本步骤】1.两个activity2.跳转前界面-->跳转后界面3.声明控件--找到控件--实现跳转2.匹配对应用户名和密码--只讲一种方法,因为实际操作时通过插卡来实现,所以这里你没有必要复杂化1.获取edittest里面的用户名和密码2.与规定进行匹配......
  • **2制作登录界面1
    AndroidStudio是Google推出的Android应用程序开发工具包。在AndroidStudio中,您可以使用各种工具来设计和开发Android应用程序。如果您想要创建登录界面,可以使用AndroidStudio中的布局和组件来实现。下面是一些基本步骤:打开AndroidStudio并创建新项目。在......
  • HMI人机界面相关介绍及人机界面设计
    在工业自动化领域,HMI是人机界面的缩写。在工业中使用HMI来控制和监控机器。如果没有HMI,就很难在工业中拥有良好的自动化流程。人机界面的定义人机界面(HMI)是一种用户界面,允许人类操作员与机器或过程进行交互。HMI通常用于工业环境,允许操作员监视和控制过程,例如工厂或发电厂中......
  • 界面控件开发包DevExpress v22.2.5正式发布|附高速下载
    DevExpress 拥有.NET开发需要的所有平台控件,包含600多个UI控件、报表平台、DevExpressDashboardeXpressApp框架、适用于VisualStudio的CodeRush等一系列辅助工具。屡获大奖的软件开发平台DevExpressv22.2已全新发布,该版本拥有众多新产品和数十个具有高影响力的功能,可为桌面......