MobileFirst Foundation 8.0 迁移手册

Maven 适配器需要在开发人员工作站上安装 Apache Maven。

1. 安装 Apache Maven。
   • 下载 Apache Maven .zip。
   • 添加指向 Maven 文件夹的 MVN_PATH 变量。
   • Mac 和 Linux：
     编辑您的 ~/.bash_profile：

     #### Apache Maven example location
     
     export MVN_PATH="/usr/local/bin"

   • Windows： 遵循此指南。
   • 通过执行 mvn -v 来验证安装。
2. 该手册使用 MobileFirst CLI 来调用 Maven 命令以创建和构建适配器。
   • 如果尚未安装 NodeJS，请进行安装，因为它是运行该工具的先决条件。
   • 从命令行窗口中，运行以下命令：npm install -g mfpdev-cli（或者在 MobileFirst Operations Console 上从“下载中心”中进行下载和安装）。
   • 通过执行 mfpdev -v 来验证安装。

创建与您自己的适配器类型和适配器名称以及软件包名称匹配的新适配器模板。
这将简化迁移，因为适配器的元数据是类似的，因此不需要进行额外编辑。

• 从命令行窗口中，运行以下命令：mfpdev adapter create
• 选择适配器类型：HTTP 或 SQL JavaScript 适配器或 Java 适配器。
• 提供 GroupID。
• 如果您创建 Java 适配器，请确保指定先前使用的相同软件包名称（例如，“com.sample”）。

1. 使用 server 选项运行迁移辅助工具，并指定较早 Worklight 项目的根目录。
   mfpmigrate server --In /Users/WorklightProject**/ --Out /Users/Migrate80Project
   
   

   语法

   mfpmigrate server [--in|-i <sourceDirectory>] [--out|-o <destinationDirectory>] [--projectName|-p <newProjectDirectory>]

   
   

   描述

   从现有 MobileFirst 项目迁移安全域和适配器。

   
   

   选项

   <sourceDirectory>：<sourceDirectory> 必须是要迁移的 MobileFirst 项目的根文件夹。这是必需参数，而非可选参数。

   <destinationDirectory>：<destinationDirectory> 是期望将适配器迁移到的目录。

   迁移工具将扫描适配器和域，并执行下列操作：

   1. 为适配器和受支持的安全性检查创建模板。
   2. 将适配器源移到新创建的 maven 工件。
   3. 使用依赖关系更新项目 pom。
   4. 创建一份摘要报告，说明这款工具的功能以及完成迁移需要手动执行哪些其他更改。

2. 通过摘要报告，您可以：

   1. 了解迁移辅助工具的功能。
   2. 将不受支持的 API 映射到受支持的 API，以便可以进行直接迁移。
   3. 识别原有 Worklight 项目中使用的不受支持的适配器/域。
   4. 了解现有设计存在哪些其他技术难题或瓶颈问题，然后参考以下新的开发概念来了解如何解决这些问题。

1. 在文件系统中浏览至 JavaScript 适配器文件夹，例如：../Desktop/JavaScriptAdapters/adapters/RSSReader。
2. 打开另一个窗口并浏览至新 Maven 项目（例如：../Desktop/MigratedAdapter）和 src/main/adapter-resources 文件夹。
3. 将现有适配器文件复制并粘贴到此文件夹。
4. 编辑 adapter.xml：将其内容替换为现有适配器的 XML 内容（在此示例中为 RSSReader.xml）。
5. 编辑 js/{adapter-name}-impl.js：将其内容替换为现有适配器的内容（在此示例中为 RSSReader-impl.js）。

1. 在文件系统中浏览至 JavaScript 适配器文件夹，例如：../Desktop/JavaScriptAdapters/adapters/SQLAdapter。
2. 打开另一个窗口并浏览至新 Maven 项目（例如：../Desktop/MigratedAdapter）和 src/main/adapter-resources 文件夹。
3. 编辑 adapter.xml：将其内容替换为现有适配器的 XML 内容（在此示例中为 SQLAdapter.xml）。
4. 编辑 js/{adapter-name}-impl.js：将其内容替换为现有适配器的内容（在此示例中为 SQLAdapter-impl.js）。

这是 Maven 依赖关系生效的位置。 由于未使用 Worklight/MobileFirst Studio（数据库连接器先前放置在 server/lib 文件夹中），所以将其替换为 Maven 依赖关系。

1. 返回到新创建的 Maven 项目，然后打开位于该目录的根目录下的 pom.xml 文件。
2. 为您的数据库类型添加依赖关系。 您可以在 Maven Central Web 站点中搜索要使用的相应依赖关系。
3. 在此示例中，使用 MySQL 数据库。 在 dependencies 部分中添加以下代码块：

   <dependency>
       <groupId>mysql</groupId>
       <artifactId>mysql-connector-java</artifactId>
       <version>5.1.6</version>
   </dependency>

如果您具有其他依赖关系，pom.xml 文件将是指向本地文件或远程依赖关系的位置。

了解有关 Maven 依赖关系的更多信息：

• 依赖关系机制简介 (Maven.org)
• 处理依赖关系（教程）

下面这些“图”以不同角度呈现了到目前为止所完成的工作：

MyProject
├── adapters
│   ├── RSSAdapter
│   │   ├── RSSAdapter-impl.js
│   │   ├── RSSAdapter.xml
│   │   └── filtered.xsl

RSSAdapter
├── pom.xml
├── src
│   └── main
│       ├── adapter-resources
│       │   ├── adapter.xml
│       │   └── js
│       │        ├── RSSAdapter-impl.js
│       │        └── filtered.xml

1. 在文件系统中浏览至 Java 适配器文件夹，例如：../Desktop/JavaAdapters/RSSAdapter。
2. 打开另一个窗口并浏览至新 Maven 项目（例如：../Desktop/MigratedAdapter）和 src/main/adapter-resources 文件夹。
3. 编辑 {adapter-name}.xml：将其内容替换为现有适配器的 XML 内容（在此示例中为 RSSAdapter.xml）。
4. 在新适配器中，浏览至 src/main/java/com/sample/（在此示例中）。
5. 将现有的 .java 文件替换为现有适配器的 .java 文件。

如果使用的是现有适配器中的任何其他库，Maven 依赖关系现在开始生效。 由于未使用 Worklight/MobileFirst Studio（库先前放置在 server/lib 或 Java 适配器的 lib 文件夹中），所以将其替换为 Maven 依赖关系。

1. 返回到新创建的 Maven 项目，然后打开位于该目录的根目录下的 pom.xml 文件。
2. 为您的数据库类型添加依赖关系。 您可以在 Maven Central Web 站点中搜索要使用的相应依赖关系。
3. 此示例使用 Cloudant 依赖关系。 在 dependencies 部分中添加以下代码块：

   <dependency>
   	<groupId>com.cloudant</groupId>
   	<artifactId>cloudant-client</artifactId>
   	<version>1.2.3</version>
   </dependency>

了解有关 Maven 依赖关系的更多信息：

• 依赖关系机制简介 (Maven.org)
• 处理依赖关系（教程）

下面这些“图”以不同角度呈现了到目前为止所完成的工作：

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

├── pom.xml
├── src
│   └── main
│       ├── adapter-resources
│       │   └── adapter.xml
│       └── java
│           └── com
│               └── sample
│                   ├── RSSAdapterApplication.java
│                   └── RSSAdapterResource.java
└

构建已迁移的适配器

从命令行窗口中，浏览至适配器的文件夹并运行以下命令：mfpdev adapter build

要解决此类错误，建议将 Maven 项目导入到 IDE（如 IntelliJ），并在那里构建项目。 通过由您控制的 IDE，您可以更轻松地遍历构建错误并逐个解决错误。 了解有关使用 IntelliJ 和适配器的更多信息。

测试已构建的适配器

要测试已迁移的适配器，您可以使用 MobileFirst CLI 调用自己的端点，或者从 MobileFirst Operations Console 中使用 Swagger。

在测试和调试适配器教程中了解有关测试适配器的更多信息。