Swagger是一个常用的API文档工具，提供了方便的API接口定义和文档生成功能。而StrongLoop则是一个为Node.js开发者提供全栈式解决方案的平台，其中包括了一个名为StrongLoop Arc的UI管理界面，可以使用它来管理应用程序、API、数据源等。
strong-swagger-ui是一个基于Swagger UI的npm包，能够为StrongLoop Arc添加Swagger API文档展示功能。本篇文章将介绍如何使用strong-swagger-ui将Swagger UI集成到StrongLoop Arc中，并提供实际示例代码以供参考。
步骤1：安装strong-swagger-ui
在终端窗口中输入以下命令安装strong-swagger-ui：
--- ------- ------ -----------------
步骤2：生成Swagger JSON文件
在Node.js应用程序中，我们可以使用一些库来生成Swagger JSON文件，例如swagger-jsdoc或swagger-ui-express。这里我们以swagger-jsdoc为例，它可以提取JSDoc注释中的Swagger信息并生成Swagger JSON文件。安装swagger-jsdoc：
--- ------- ---------- -------------
在应用程序的入口文件中添加以下代码：
----- ------------ - -------------------------
----- ------- - -------------------
----- --- - ----------
----- ----------------- - -
----- -
------ ----------
-------- --------
------------ -----------
--
----- -----------------
--------- ----
--
----- ------- - -
------------------
----- ------------------ -- ----------
--
----- ----------- - ----------------------
------------------------ ----- ---- -- -
----------------------------- --------------------
----------------------
---
-- ----------
---------------- -- -- -
-------------------------------
---其中，swaggerDefinition定义了Swagger JSON文件的基本信息，包括标题、版本、描述、主机和基本路径等。参数options指定选项对象，其中apis属性表示匹配路由文件中的注释。
步骤3：集成strong-swagger-ui
在StrongLoop Arc界面中添加strong-swagger-ui插件，具体步骤如下：
- 在StrongLoop Arc界面中点击“Add”按钮；
- 输入strong-swagger-ui并选择该插件；
- 点击“Install”按钮以安装插件；
- 安装完成后，重新加载StrongLoop Arc页面。
在StrongLoop Arc中使用Swagger UI需要在设置中指定Swagger JSON文件的URL地址，如下图所示：
示例代码
以下是使用swagger-jsdoc生成Swagger JSON文件的示例代码：
--- - -------- - ----- - ----- -- - ------------ ------ -- --- - -------- - ------------ - ----- - ----- ------ - --------- - - ---- - ----------- - --- - ----- ------- - ------------ ---- - ----- - ----- ------ - ------------ ---- - ---- - ----- ------- - ------------ ---- -- ----- ------- - ------------------- ----- ------ - ----------------- --- - -------- - ------- - ---- - -------- -------- - ----- ---- - ---------- - ---- - ------------ ---------- - ------- - ----- ----- - ------ - ----- ------------------- ----------------------------------------------------------- ---------- ---------------------------------------------------------------------------------------