# ohos_mqtt
## 介绍
使应用程序能够连接到MQTT代理以发布消息、订阅主题和接收发布的消息。
## 下载安装
```shell
ohpm install @ohos/mqtt
```
- OpenHarmony ohpm环境配置等更多内容,请参考 [如何安装OpenHarmony ohpm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_har_usage.md) 。
## 源码下载
本项目依赖paho.mqtt.c库和third_party_bounds_checking_function库,通过`git submodule`引入,下载代码时需加上`--recursive`参数。
```
git clone --recursive https://gitee.com/openharmony-tpc/ohos_mqtt.git
```
## 使用说明
```typescript
import { MqttAsync } from '@ohos/mqtt';
```
## Demo运行说明
mqtt使用依赖mqtt broker,请使用云服务或自行搭建,将 emqxPage.ets 文件中的如下参数改成对应的值,才能正常运行demo。
```typescript
// Set Client Configuration
@State topic: string = '';
@State payload: string = '';
@State url: string = '';
@State clientId: string = '';
@State userName: string = "";
@State password: string = "";
```
将xts中的domain:port替换成正确的域名与端口,才能正常运行xts.
### openssl依赖
如果想要开启ssl功能,需要自行编译openssl,[openssl集成到应用hap](https://gitee.com/openharmony-sig/tpc_c_cplusplus/blob/master/thirdparty/openssl/docs/hap_integrate.md)
1.编译之前需要在tpc_c_cplusplus交叉编译中支持编译x86_64架构,可以参考tpc_c_cplusplus的docs目录下的[adpater_architecture.md](https://gitee.com/openharmony-sig/tpc_c_cplusplus/blob/master/docs/adpater_architecture.md)文档。
2.编译之前需要先修改HPKBUILD文件中第四行openssl的版本
```
pkgver=OpenSSL_1_1_1t
//修改为
pkgver=OpenSSL_1_1_1w
```
3.下载openssl的[OpenSSL_1_1_1w版本](https://github.com/openssl/openssl/archive/refs/tags/OpenSSL_1_1_1w.tar.gz),执行以下命令获取对应的sha512值,替换SHA512SUM文件的内容。
```
sha512num openssl-OpenSSL_1_1_1w.tar.gz
```
4.在cpp目录下新增thirdparty目录,并将编译生成的库拷贝到该目录下,如下图所示
![img.png](./image/img.png)
5.在cpp/paho.mqtt.c/CMakeList.txt中添加如下语句
```
#开启ssl
add_definitions(-DOPENSSL)
#将三方库加入工程中
target_link_libraries(pahomqttc PRIVATE ${NATIVERENDER_ROOT_PATH}/thirdparty/openssl/${OHOS_ARCH}/lib/libssl.a)
target_link_libraries(pahomqttc PRIVATE ${NATIVERENDER_ROOT_PATH}/thirdparty/openssl/${OHOS_ARCH}/lib/libcrypto.a)
#将三方库的头文件加入工程中
target_include_directories(pahomqttc PRIVATE ${NATIVERENDER_ROOT_PATH}/thirdparty/openssl/${OHOS_ARCH}/include)
```
## 接口说明
### createMqtt
createMqtt(options: MqttAsyncClientOptions): MqttAsyncClient
创建mqtt客户端。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|--------------------------|----------|-----------------|
| options | MqttAsyncClientOptions | 是 | 客户端参数 |
返回值:
| 类型 | 说明 |
|------------------|----------------------------------|
| MqttAsyncClient | mqtt客户端,里面包括connect,publish等方法 |
示例:
```typescript
this.mqttAsyncClient = MqttAsync.createMqtt({
url: "ip:port",
clientId: "e5fatos4jh3l79lndb0bs",
persistenceType: 1,
})
```
### connect
connect(options: MqttConnectOptions, callback: AsyncCallback<MqttResponse>): void
连接mqtt服务器。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|------------|--------------------------------------------------|-------|---------------------------------------------|
| options | MqttConnectOptions | 是 | 参考[MqttConnectOptions](#mqttconnectoptions) |
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
let options = {
//set userName and password
userName: "",
password: "",
connectTimeout: 30,
version: 0,
};
this.mqttAsyncClient.connect(options, (err: Error, data: MqttResponse) => {
// to do Something
});
```
### connect
connect(options: MqttConnectOptions): Promise<MqttResponse>
连接mqtt服务器。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|------------------------|--------|--------------------------------------------------|
| options | MqttConnectOptions | 是 | 参考[MqttConnectOptions](#mqttconnectoptions) |
返回值:
| 类型 | 说明 |
|------------------------------------------|----------------------|
| Promise<[MqttResponse](#mqttresponse)> | 以Promise形式返回发起连接的结果。 |
示例:
```typescript
let options = {
//set userName and password
userName: "",
password: "",
connectTimeout: 30,
version: 0,
};
this.mqttAsyncClient.connect(options).then((data: MqttResponse) => {
console.log("mqtt connect success "+ JSON.stringify(data));
}).catch((err: MqttResponse) => {
console.log("mqtt connect fail"+JSON.stringify(err))
})
try{
let result: MqttResponse = await this.mqttAsyncClient.connect(options)
console.log("mqtt connect success "+ JSON.stringify(result));
}catch(err){
console.log("mqtt connect fail "+ JSON.stringify(err));
}
```
### publish
publish(options: MqttPublishOptions, callback: AsyncCallback<MqttResponse>): void
发布消息。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|---------------------------------------------------|--------|---------------------------------------------|
| options | MqttPublishOptions | 是 | 参考[MqttPublishOptions](#mqttpublishoptions) |
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
let publishOption = {
topic: "domotopic",
qos: 1,
payload: "haishangdebing",
}
this.mqttAsyncClient.publish(publishOption, (err: Error, data: MqttResponse) => {
// to do Something
});
```
### publish
publish(options: MqttPublishOptions): Promise<MqttResponse>
发布消息。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|-------------------------|--------|-------------------------------------------------|
| options | MqttPublishOptions | 是 | 参考[MqttPublishOptions](#mqttpublishoptions) |
返回值:
| 类型 | 说明 |
|------------------------------------------|--------------------|
| Promise<[MqttResponse](#mqttresponse)> | 以Promise形式返回发布的结果。 |
示例:
```typescript
let publishOption = {
topic: "domotopic",
qos: 1,
payload: "haishangdebing",
}
this.mqttAsyncClient.publish(publishOption, (data: MqttResponse) => {
console.log("mqtt publish success "+ JSON.stringify(data));
}).catch((err: MqttResponse) => {
console.log("mqtt publish fail "+ JSON.stringify(err));
})
try{
let result: MqttResponse = await this.mqttAsyncClient.publish(publishOption)
console.log("mqtt publish success "+ JSON.stringify(result));
}catch(err){
console.log("mqtt publish fail "+ JSON.stringify(err));
}
```
### subscribe
subscribe(options: MqttSubscribeOptions, callback: AsyncCallback<MqttResponse>): void
订阅主题。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|--------------------------------------------------|--------|-------------------------------------------------|
| options | MqttSubscribeOptions | 是 | 参考[MqttSubscribeOptions](#mqttsubscribeoptions) |
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
let subscribeOption = {
topic: "domotopic",
qos: 2
}
this.mqttAsyncClient.subscribe(subscribeOption, (err: Error, data: MqttResponse) => {
// to do Something
});
```
### subscribe
subscribe(options: MqttSubscribeOptions): Promise<MqttResponse>
订阅主题。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-----------|--------------------------|-------|----------------------------------------------------|
| options | MqttSubscribeOptions | 是 | 参考[MqttSubscribeOptions](#mqttsubscribeoptions) |
返回值:
| 类型 | 说明 |
|-----------------------------------------|--------------------|
| Promise<[MqttResponse](#mqttresponse)> | 以Promise形式返回订阅的结果。 |
示例:
```typescript
let subscribeOption = {
topic: "domotopic",
qos: 2
}
this.mqttAsyncClient.subscribe(subscribeOption).then((data: MqttResponse) => {
console.log("mqtt subscribe success "+ JSON.stringify(result));
}).catch((err: MqttResponse) => {
console.log("mqtt subscribe fail "+ JSON.stringify(err));
})
try{
let result: MqttResponse = await this.mqttAsyncClient.subscribe(subscribeOption)
console.log("mqtt subscribe success "+ JSON.stringify(result));
}catch(err){
console.log("mqtt subscribe fail "+ JSON.stringify(err));
}
```
### unsubscribe
unsubscribe(options: MqttSubscribeOptions, callback: AsyncCallback<MqttResponse>): void
取消订阅。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|------------|-------------------------------------------------|----------|-------------------------------------------------|
| options | MqttSubscribeOptions | 是 | 参考[MqttSubscribeOptions](#mqttsubscribeoptions) |
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
let subscribeOption = {
topic: "domotopic",
qos: 2
}
this.mqttAsyncClient.unsubscribe(subscribeOption, (err: Error, data: MqttResponse) => {
// to do Something
});
```
### unsubscribe
unsubscribe(options: MqttSubscribeOptions): Promise<MqttResponse>
取消订阅。
参数:
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| options | MqttSubscribeOptions | 是 | 参考[MqttSubscribeOptions](#mqttsubscribeoptions) |
返回值:
| 类型 | 说明 |
|----------------------------------------|----------------------|
| Promise<[MqttResponse](#mqttresponse)> | 以Promise形式返回取消订阅的结果。 |
示例:
```typescript
let subscribeOption = {
topic: "domotopic",
qos: 2
}
this.mqttAsyncClient.unsubscribe(subscribeOption).then((data: MqttResponse) => {
console.log("mqtt unsubscribe success "+ JSON.stringify(result));
}).catch((err: MqttResponse) => {
console.log("mqtt unsubscribe fail "+ JSON.stringify(err));
})
try{
let result: MqttResponse = await this.mqttAsyncClient.unsubscribe(subscribeOption)
console.log("mqtt unsubscribe success "+ JSON.stringify(result));
}catch(err){
console.log("mqtt unsubscribe fail "+ JSON.stringify(err));
}
```
### messageArrived
messageArrived(callback: AsyncCallback<MqttMessage>): void
接收消息,使用此接口后,当订阅的主题有消息发布时,会自动接收到消息。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|-------------|------------------------------------------------|---------|------------|
| callback | AsyncCallback< [MqttMessage](#mqttmessage) > | 是 | 回调函数 |
示例:
```typescript
this.mqttAsyncClient.messageArrived((err: Error, data: MqttMessage) => {
// to do Something
});
```
### disconnect
disconnect(callback: AsyncCallback<MqttResponse>): void
断开连接。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|------------|--------------------------------------------------|-----------|-------------|
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
this.mqttAsyncClient.disconnect((err: Error, data: MqttResponse) => {
// to do Something
});
```
### disconnect
disconnect(): Promise<MqttResponse>
断开连接。
返回值:
| 类型 | 说明 |
|------------------------------------------|----------------------|
| Promise<[MqttResponse](#mqttresponse)> | 以Promise形式返回断开连接的结果。 |
示例:
```typescript
this.mqttAsyncClient.disconnect().then((data: MqttResponse) => {
console.log("mqtt disconnect success "+ JSON.stringify(result));;
}).catch((err: MqttResponse) => {
console.log("mqtt disconnect fail "+ JSON.stringify(err));
})
try{
let result: MqttResponse = await this.mqttAsyncClient.disconnect()
console.log("mqtt disconnect success "+ JSON.stringify(result));
}catch(err){
console.log("mqtt disconnect fail "+ JSON.stringify(err));
}
```
### connectLost
connectLost(callback: AsyncCallback<MqttResponse>): void
当被动的断开连接后的回调(比如断网),可以在回调中尝试重新连接。
参数:
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| callback | AsyncCallback< [MqttResponse](#mqttresponse) > | 是 | 回调函数 |
示例:
```typescript
this.mqttAsyncClient.connectLost((err: Error, data: MqttResponse) => {
// to do Something
});
```
### isConnected
isConnected(): Promise<boolean>
是否已连接。
返回值:
| 类型 | 说明 |
|------------------|------------------------|
| Promise<boolean> | 以Promise形式返回判断是否连接的结果。 |
示例:
```typescript
this.mqttAsyncClient.isConnected().then((data: boolean) => {
console.log("result: "+data)
});
let result: boolean = await this.mqttAsyncClient.isConnected() //true or false
```
### reconnect
reconnect(): Promise<boolean>
重新连接(必须之前连接过)。
返回值:
| 类型 | 说明 |
|------------------|---------------------|
| Promise<boolean> | 以Promise形式返回重连的的结果。 |
示例:
```typescript
this.mqttAsyncClient.reconnect().then((data: boolean) => {
console.log('result: ' + data)
});
let result: boolean = await this.mqttAsyncClient.reconnect() //true or false
```
### destroy
destroy(): Promise<boolean>
销毁客户端。
返回值:
| 类型 | 说明 |
|------------------|--------------------|
| Promise<boolean> | 以Promise形式返回销毁的结果。 |
示例:
```typescript
this.mqttAsyncClient.destroy().then((data: boolean) => {
console.log('result: ' + data)
});
let result: boolean = await this.mqttAsyncClient.destroy() //true or false
```
### setMqttTrace
setMqttTrace(level: MQTTASYNC_TRACE_LEVELS): void
设置hilog中跟踪信息的级别。
```typescript
this.mqttAsyncClient.setMqttTrace(6);
```
参数:
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| level | MQTTASYNC_TRACE_LEVELS | 是 | 消息跟踪级别 |
### MQTTASYNC_TRACE_LEVELS
消息跟踪级别
| 名称 | 值 |
|--------------------------| ----- |
| MQTTASYNC_TRACE_MAXIMUM | 1 |
| MQTTASYNC_TRACE_MEDIUM | 2 |
| MQTTASYNC_TRACE_MINIMUM | 3 |
| MQTTASYNC_TRACE_PROTOCOL | 4 |
| MQTTASYNC_TRACE_ERROR | 5 |
| MQTTASYNC_TRACE_SEVERE | 6 |
| MQTTASYNC_TRACE_FATAL | 7 |
### MqttAsyncClientOptions
创建客户端可选参数的类型和可选范围
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| url | string | 是 | 以null结尾的字符串,指定客户端将连接到的服务器。它采取的形式protocol://host:port.protocol必须是tcp、ssl、ws或wss。对于主机,可以指定IP地址或主机名。例如,tcp://localhost:1883 |
| clientId | string | 是 | 客户端连接到服务器时传递给服务器的客户端标识符。它是一个以空结尾的UTF-8编码字符串 |
| persistenceType | PersistenceType | 否 | 客户端使用的持久性类型,0=默认值:使用默认(基于文件系统)持久性机制。1=在内存持久性中使用。2=使用特定于应用程序的持久性实现 |
### MqttConnectOptions
客户端连接服务器可选参数的类型和可选范围
| 参数名 | 类型 |必填 | 默认值 | 说明 |
| --------------------- | ---------------| -------| -------- | --------------------------- |
| cleanSession | boolean | 否 | true |这是一个布尔值。设置控制客户端和服务器在连接和断开连接时的行为 |
| connectTimeout | number | 否 | 30s |设置连接超时时间,默认 |
| keepAliveInterval | number | 否 | 60s | 保持活动间隔 |
| serverURIs | Array<string> | 否 | | 客户端连接到的服务器url |
| retryInterval | number | 否 | 0 | 未确认的发布请求的时间间隔 |
| sslOptions | number | 否 | | 参考[sslOptions](#ssloptions) |
| willOptions | number | 否 | | 参考[willOptions](#willoptions) |
| MQTTVersion | number | 否 | 0 |设置要在连接上使用的MQTT版本, 0=默认值:从3.1.1开始,如果失败,则返回到3.1,3=仅尝试版本3.1,4=仅尝试3.1.1版本 |
| automaticReconnect | boolean | 否 | false | 是否在连接丢失的情况下自动重新连接 |
| minRetryInterval | number | 否 | 1s | 以秒为单位的最小重试间隔。每次重试失败时加倍 |
| maxRetryInterval | number | 否 | 60s | 以秒为单位的最大重试间隔。重试失败时,加倍在此停止 |
| userName | string | 是 | | 用户名 |
| password | string | 是 | | 密码 |
### sslOptions
ssl连接的可选参数的类型的可选的范围。
| 参数名 | 类型 |必填 | 默认值 | 说明 |
| --------------------- | ---------------| -------| -------- | --------------------------- |
| enableServerCertAuth | boolean | 否 | false |是否启用服务器证书身份验证 |
| verify | boolean | 否 | false |是否验证主机名 |
| caPath | string | 否 | NULL |如果CApath不为NULL,则它指向包含PEM格式的CA证书的目录 |
| trustStore | string | 否 | NULL |PEM格式的文件,其中包含客户端信任的公共数字证书。它必须在设备中设置本地文件路径,并且必须可以访问该文件。 |
| keyStore | string | 否 | NULL |PEM格式的文件,包含客户端的公共证书链。它还可能包括客户端的私钥。它必须在设备中设置本地文件路径,并且必须可以访问该文件 |
| privateKey | string | 否 | NULL |如果未包含在sslKeyStore中,则此设置指向PEM格式的文件,该文件包含客户端的私钥。它必须在设备中设置本地文件路径,并且必须可以访问该文件。 |
| privateKeyPassword | string | 否 | NULL |如果加密,则加载客户端私钥的密码 |
| enabledCipherSuites | string | 否 | “ALL” |客户端将在SSL握手期间呈现给服务器的密码套件列表。如果忽略此设置,其默认值将为“ALL”,即,将考虑所有密码套件,不包括不提供加密的套件 |
### willOptions
定义客户机的MQTT“Last Will and Testament”(LWT)设置。如果客户端意外断开与服务器的连接,服务器将代表客户端将LWT消息发布到LWT主题。这允许其他客户端(订阅了LWT主题)知道客户端已断开连接。
| 参数名 | 类型 |必填 | 默认值 | 说明 |
| --------------------- | ---------------| -------| -------- | --------------------------- |
| topicName | string | 是 | |主题名称 |
| message | string | 是 | |发布的消息 |
| retained | boolean | 否 | flase |是否保留此消息 |
| qos | QoS | 否 | 0 |LWT消息的服务质量设置 |
### MqttSubscribeOptions
发布消息可选参数类型的可选范围
| 参数名 | 类型 |必填 | 默认值 | 说明 |
| --------------------- | ---------------| -------| -------- | --------------------------- |
| topic | string | 是 | |主题名称 |
| qos | QoS | 是 | 0 |消息的服务质量设置 。 |
### MqttPublishOptions
订阅主题的可选参数类型和可选范围
| 参数名 | 类型 |必填 | 默认值 | 说明 |
| --------------------- | ---------------| -------| -------- |--------------------------|
| topic | string | 是 | | 主题名称 |
| payload | string | 是 | | 发布的消息 |
| qos | QoS | 是 | | 消息的服务质量设置 |
| retained | boolean | 否 | flase | 是否保留此消息 |
| dup | boolean | 否 | flase | 此消息是否重复,它仅在接收QoS1消息时才有意义 |
| msgid | number | 否 | 0 | 消息标识符保留供MQTT客户机和服务器内部使用 |
### MqttResponse
mqtt接口的返回值类型
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| message | string | 是 | 返回接口调用信息 ,成功或失败 |
| code | number | 是 | 如果返回值0,则操作成功。 |
### MqttMessage
messageArrived接口的返回类型
| 参数名 | 类型 |必填 | 说明 |
| -------- | ------------------------ | ---------- | --------------------------- |
| topic | string | 是 |主题名称 |
| payload | string | 是 |发布的消息 |
| qos | QoS | 是 |消息的服务质量设置 |
| retained | number | 是 |是否保留此消息 |
| dup | number | 是 |此消息是否重复,它仅在接收QoS1消息时才有意义 |
| msgid | number | 是 |消息标识符保留供MQTT客户机和服务器内部使用 |
[单元测试用例详情](https://gitee.com/openharmony-tpc/ohos_mqtt/blob/master/TEST.md)
## 约束与限制
在下述版本验证通过:
DevEco Studio: 4.1.3.500, SDK: API11 (4.1.0.63)
DevEco Studio: 4.0 Beta2(4.0.3.512), SDK: API10 (4.0.10.9)
DevEco Studio: 3.1 Beta2(3.1.0.400), SDK: API9 Release(3.2.12.2)
## 目录结构
````
|----ohos_mqtt
| |---- entry # 示例代码文件夹
| |---- ohos_Mqtt # ohos_Mqtt库文件夹
| |---- cpp # c/c++和napi代码
| |---- mqtt_napi # mqtt的napi逻辑代码
| |---- CMakeLists.txt # 构建脚本
| |---- boundscheck # 子模块third_party_bounds_checking_function
| |---- paho.mqtt.c # 子模块paho.mqtt.c
| |---- ets # 接口声明
| |---- index.ets # 对外接口
| |---- README.md # 安装使用方法
````
## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/openharmony-tpc/ohos_mqtt/issues) 给我们,当然,我们也非常欢迎你给我们发 [PR](https://gitee.com/openharmony-tpc/ohos_mqtt/pulls) 。
## 开源协议
本项目基于 [Eclipse Public License - v 2.0](https://gitee.com/openharmony-tpc/ohos_mqtt/blob/master/LICENSE) ,请自由地享受和参与开源。
- 1.
- 2.
- 3.
- 4.
- 5.
- 6.
- 7.
- 8.
- 9.
- 10.
- 11.
- 12.
- 13.
- 14.
- 15.
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22.
- 23.
- 24.
- 25.
- 26.
- 27.
- 28.
- 29.
- 30.
- 31.
- 32.
- 33.
- 34.
- 35.
- 36.
- 37.
- 38.
- 39.
- 40.
- 41.
- 42.
- 43.
- 44.
- 45.
- 46.
- 47.
- 48.
- 49.
- 50.
- 51.
- 52.
- 53.
- 54.
- 55.
- 56.
- 57.
- 58.
- 59.
- 60.
- 61.
- 62.
- 63.
- 64.
- 65.
- 66.
- 67.
- 68.
- 69.
- 70.
- 71.
- 72.
- 73.
- 74.
- 75.
- 76.
- 77.
- 78.
- 79.
- 80.
- 81.
- 82.
- 83.
- 84.
- 85.
- 86.
- 87.
- 88.
- 89.
- 90.
- 91.
- 92.
- 93.
- 94.
- 95.
- 96.
- 97.
- 98.
- 99.
- 100.
- 101.
- 102.
- 103.
- 104.
- 105.
- 106.
- 107.
- 108.
- 109.
- 110.
- 111.
- 112.
- 113.
- 114.
- 115.
- 116.
- 117.
- 118.
- 119.
- 120.
- 121.
- 122.
- 123.
- 124.
- 125.
- 126.
- 127.
- 128.
- 129.
- 130.
- 131.
- 132.
- 133.
- 134.
- 135.
- 136.
- 137.
- 138.
- 139.
- 140.
- 141.
- 142.
- 143.
- 144.
- 145.
- 146.
- 147.
- 148.
- 149.
- 150.
- 151.
- 152.
- 153.
- 154.
- 155.
- 156.
- 157.
- 158.
- 159.
- 160.
- 161.
- 162.
- 163.
- 164.
- 165.
- 166.
- 167.
- 168.
- 169.
- 170.
- 171.
- 172.
- 173.
- 174.
- 175.
- 176.
- 177.
- 178.
- 179.
- 180.
- 181.
- 182.
- 183.
- 184.
- 185.
- 186.
- 187.
- 188.
- 189.
- 190.
- 191.
- 192.
- 193.
- 194.
- 195.
- 196.
- 197.
- 198.
- 199.
- 200.
- 201.
- 202.
- 203.
- 204.
- 205.
- 206.
- 207.
- 208.
- 209.
- 210.
- 211.
- 212.
- 213.
- 214.
- 215.
- 216.
- 217.
- 218.
- 219.
- 220.
- 221.
- 222.
- 223.
- 224.
- 225.
- 226.
- 227.
- 228.
- 229.
- 230.
- 231.
- 232.
- 233.
- 234.
- 235.
- 236.
- 237.
- 238.
- 239.
- 240.
- 241.
- 242.
- 243.
- 244.
- 245.
- 246.
- 247.
- 248.
- 249.
- 250.
- 251.
- 252.
- 253.
- 254.
- 255.
- 256.
- 257.
- 258.
- 259.
- 260.
- 261.
- 262.
- 263.
- 264.
- 265.
- 266.
- 267.
- 268.
- 269.
- 270.
- 271.
- 272.
- 273.
- 274.
- 275.
- 276.
- 277.
- 278.
- 279.
- 280.
- 281.
- 282.
- 283.
- 284.
- 285.
- 286.
- 287.
- 288.
- 289.
- 290.
- 291.
- 292.
- 293.
- 294.
- 295.
- 296.
- 297.
- 298.
- 299.
- 300.
- 301.
- 302.
- 303.
- 304.
- 305.
- 306.
- 307.
- 308.
- 309.
- 310.
- 311.
- 312.
- 313.
- 314.
- 315.
- 316.
- 317.
- 318.
- 319.
- 320.
- 321.
- 322.
- 323.
- 324.
- 325.
- 326.
- 327.
- 328.
- 329.
- 330.
- 331.
- 332.
- 333.
- 334.
- 335.
- 336.
- 337.
- 338.
- 339.
- 340.
- 341.
- 342.
- 343.
- 344.
- 345.
- 346.
- 347.
- 348.
- 349.
- 350.
- 351.
- 352.
- 353.
- 354.
- 355.
- 356.
- 357.
- 358.
- 359.
- 360.
- 361.
- 362.
- 363.
- 364.
- 365.
- 366.
- 367.
- 368.
- 369.
- 370.
- 371.
- 372.
- 373.
- 374.
- 375.
- 376.
- 377.
- 378.
- 379.
- 380.
- 381.
- 382.
- 383.
- 384.
- 385.
- 386.
- 387.
- 388.
- 389.
- 390.
- 391.
- 392.
- 393.
- 394.
- 395.
- 396.
- 397.
- 398.
- 399.
- 400.
- 401.
- 402.
- 403.
- 404.
- 405.
- 406.
- 407.
- 408.
- 409.
- 410.
- 411.
- 412.
- 413.
- 414.
- 415.
- 416.
- 417.
- 418.
- 419.
- 420.
- 421.
- 422.
- 423.
- 424.
- 425.
- 426.
- 427.
- 428.
- 429.
- 430.
- 431.
- 432.
- 433.
- 434.
- 435.
- 436.
- 437.
- 438.
- 439.
- 440.
- 441.
- 442.
- 443.
- 444.
- 445.
- 446.
- 447.
- 448.
- 449.
- 450.
- 451.
- 452.
- 453.
- 454.
- 455.
- 456.
- 457.
- 458.
- 459.
- 460.
- 461.
- 462.
- 463.
- 464.
- 465.
- 466.
- 467.
- 468.
- 469.
- 470.
- 471.
- 472.
- 473.
- 474.
- 475.
- 476.
- 477.
- 478.
- 479.
- 480.
- 481.
- 482.
- 483.
- 484.
- 485.
- 486.
- 487.
- 488.
- 489.
- 490.
- 491.
- 492.
- 493.
- 494.
- 495.
- 496.
- 497.
- 498.
- 499.
- 500.
- 501.
- 502.
- 503.
- 504.
- 505.
- 506.
- 507.
- 508.
- 509.
- 510.
- 511.
- 512.
- 513.
- 514.
- 515.
- 516.
- 517.
- 518.
- 519.
- 520.
- 521.
- 522.
- 523.
- 524.
- 525.
- 526.
- 527.
- 528.
- 529.
- 530.
- 531.
- 532.
- 533.
- 534.
- 535.
- 536.
- 537.
- 538.
- 539.
- 540.
- 541.
- 542.
- 543.
- 544.
- 545.
- 546.
- 547.
- 548.
- 549.
- 550.
- 551.
- 552.
- 553.
- 554.
- 555.
- 556.
- 557.
- 558.
- 559.
- 560.
- 561.
- 562.
- 563.
- 564.
- 565.
- 566.
- 567.
- 568.
- 569.
- 570.
- 571.
- 572.
- 573.
- 574.
- 575.
- 576.
- 577.
- 578.
- 579.
- 580.
- 581.
- 582.
- 583.
- 584.
- 585.
- 586.
- 587.
- 588.
- 589.
- 590.
- 591.
- 592.
- 593.
- 594.
- 595.
- 596.
- 597.
- 598.
- 599.
- 600.
- 601.
- 602.
- 603.
- 604.
- 605.
- 606.
- 607.
- 608.
- 609.
- 610.
- 611.
- 612.
- 613.
- 614.
- 615.
- 616.
- 617.
- 618.
- 619.
- 620.
- 621.
- 622.
- 623.
- 624.
- 625.
- 626.
- 627.
- 628.
- 629.
- 630.
- 631.
- 632.
- 633.
- 634.
- 635.
- 636.
- 637.
- 638.
- 639.
- 640.
- 641.
- 642.
- 643.
- 644.
- 645.
- 646.
- 647.
- 648.
- 649.
- 650.
- 651.
- 652.
- 653.
- 654.
- 655.
- 656.
- 657.
- 658.
- 659.
- 660.
- 661.
- 662.
- 663.
- 664.
- 665.
- 666.
- 667.
- 668.
- 669.
- 670.
- 671.
- 672.