Your first Kaa application

第一个Kaa应用程序
Prerequisites
Application description
Add application
Create schemas
Set up log appender
Generate SDK
Sample client application
Preparation
Application code
Launch application
Expected output
Retrieve collected data
Change sampling period
Further reading


本节讨论使用Kaa沙盒创建基于Kaa的应用程序的基础知识。 Kaa平台操作的主要原理通过一个实际的传感器设备采集的数据为例。要了解更多关于kaa的特点，看到进一步的阅读。


一、Prerequisites
要在新的Kaa服务器安装中注册新的应用程序，您需要创建具有租户管理员和租户开发人员角色的用户。租户管理员在Kaa中创建新的应用程序。Tenant开发人员为这些应用程序配置和生成SDK。建议您使用已经包括租户管理员和租户开发人员的Kaa沙盒。


要了解如何安装Kaa Sandbox，请参阅入门指南。

二、Application description

为了演示创建基于Kaa的应用程序的过程，让我们创建一个应用程序，传感器设备将温度数据传输到服务器。为了使应用程序更有效率，您可以对其进行配置，以便数据传输在用户设置的各种采样周期内进行。

要实现这一点，将使用两个Kaa功能：

1、数据收集功能允许从端点发送数据到Kaa服务器。在此示例中，数据收集功能将用于在配置的采样周期传输温度值。

2、配置功能允许从Kaa服务器到Kaa端点广播配置参数。在此示例中，配置功能将用于将采样周期值从Kaa服务器发送到温度传感器。

三、Add application

添加应用程序：

1、在“沙盒”主页上，单击“管理UI”，并以租用管理员身份登录，使用默认的admin用户名和admin123密码。

2、在“管理 UI”页面，点击添加应用程序

3、在“应用程序详细信息”页上，输入新应用程序的标题，选择凭据服务，然后单击“添加”。

四、创建模式Create schemas

您刚刚创建的应用程序已经包含配置文件，配置，通知和日志模式的默认版本，可以使用。您可以创建自定义数据收集和配置模式。

要创建和上传自定义模式：

1、创建一个包含以下模式定义的data-schema.json文件。

 {
     "type": "record",
     "name": "DataCollection",
     "namespace": "org.kaaproject.kaa.schema.sample",
     "fields": [
         {
             "name": "temperature",
             "type": "int"
         }
     ]
 }

2、创建一个包含以下模式定义的configuration-schema.json文件。 by_default参数定义了在此示例中设置为1的默认采样周期值。

{
     "type": "record",
     "name": "Configuration",
     "namespace": "org.kaaproject.kaa.schema.sample",
     "fields": [
         {
             "name": "samplePeriod",
             "type": "int",
             "by_default": 1
         }
     ]
 }

3、从data-schema.json和configuration-schema.json文件，使用上传文件创建应用范围的CT模式。

4、在沙箱主页上，单击管理UI，并使用默认的devuser用户名和devuser123密码作为租户开发人员登录。

5、单击“应用程序箭头”展开列表，然后单击“添加应用程序”中创建的应用程序的箭头，然后单击“架构>日志”，然后单击“添加架构”按钮。

6、在“添加日志模式”页面上，输入新数据收集模式的名称和描述，并选择从data-schema.json文件创建的CT。

7、点击页面顶部的添加按钮。

注意：或者，您也可以使用Avro UI表单来创建模式。

To create a configuration schema repeat the same procedure using the configuration-schema.json file.

因此，您的配置和数据收集模式将显示在列表中。 请注意，每次添加新模式时，Kaa会为其分配新的版本号。 在此示例中，日

志和配置模式是版本2.您的版本号可能与此示例不同。稍后将需要版本号来生成SDK。