带有 SAPUI5/OPENUI5 的 JSDoc答案

【问题标题】：JSDoc with SAPUI5/OPENUI5带有 SAPUI5/OPENUI5 的 JSDoc
【发布时间】：2016-10-27 07:48:14
【问题描述】：

我努力让 Eclipse 大纲视图填满，但它仍然是空的

我读了这些，但它不起作用：

http://usejsdoc.org/howto-amd-modules.html

SCN: sapui5-mvc-pattern-and-eclipse-outline-view

如何将 jsdoc cmets 传递给我的代码？

sap.ui.define([
    "sap/ui/model/json/JSONModel",
    "sap/m/MessageToast",
    "sap/ui/model/odata/Filter",
    "sap/ui/model/FilterOperator"
], function (JSONModel, MessageToast, Filter, FilterOperator) { 
    "use strict";

    return BaseController.extend("SAP.Mobile.controller.App", {
        /**
        * @memberOf BaseController
        * ...
        */

        formatter: formatter,

        onInit: function () {

        },

        onAfterRendering: function(){

        }

    });
});

【问题讨论】：

由于 Eclipse 对 Javascript 的支持比较差，所以我不会动它；宁可使用 SAP WebIDE、Jetbrains Webstorm 等，因为它们有更好的 Javascript 支持和工具（并且类结构按应有的方式显示）

标签： comments sapui5 jsdoc outline

【解决方案1】：

出现问题是因为使用 sap.ui.define 定义函数的新方法，并且 Eclipse 无法生成大纲。 SAP 推荐他们的 WebIDE 用于 UI5 相关的开发和 SAPUI5 eclipse 的增强功能没有得到照顾。

【讨论】：

【解决方案2】：

我偶然发现了同样的问题。由于多种原因，无法切换到 WebIDE 或 Webstorm，因此我使用稍微不同的语法来支持大纲。

sap.ui.define([
    "sap/ui/model/json/JSONModel",
    "sap/m/MessageToast",
    "sap/ui/model/odata/Filter",
    "sap/ui/model/FilterOperator"
], function (JSONModel, MessageToast, Filter, FilterOperator) { 
    "use strict";

    var Controller = BaseController.extend("SAP.Mobile.controller.App", {

       /**
        * @memberOf SAP.Mobile.controller.App
        */
        formatter: formatter,

        onInit: function () {

        },

        onAfterRendering: function(){

        }

    });

    return Controller;

});

【讨论】：

【解决方案3】：

我正在使用这种方式，对我来说效果很好。

sap.ui.define([
    "sap/ui/model/json/JSONModel",
    "sap/m/MessageToast",
    "sap/ui/model/odata/Filter",
    "sap/ui/model/FilterOperator"
], Controller );

/**
* Controller
* @class
*/
function Controller (JSONModel, MessageToast, Filter, FilterOperator) { 
    "use strict";

    var Controller = BaseController.extend("SAP.Mobile.controller.App", {

       /**
        * @memberOf SAP.Mobile.controller.App
        */
        formatter: formatter,

        onInit: function () {

        },

        onAfterRendering: function(){

        }

    });

    return Controller;

}

【讨论】：