npm 包 openhab1-rest 使用教程-JavaScript中文网-JavaScript教程资源分享门户

介绍

openHAB1 是一款针对物联网的开源自动化软件，可以使用户方便地控制和监视家庭自动化器件。openhab1-rest 是 npm 上一个针对 openHAB1 REST API 的 Node.js 客户端包，可以帮助开发者快速搭建基于 openHAB1 的 Web 应用。

本文将会详细介绍 openhab1-rest 的使用方法，并提供有指导意义的示例代码，希望能够帮助读者加深了解 openHAB1 REST API 并搭建一个实现简单控制器的 Web 应用。

安装

使用 npm 在 Node.js 环境中安装 openhab1-rest：

npm install openhab1-rest --save

使用

通过 require 导入包：

const openhab = require('openhab1-rest');

构建一个 openHAB REST API 客户端对象：

const client = openhab.createClient({
  host: '<openHAB IP>',
  port: '<openHAB REST API 端口>',
  protocol: '<http 或 https>',
  username: '<openHAB 用户名>',
  password: '<openHAB 密码>'
});

构建之后你就可以调用 client 对象中的各种 API，比如获取 Item 列表：

client.getItems().then((items) => {
  console.log(items);
}).catch((err) => {
  console.log(err);
});

获取指定 Item 的状态：

client.getItemState('item-name').then((state) => {
  console.log(state);  
}).catch((err) => {
  console.log(err);
});

更新指定 Item 的状态：

client.updateItemState('item-name', 'ON').then(() => {
  console.log('Successfully updated item state');
}).catch((err) => {
  console.log(err);
});

这里只是简单列举了几个用例，更多的操作和 API 都可以在 openhab1-rest 的文档中找到。

示例

本文提供一个控制开关灯的 Web 应用示例，读者可以通过这个示例了解如何使用 openhab1-rest 和如何搭建一个实现简单功能的 Web 应用。

实现功能

获取灯的状态并显示在页面上；
点击按钮灯亮或灭，并更新页面上的状态。

页面

在 HTML 文件中添加一个按钮和一个文本框并绑定 ID：

<input type="button" value="Toggle Light" id="toggleBtn">
<br><br>
<p>Light State: <span id="stateText">Fetching state...</span></p>

JavaScript

在 JavaScript 文件中创建一个名为 LightController 的类，用来处理控制器的逻辑，顶部加入导入 openhab1-rest 包的语句：

-- -------------------- ---- -------
----- ------- - -------------------------

----- --------------- -
  ------------- -
    -- -------
    ----------- - ----------------------
      ----- --------- -----
      ----- --------- ---- --- -----
      --------- ------ - --------
      --------- --------- ------
      --------- --------- ----
    ---

    -- --------
    -------------------------------------------------------------- -- -- -
      -------------------
    ---

    -- ------
    --------------------------------- -- -
      ---------------------------------------------- - ------
    -------------- -- -
      -----------------
    ---
  -

  -- ------
  ----- --------------- -
    --- -
      ----- ----- - ----- ----------------------------------
      ------ ------
    - ----- ----- -
      -----------------
    -
  -

  -- ------
  ----- ------------- -
    --- -
      ----- ------------ - ----- ---------------------
      --- -------- - ---
      -- ------------- --- ------ -
        -------- - -----
      - ---- -
        -------- - ------
      -
      ----- ------------------------------------ ----------
      ---------------------------------------------- - ---------
    - ----- ----- -
      -----------------
    -
  -
-

-- --- --------------- -
----- ----- - --- ------------------

结论

通过本文的介绍，你已经了解了如何安装和使用 openhab1-rest 包，并且实现了一个简单的控制器 Web 应用。通过 openHAB1 REST API，你可以在 Node.js 环境中轻松地实现控制和监视自动化器件的功能。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/60055ea281e8991b448dbf94