# RxRetroJsoup

**Repository Path**: openneusoft/rx-retro-jsoup

## Basic Information

- **Project Name**: RxRetroJsoup
- **Description**: 响应式的请求网络框架
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2021-04-17
- **Last Updated**: 2024-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RxRetroJsoup

**本项目是基于开源项目RxRetroJsoup进行ohos化的移植和开发的，可以通过项目标签以及github地址（https://github.com/florent37/RxRetroJsoup）追踪到原项目版本**

#### 项目介绍

- 项目名称：一个简单API
- 所属系列：ohos的第三方组件适配移植
- 功能：RxRetroJsoup 是一个简单API，通过注解里设定的检索对象，可以把任意web网站clone给鸿蒙系统应用
- 项目移植状态：完成
- 调用差异：无
- 项目作者和维护人：
- 联系方式：
- 原项目Doc地址：
- 原项目基线版本：v1.0.3
- 编程语言：Java 
- 外部库依赖：无

#### 效果展示

<img src="rx-retro-jsoup.gif"/>

#### 安装教程

方法1.

1. 编译har包RxRetroJsoup.har。
2. 启动 DevEco Studio，将编译的har包，导入工程目录“entry->libs”下。
3. 在moudle级别下的build.gradle文件中添加依赖，在dependences标签中增加对libs目录下har包的引用。

```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
	……
}
```

4. 在导入的har包上点击右键，选择“Add as Library”对包进行引用，选择需要引用的模块，并点击“OK”即引用成功。

方法2.

1. 在工程的build.gradle的allprojects中，添加HAR所在的Maven仓地址

```
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/releases/' 
    }
}
```

2. 在应用模块的build.gradle的dependencies闭包中，添加如下代码:

```
dependencies {
    classpath 'io.github.dzsf:rx-retro-jsoup-retrojsoup:1.0.1'
    classpath 'io.github.dzsf:rx-retro-jsoup-retrojsoup-compiler:1.0.1'
    classpath 'io.github.dzsf:rx-retro-jsoup-rxjsoup:1.0.1'
}
```

#### 使用说明

1. 创建一个带有`@Select`注释方法的接口

```
public interface TutoOhosFrance {

    @Select("article")
    Observable<Article> articles();

}
```

2. 使用Jsoup queries ( https://jsoup.org/cookbook/extracting-data/selector-syntax )注释模型

```
public class Article {

    @JsoupText(".entry-title a")
    public String title;

    @JsoupHref(".read-more a")
    public String href;

    @JsoupSrc(".entry-content img")
    public String image;

    @JsoupText(".entry-content p")
    public String description;

    public Article() {
    }
    ...
}
```

3. 创建一个RetroJsoup

```
final TutoOhosFrance tutosOhosFrance = new RetroJsoup.Builder()
        .url("https://www.html5tricks.com/category/html5-demo")
        .client(okHttpClient)
        .build()
        .create(TutoOhosFrance.class);
```

#### 版本迭代

- v1.0.1

#### 版权和许可信息
- Apache Licence