SAPUI5 (37) - 使用 Grunt 实现 Cross Origin 代理

上一篇介绍使用 SAP Web IDE 代理来解决 Cross-origin 问题。如果使用 Eclipse 作为开发工具，可以使用 Simple proxy servlet 来测试，作为 cross-origin 的代理。但 SAP Web IDE 编写的代码，并不能在不做任何修改的情况下运行。为了能较好地实现代码移植，另外一个比较好的方法是使用 Grunt。Grunt 是基于 JavaScript 的自动化工具，可以用于 OpenUI5 的测试运行，实现跨域代理。

环境准备

1. 安装 Node.js
2. 使用 npm 工具 ( Node.js 的包管理器 ) 安装 grunt-cli，安装的命令如下：

npm install -g grunt-cli

在 Windows 下，应该以管理员权限来运行该命令。上述命令执行完后，grunt 命令就被加入到你的系统路径中了，以后就可以在任何目录下执行此命令了。

安装 grunt-cli 并不等于安装了 Grunt！Grunt CLI 的任务很简单：调用与 Gruntfile 在同一目录中 Grunt。这样带来的好处是，允许你在同一个系统上同时安装多个版本的 Grunt。

Grunt 工具搭建

Grunt 需要将如下两个文件放置在项目的根目录下面。

• package.json： 这个文件告知 grunt-cli 需要安装的依赖。
• Gruntfile: 此文件被命名为 Gruntfile.js 或 Gruntfile.coffee，用来配置或定义任务（task）并加载 Grunt 插件

package.json 文件的内容如下：

{
  "name": "scn-demo-gw-sample",
  "version": "0.0.1",
  "devDependencies": {
    "grunt": "^1.0.1",
    "grunt-connect-proxy": "^0.2.0",
    "grunt-contrib-connect": "^1.0.2",
    "grunt-contrib-watch": "^1.0.0",
    "jit-grunt": "^0.10.0"
  }
}

Gruntfile.js 文件内容如下：

module.exports = function (grunt) {
    'use strict';

    // load grunt plugins
    require('jit-grunt')(grunt, {
        configureProxies: 'grunt-connect-proxy'
    });

    // create config
    grunt.initConfig({

        settings: {
            connect: {
                host: 'localhost',
                port: '9555'
            },
            proxy: {
                host: 'dph01.nodomain',
                port: '8180'
            }
        },

        connect: {
            options: {
                hostname: '<%= settings.connect.host %>',
                port: '<%= settings.connect.port %>',
                livereload: 35729,
                middleware: function (connect, options, defaultMiddleware) {
                    var aMiddlewares = [];
                    aMiddlewares.push(require('grunt-connect-proxy/lib/utils').proxyRequest);
                    aMiddlewares.push(defaultMiddleware);
                    return aMiddlewares;
                }
            },
            connectWebapp: {
                options: {
                    base: ['webapp'],
                    open: true
                }
            },
            proxies: [
                {
                    context: '/resources',
                    host: '<%= settings.proxy.host %>',
                    port: '<%= settings.proxy.port %>',
                    https: false,
                    rewrite: {
                        '/resources': '/sap/public/bc/ui5_ui5/resources'
                    }
                }, {
                    context: '/sap/opu/odata',
                    host: '<%= settings.proxy.host %>',
                    port: '<%= settings.proxy.port %>',
                    https: false
                }
            ]
        },

        watch: {
            options: {
                livereload: true
            },
            watchWebapp: {
                files: ['webapp/**/*']
            }
        }
    });

    // register serve task
    grunt.registerTask('serve', ['configureProxies:server', 'connect:connectWebapp', 'watch:watchWebapp']);

    // register default task
    grunt.registerTask('default', ['serve']);
}

grunt.initConfig 需要根据 SAP 服务器的对外提供 OData service 的 domain 进行修改：

grunt.initConfig({

    settings: {
        connect: {
            host: 'localhost',
            port: '9555'
        },
        proxy: {
            host: 'dph01.nodomain',
            port: '8180'
        }
    },

然后在项目根目录下运行如下命令：

npm install

npm 根据 package.json 文件的依赖，在本地安装相关的插件。

测试 Grunt 服务

在项目根目录下，运行 grunt serve 命令，grunt 在本地创建 Web 服务，并代理连接到后端 SAP 系统。

参考资料

• Using Grunt to test your UI5 app locally against SAP Gateway OData Services