迁移现有适配器以在 MobileFirst Server V8.0.0 下工作

improve this page | report issue

概述

从 MobileFirst Server V8.0 开始,适配器是 Maven 项目。了解如何升级在 MobileFirst Server 的较早版本下开发的适配器。

本页面描述了迁移适配器(开发为与 MobileFirst Server V6.2 或更高版本一起使用)以与 MobileFirst Server V8.0一起使用所需采取的步骤。
首先请了解 V8.0 中不推荐使用的功能以及 API 元素和服务器端 API 更改中描述的适配器 API 更改。

在 MobileFirst Server V8.0 下按原样使用较旧的适配器

除非符合以下任何条件,否则现有适配器可按原样部署在 MobileFirst Server V8.0 下:

适配器类型 条件
Java 使用 PushAPI 或 SecurityAPI 接口
JavaScript
  • 使用 IBM Worklight V6.2 或更低版本构建。
  • 使用不是 HTTP 或 SQL 的连接类型。
  • 包含 securityTest 定制过程
  • 包含使用用户身份来连接到后端的过程
  • 使用以下任何 API:
    • WL.Device.*
    • WL.Geo.\*
    • WL.Server.readSingleJMSMessage
    • WL.Server.readAllJMSMessages
    • WL.Server.writeJMSMessage
    • WL.Server.requestReplyJMSMessage
    • WL.Server.getActiveUser
    • WL.Server.setActiveUser
    • WL.Server.getCurrentUserIdentity
    • WL.Server.getCurrentDeviceIdentity
    • WL.Server.createEventSource
    • WL.Server.createDefaultNotification
    • WL.Server.getUserNotificationSubscription
    • WL.Server.notifyAllDevices
    • WL.Server.notifyDeviceToken
    • WL.Server.notifyDeviceSubscription
    • WL.Server.sendMessage
    • WL.Server.createEventHandler
    • WL.Server.setEventHandlers
    • WL.Server.setApplicationContext
    • WL.Server.fetchNWBusinessObject
    • WL.Server.createNWBusinessObject
    • WL.Server.deleteNWBusinessObject
    • WL.Server.updateNWBusinessObject
    • WL.Server.getBeaconsAndTriggers
    • WL.Server.signSoapMessage
    • WL.Server.createSQLStatement

针对 MobileFirst Server V8.0 将 Java 适配器迁移到 Maven 项目

  1. 创建 archetype 为 adapter-maven-archetype-java 的 Maven 适配器项目。 在设置参数 artifactId 时,请使用适配器名称;对于参数 package,请使用与现有 Java 适配器中的包相同的包。有关更多信息,请参阅创建 Java 适配器
  2. 覆盖在步骤 1 中创建的新适配器项目的 src/main/adapter-resources 文件夹中的适配器描述符文件 (adapter.xml)。有关描述符的更多详细信息,请参阅 Java 适配器描述符文件
  3. 从新适配器项目的 src/main/java 文件夹中除去所有文件。然后,复制旧 Java 适配器项目的 src/ 文件夹下的所有 Java 文件,并保持相同的文件夹结构。将所有非 Java 文件从旧适配器的 src 文件夹复制到新适配器的 src/main/resources 文件夹。缺省情况下,src/main/resources 不存在,因此如果适配器包含非 Java 文件,请创建此目录。有关 Java 适配器 API 中的更改,请参阅 V8.0 中的服务器端 API 更改

    下图说明了 V7.1 之前适配器的结构以及 Maven 适配器(从 V8.0 开始)的结构:

     ├── adapters
     │   └── RSSAdapter
     │       ├── RSSAdapter.xml
     │       ├── lib
     │       └── src
     │           └── com
     │               └── sample
     │                   ├── RSSAdapterApplication.java
     │                   └── RSSAdapterResource.java
    

    Java 适配器的新结构:

     ├── pom.xml
     ├── src
     │   └── main
     │       ├── adapter-resources
     │       │   └── adapter.xml
     │       └── java
     │           └── com
     │               └── sample
     │                   ├── RSSAdapterApplication.java
     │                   └── RSSAdapterResource.java
    
  4. 使用以下任一方法,添加 Maven 存储库中未包含的任何 JAR 文件:

针对 MobileFirst Server V8.0 将 JavaScript 适配器迁移到 Maven 项目

  1. 创建 archetype 为 adapter-maven-archetype-http 或 adapter-maven-archetype-sql 的 Maven 适配器项目。在设置参数 artifactId 时,使用适配器名称。有关更多信息,请参阅创建 JavaScript 适配器
  2. 覆盖在步骤 1 中创建的新适配器项目的 src/main/adapter-resources 文件夹中的适配器描述符文件 (adapter.xml)。有关描述符的详细信息,请参阅 JavaScript 适配器描述符文件
  3. 覆盖新适配器项目的 src/main/adapter-resources/js 文件夹中的 JavaScript 文件。
Last modified on October 05, 2017