newsie

介绍

newsie 是一款实现了 NNTP 客户端协议的三方库，适用于openharmony。

下载

1 丶安装

    ohpm install @ohos/newsie

OpenHarmony ohpm 环境配置等更多内容，请参考 如何安装 OpenHarmony ohpm 包

2 丶导入

    import Client from '@ohos/newsie'

Demo 样例

API：connect

描述：连接服务器(为保证demo和XTS正常运行，需要全局搜素项目中的xxx，替换为正确的服务器ip)

this.client = new Client({
  host: "xxx.xxx.xxx.xxx",
  port: 8084,
});
await this.client.connect();

API：list

描述：获取新闻组列表

await this.client.list();

API：group

描述：获取指定新闻组信息，并选中

await this.client.group(this.select_group);

API：newgroups

描述：获取某个时间后的新闻组

await this.client.newgroups(new Date());

API：date

描述：获取服务器日期

await this.client.date();

更多样例参照该 Demo 工程中Index页面

软件架构

|-entry
    |-ets
    |   |-entryability
    |           |-EntryAbility.ts
    |   |-pages
    |           |-Index.ets             #主页demo
|-library   # newsie组件

接口

模块名	功能	备注
connect	连接服务器
list	获取全部新闻组
group	获取并选中文章
newgroups	获取某个时间后的新闻组	时间为 UTC 时间
newnews	获取某个新闻组下，某个时间后的文章
listActive	文章列表
listNewsgroups	获取新闻组
listOverviewFmt	获取新闻组的部分信息
hdr	发送 HDR 指令
listGroup	获取全部文章号
article	文章详情
head	文章头信息
body	文章主体信息
stat	判断文章是否存在
over	文章的全部信息
help	获取帮助指令
capabilities	返回服务端能力列表
date	返回服务端日期
modeReader	模式切换
quit	结束会话
listHeaders	发送 LISTHEADERS 指令
last	上一篇文章
next	下一篇文章
listDistribPats	发送 LISTDISTRIBPATS 指令
listActiveTimes	发送 LISTACTIVETIMES 指令
ihave	知会服务端有这样一篇文章，如果服务端需要就返回 335
check	检查
modeStream	发送 MODESTREAM 指令
slave	发送 SLAVE 指令
compressDeflate	压缩
post	提交

更多模块的使用可参考官方文档，单元测试用例详情见TEST.md

关于混淆

• 代码混淆，请查看代码混淆简介
• 如果希望三方库在代码混淆过程中不会被混淆，需要在混淆规则配置文件obfuscation-rules.txt中添加相应的排除规则：

-keep
./oh_modules/@ohos/newsie

约束与限制

在下述版本验证通过：

DevEco Studio: 4.1 Canary2(4.1.3.313), SDK: API11 (4.1.3.1) DevEco Studio: 4.0.1.400, SDK: API10 (4.0.0.24)

开源协议

本项目基于 GNU AFFERO GENERAL ，请自由地享受和参与开源。

贡献代码

使用过程中发现任何问题都可以提 Issue，当然，也非常欢迎发 PR 共建。