├── net
├── .gitignore
├── consumer-rules.pro
├── src
│ └── main
│ │ ├── java
│ │ └── com
│ │ │ └── drake
│ │ │ └── net
│ │ │ ├── utils
│ │ │ ├── LegacyTLS.kt
│ │ │ └── TipUtils.kt
│ │ │ ├── time
│ │ │ └── IntervalStatus.kt
│ │ │ ├── request
│ │ │ └── Method.kt
│ │ │ ├── reflect
│ │ │ └── TypeUtils.kt
│ │ │ ├── cache
│ │ │ └── CacheMode.kt
│ │ │ ├── interceptor
│ │ │ └── RequestInterceptor.kt
│ │ │ ├── exception
│ │ │ ├── NetConnectException.kt
│ │ │ ├── NetworkingException.kt
│ │ │ ├── NetUnknownHostException.kt
│ │ │ ├── HttpFailureException.kt
│ │ │ ├── NetSocketTimeoutException.kt
│ │ │ ├── URLParseException.kt
│ │ │ ├── ConvertException.kt
│ │ │ ├── DownloadFileException.kt
│ │ │ ├── RequestParamsException.kt
│ │ │ ├── ServerResponseException.kt
│ │ │ ├── ResponseException.kt
│ │ │ ├── HttpResponseException.kt
│ │ │ └── NoCacheException.kt
│ │ │ ├── transform
│ │ │ └── DeferredTransform.kt
│ │ │ ├── log
│ │ │ └── MessageType.kt
│ │ │ ├── okhttp
│ │ │ └── OkHttpExtension.kt
│ │ │ ├── interfaces
│ │ │ └── ProgressListener.kt
│ │ │ └── internal
│ │ │ └── NetInitializer.kt
│ │ └── res
│ │ ├── xml
│ │ └── network_security_config.xml
│ │ └── drawable
│ │ ├── ic_limited_time.xml
│ │ └── ic_timing.xml
└── build.gradle
├── sample
├── .gitignore
├── src
│ ├── main
│ │ ├── res
│ │ │ ├── raw
│ │ │ │ ├── config.json
│ │ │ │ ├── user.json
│ │ │ │ ├── data.json
│ │ │ │ └── array.json
│ │ │ ├── drawable
│ │ │ │ ├── bg_empty.webp
│ │ │ │ ├── bg_error.webp
│ │ │ │ ├── bg_input.xml
│ │ │ │ ├── bg_card.xml
│ │ │ │ ├── ic_convert.xml
│ │ │ │ ├── ic_menu.xml
│ │ │ │ ├── ic_interceptor.xml
│ │ │ │ ├── ic_unique.xml
│ │ │ │ ├── ic_fastest.xml
│ │ │ │ ├── ic_sync_request.xml
│ │ │ │ ├── ic_callback_request.xml
│ │ │ │ ├── ic_parallel_network.xml
│ │ │ │ ├── ic_pull_refresh.xml
│ │ │ │ ├── ic_scope.xml
│ │ │ │ ├── ic_async_task.xml
│ │ │ │ ├── ic_download_file.xml
│ │ │ │ ├── ic_upload_file.xml
│ │ │ │ ├── ic_switch_dispatcher.xml
│ │ │ │ ├── ic_read_cache.xml
│ │ │ │ ├── ic_interval.xml
│ │ │ │ ├── ic_simple_request.xml
│ │ │ │ ├── ic_state_layout.xml
│ │ │ │ ├── ic_view_model.xml
│ │ │ │ ├── ic_push_refresh.xml
│ │ │ │ ├── ic_exception_trace.xml
│ │ │ │ ├── ic_error_handler.xml
│ │ │ │ ├── ic_debounce.xml
│ │ │ │ ├── ic_config_dialog.xml
│ │ │ │ └── ic_https.xml
│ │ │ ├── mipmap-hdpi
│ │ │ │ ├── ic_launcher.png
│ │ │ │ └── ic_launcher_round.png
│ │ │ ├── mipmap-mdpi
│ │ │ │ ├── ic_launcher.png
│ │ │ │ └── ic_launcher_round.png
│ │ │ ├── mipmap-xhdpi
│ │ │ │ ├── ic_launcher.png
│ │ │ │ └── ic_launcher_round.png
│ │ │ ├── mipmap-xxhdpi
│ │ │ │ ├── ic_launcher.png
│ │ │ │ └── ic_launcher_round.png
│ │ │ ├── mipmap-xxxhdpi
│ │ │ │ ├── ic_launcher.png
│ │ │ │ └── ic_launcher_round.png
│ │ │ ├── values
│ │ │ │ ├── strings.xml
│ │ │ │ ├── styles.xml
│ │ │ │ └── colors.xml
│ │ │ ├── mipmap-anydpi-v26
│ │ │ │ ├── ic_launcher.xml
│ │ │ │ └── ic_launcher_round.xml
│ │ │ ├── menu
│ │ │ │ ├── menu_download.xml
│ │ │ │ ├── menu_converter.xml
│ │ │ │ ├── menu_interval.xml
│ │ │ │ └── menu_request_method.xml
│ │ │ ├── layout
│ │ │ │ ├── layout_loading.xml
│ │ │ │ ├── fragment_pull_refresh.xml
│ │ │ │ ├── fragment_fastest.xml
│ │ │ │ ├── fragment_sync_request.xml
│ │ │ │ ├── fragment_async_task.xml
│ │ │ │ ├── fragment_callback_request.xml
│ │ │ │ ├── fragment_interceptor.xml
│ │ │ │ ├── fragment_coroutine_scope.xml
│ │ │ │ ├── fragment_exception_trace.xml
│ │ │ │ ├── fragment_error_handler.xml
│ │ │ │ ├── fragment_parallel_network.xml
│ │ │ │ ├── fragment_simple_request.xml
│ │ │ │ ├── fragment_switch_dispatcher.xml
│ │ │ │ ├── fragment_super_interval.xml
│ │ │ │ ├── fragment_auto_dialog.xml
│ │ │ │ ├── fragment_read_cache.xml
│ │ │ │ ├── fragment_state_layout.xml
│ │ │ │ ├── fragment_push_refresh.xml
│ │ │ │ ├── fragment_limited_time.xml
│ │ │ │ ├── fragment_custom_convert.xml
│ │ │ │ ├── item_game.xml
│ │ │ │ ├── item_pull_list.xml
│ │ │ │ ├── layout_empty.xml
│ │ │ │ ├── fragment_edit_debounce.xml
│ │ │ │ ├── layout_error.xml
│ │ │ │ ├── fragment_https_certificate.xml
│ │ │ │ ├── fragment_upload_file.xml
│ │ │ │ ├── fragment_view_model_request.xml
│ │ │ │ ├── fragment_download_file.xml
│ │ │ │ ├── fragment_timing_request.xml
│ │ │ │ ├── activity_main.xml
│ │ │ │ ├── fragment_unique_request.xml
│ │ │ │ └── layout_drawer_nav_header.xml
│ │ │ └── navigation
│ │ │ │ └── nav_converter.xml
│ │ ├── java
│ │ │ └── com
│ │ │ │ └── drake
│ │ │ │ └── net
│ │ │ │ └── sample
│ │ │ │ ├── model
│ │ │ │ ├── ArrayData.kt
│ │ │ │ ├── SubData.kt
│ │ │ │ ├── BasicData.kt
│ │ │ │ ├── ConfigModel.kt
│ │ │ │ ├── TokenModel.kt
│ │ │ │ ├── UserInfoModel.kt
│ │ │ │ └── GameModel.kt
│ │ │ │ ├── constants
│ │ │ │ ├── UserConfig.kt
│ │ │ │ └── Api.kt
│ │ │ │ ├── interceptor
│ │ │ │ ├── GlobalHeaderInterceptor.kt
│ │ │ │ ├── RefreshTokenInterceptor.kt
│ │ │ │ └── EncryptDataInterceptor.kt
│ │ │ │ ├── converter
│ │ │ │ ├── FastJsonConverter.kt
│ │ │ │ ├── GsonConverter.kt
│ │ │ │ ├── MoshiConverter.kt
│ │ │ │ └── ProtobufConverter.kt
│ │ │ │ ├── ui
│ │ │ │ ├── fragment
│ │ │ │ │ ├── StateLayoutFragment.kt
│ │ │ │ │ ├── ExceptionTraceFragment.kt
│ │ │ │ │ ├── InterceptorFragment.kt
│ │ │ │ │ ├── ErrorHandlerFragment.kt
│ │ │ │ │ ├── SwitchDispatcherFragment.kt
│ │ │ │ │ ├── AsyncTaskFragment.kt
│ │ │ │ │ ├── ParallelNetworkFragment.kt
│ │ │ │ │ ├── ReadCacheFragment.kt
│ │ │ │ │ ├── converter
│ │ │ │ │ │ ├── FastJsonConvertFragment.kt
│ │ │ │ │ │ ├── GsonConvertFragment.kt
│ │ │ │ │ │ ├── MoshiConvertFragment.kt
│ │ │ │ │ │ ├── BaseConvertFragment.kt
│ │ │ │ │ │ └── SerializationConvertFragment.kt
│ │ │ │ │ ├── SyncRequestFragment.kt
│ │ │ │ │ ├── UniqueRequestFragment.kt
│ │ │ │ │ ├── AutoDialogFragment.kt
│ │ │ │ │ ├── PullRefreshFragment.kt
│ │ │ │ │ ├── PushRefreshFragment.kt
│ │ │ │ │ ├── CallbackRequestFragment.kt
│ │ │ │ │ ├── ViewModelRequestFragment.kt
│ │ │ │ │ ├── CoroutineScopeFragment.kt
│ │ │ │ │ ├── PreviewCacheFragment.kt
│ │ │ │ │ ├── LimitedTimeFragment.kt
│ │ │ │ │ ├── SuperIntervalFragment.kt
│ │ │ │ │ └── HttpsCertificateFragment.kt
│ │ │ │ └── activity
│ │ │ │ │ └── MainActivity.kt
│ │ │ │ ├── contract
│ │ │ │ └── AlbumSelectContract.kt
│ │ │ │ ├── utils
│ │ │ │ ├── HttpUtils.kt
│ │ │ │ └── AESUtils.kt
│ │ │ │ └── vm
│ │ │ │ └── UserViewModel.kt
│ │ └── AndroidManifest.xml
│ ├── test
│ │ └── java
│ │ │ └── com
│ │ │ └── drake
│ │ │ └── net
│ │ │ └── ExampleUnitTest.kt
│ └── androidTest
│ │ └── java
│ │ └── com
│ │ └── drake
│ │ └── net
│ │ └── ExampleInstrumentedTest.kt
└── proguard-rules.pro
├── settings.gradle
├── signed
├── docs
├── img
│ ├── logo.gif
│ ├── preview.png
│ ├── code-preview.png
│ ├── book-open.svg
│ ├── discussesions.svg
│ └── issues.svg
├── api
│ ├── styles
│ │ ├── logo-styles.css
│ │ └── jetbrains-mono.css
│ ├── images
│ │ ├── logo-icon.svg
│ │ ├── copy-icon.svg
│ │ ├── footer-go-to-link.svg
│ │ ├── arrow_down.svg
│ │ ├── copy-successful-icon.svg
│ │ ├── go-to-top-icon.svg
│ │ ├── anchor-copy-button.svg
│ │ └── docs_logo.svg
│ └── scripts
│ │ ├── sourceset_dependencies.js
│ │ └── clipboard.js
├── repeat-request.md
├── track.md
├── callback.md
├── error.md
├── coroutine-request.md
├── issues.md
├── cookie.md
├── sync-request.md
├── error-global.md
├── upload-file.md
├── auto-pull.md
├── cancel.md
├── okhttp-client.md
├── log-notice.md
├── debounce.md
├── error-single.md
├── interval.md
├── timing.md
├── view-model.md
├── https.md
├── download-file.md
├── model-generate.md
├── auto-refresh.md
├── css
│ └── extra.css
├── converter.md
└── interceptor.md
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── .gitignore
├── .github
├── workflows
│ └── main.yml
└── ISSUE_TEMPLATE
│ └── ----.md
├── gradle.properties
└── LICENSE
/net/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/sample/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 | /release
3 |
--------------------------------------------------------------------------------
/sample/src/main/res/raw/config.json:
--------------------------------------------------------------------------------
1 | {
2 | "maintain": false
3 | }
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | include ':sample', ':net'
2 | rootProject.name='Net'
3 |
--------------------------------------------------------------------------------
/signed:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/signed
--------------------------------------------------------------------------------
/docs/img/logo.gif:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/docs/img/logo.gif
--------------------------------------------------------------------------------
/docs/api/styles/logo-styles.css:
--------------------------------------------------------------------------------
1 | #logo {
2 | background-image: url(../images/docs_logo.svg);
3 | }
--------------------------------------------------------------------------------
/docs/img/preview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/docs/img/preview.png
--------------------------------------------------------------------------------
/net/consumer-rules.pro:
--------------------------------------------------------------------------------
1 | -keep class okhttp3.** { *; }
2 | -keep class com.drake.net.exception.** { *; }
--------------------------------------------------------------------------------
/docs/img/code-preview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/docs/img/code-preview.png
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/sample/src/main/res/raw/user.json:
--------------------------------------------------------------------------------
1 | {
2 | "userId": 23123132,
3 | "username": "test_account",
4 | "age": 17,
5 | "balance": "123.24"
6 | }
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/bg_empty.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/drawable/bg_empty.webp
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/bg_error.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/drawable/bg_error.webp
--------------------------------------------------------------------------------
/sample/src/main/res/raw/data.json:
--------------------------------------------------------------------------------
1 | {
2 | "code": 0,
3 | "msg": "OK",
4 | "data": {
5 | "title": "标题",
6 | "name": "名称"
7 | }
8 | }
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xxxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xxxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-hdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-hdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-mdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-mdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xxhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xxhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/liangjingkanji/Net-okhttp3/HEAD/sample/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/ArrayData.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 | class ArrayData {
4 | var title: String = ""
5 | var name: String = ""
6 | }
--------------------------------------------------------------------------------
/docs/api/images/logo-icon.svg:
--------------------------------------------------------------------------------
1 |
4 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/SubData.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 | class SubData : BasicData() {
4 | var title: String = ""
5 | var name: String = ""
6 | }
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/navEditor.xml
5 | /.idea/assetWizardSettings.xml
6 | .DS_Store
7 | /build
8 | /captures
9 | .externalNativeBuild
10 | .cxx
11 | /.idea/
12 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/BasicData.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 | open class BasicData {
4 | val code: String = ""
5 | val msg: String = ""
6 | val data: T? = null
7 | }
8 |
--------------------------------------------------------------------------------
/docs/img/book-open.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/ConfigModel.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 |
4 | import kotlinx.serialization.Serializable
5 |
6 | @Serializable
7 | data class ConfigModel(
8 | var maintain: Boolean = false
9 | )
--------------------------------------------------------------------------------
/docs/api/images/copy-icon.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/docs/api/images/footer-go-to-link.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/bg_input.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/TokenModel.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 | import kotlinx.serialization.Serializable
4 |
5 | @Serializable
6 | data class TokenModel(
7 | var token: String = "",
8 | var isExpired: Boolean = false
9 | )
--------------------------------------------------------------------------------
/docs/api/images/arrow_down.svg:
--------------------------------------------------------------------------------
1 |
4 |
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Thu Jul 28 17:18:47 CST 2022
2 | distributionBase=GRADLE_USER_HOME
3 | distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip
4 | distributionPath=wrapper/dists
5 | zipStorePath=wrapper/dists
6 | zipStoreBase=GRADLE_USER_HOME
7 |
--------------------------------------------------------------------------------
/docs/api/scripts/sourceset_dependencies.js:
--------------------------------------------------------------------------------
1 | sourceset_dependencies='{":net:dokkaHtml/androidTestRelease":[],":net:dokkaHtml/debug":[],":net:dokkaHtml/main":[],":net:dokkaHtml/release":[],":net:dokkaHtml/testFixtures":[],":net:dokkaHtml/testFixturesDebug":[],":net:dokkaHtml/testFixturesRelease":[]}'
2 |
--------------------------------------------------------------------------------
/sample/src/main/res/raw/array.json:
--------------------------------------------------------------------------------
1 | [
2 | {
3 | "title": "标题",
4 | "name": "名称"
5 | },
6 | {
7 | "title": "标题",
8 | "name": "名称"
9 | },
10 | {
11 | "title": "标题",
12 | "name": "名称"
13 | },
14 | {
15 | "title": "标题",
16 | "name": "名称"
17 | }
18 | ]
--------------------------------------------------------------------------------
/docs/api/images/copy-successful-icon.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/docs/api/images/go-to-top-icon.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/sample/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | Net
3 |
4 | Hello blank fragment
5 | assertk.Assert
6 |
7 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/UserInfoModel.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 |
4 | import kotlinx.serialization.Serializable
5 |
6 | @Serializable
7 | data class UserInfoModel(
8 | var userId: Int = 0,
9 | var username: String = "",
10 | var age: Int = 0,
11 | var balance: String = ""
12 | )
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/bg_card.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-anydpi-v26/ic_launcher.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/sample/src/main/res/menu/menu_download.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
--------------------------------------------------------------------------------
/sample/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_convert.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/.github/workflows/main.yml:
--------------------------------------------------------------------------------
1 | name: ci
2 | on:
3 | push:
4 | branches:
5 | - master
6 | jobs:
7 | deploy:
8 | runs-on: ubuntu-latest
9 | steps:
10 | - uses: actions/checkout@v2
11 | - uses: actions/setup-python@v2
12 | with:
13 | python-version: 3.x
14 | - run: pip install mkdocs-material
15 | - run: mkdocs gh-deploy --force
16 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/----.md:
--------------------------------------------------------------------------------
1 | ---
2 | name: 提交问题
3 | about: 详细的描述可以快速解决问题
4 | title: ''
5 | labels: 寻求帮助
6 | assignees: ''
7 |
8 | ---
9 |
10 | ## 问题描述
11 |
12 | ### 期望行为
13 |
14 | ## 如何复现
15 |
16 | > fork仓库并复现问题可以快速解决, 猜测只会让问题晦涩难懂, 耽误所有人时间
17 |
18 | ## 截图
19 |
20 | 异常堆栈信息或者手机截图/视频(拖拽到输入框即可上传)
21 |
22 | ## 版本
23 | - Net:
24 | - OkHttp:
25 | - Android:
26 | - Gradle:
27 | - Android Studio:
28 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_menu.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_interceptor.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_unique.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_fastest.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_sync_request.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_callback_request.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_parallel_network.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/test/java/com/drake/net/ExampleUnitTest.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net
2 |
3 | import org.junit.Assert.assertEquals
4 | import org.junit.Test
5 |
6 | /**
7 | * Example local unit test, which will execute on the development machine (host).
8 | *
9 | * See [testing documentation](http://d.android.com/tools/testing).
10 | */
11 | class ExampleUnitTest {
12 | @Test
13 | fun addition_isCorrect() {
14 | assertEquals(4, 2 + 2)
15 | }
16 | }
17 |
--------------------------------------------------------------------------------
/docs/repeat-request.md:
--------------------------------------------------------------------------------
1 | 常用于筛选列表请求, 选择新的筛选条件时应将上次未完成的取消后再发起请求
2 |
3 | 在Net禁止重复请求仅2行代码
4 |
5 | ```kotlin hl_lines="4"
6 | var scope: AndroidScope? = null
7 |
8 | btnFilter.setOnClickListener {
9 | scope?.cancel()
10 |
11 | scope = scopeNetLife {
12 | val result = Post(Api.PATH).await()
13 | }
14 | }
15 | ```
16 |
17 | 当`scope`不为空时表示存在旧请求, 无论旧请求是否完成都可以调用`cancel()`保证取消即可
18 |
19 | 1. [取消请求](cancel.md)
20 | 2. 限制时间强制使用缓存, [配置缓存有效期](cache.md#_3)
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_pull_refresh.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/docs/track.md:
--------------------------------------------------------------------------------
1 | Net中网络请求异常会LogCat输出, 除非开发者修改全局错误处理
2 |
3 |
4 | 演示访问一个不存在的请求路径
5 | ```kotlin
6 | scopeNetLife {
7 | tv.text = Get("https://error.com/net/").await()
8 | }
9 | ```
10 |
11 | LogCat可以看到异常堆栈信息, 包含具体Url和代码位置
12 |
13 | 
14 |
15 |
16 | ### 关闭日志
17 |
18 | 可以关闭日志打印
19 |
20 | ```kotlin
21 | NetConfig.initialize(Api.HOST, this) {
22 | setDebug(false) // 关闭日志, 一般使用 BuildConfig.DEBUG
23 | }
24 | ```
25 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_scope.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_async_task.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/layout_loading.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
7 |
8 |
13 |
14 |
--------------------------------------------------------------------------------
/docs/callback.md:
--------------------------------------------------------------------------------
1 | Net支持OkHttp的原有的队列请求`Callback`
2 |
3 | !!! Failure "不推荐"
4 | Callback属于接口回调, 其代码冗余, 且无法支持并发请求
5 |
6 |
7 | ```kotlin
8 | Net.post(Api.PATH).enqueue(object : Callback {
9 | override fun onFailure(call: Call, e: IOException) {
10 | }
11 |
12 | override fun onResponse(call: Call, response: Response) {
13 | // 此处为子线程
14 | val body = response.body?.string() ?: "无数据"
15 | runMain {
16 | // 此处为主线程
17 | tv.text = body
18 | }
19 | }
20 | })
21 | ```
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/constants/UserConfig.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.constants
2 |
3 | import com.drake.serialize.serialize.annotation.SerializeConfig
4 | import com.drake.serialize.serialize.serialLazy
5 |
6 |
7 | /**
8 | * 本单例类使用 https://github.com/liangjingkanji/Serialize 为字段提供持久化存储
9 | */
10 | @SerializeConfig(mmapID = "user_config")
11 | object UserConfig {
12 |
13 | var token by serialLazy(default = "6cad0ff06f5a214b9cfdf2a4a7c432339")
14 |
15 | var isLogin by serialLazy(default = false)
16 | }
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_download_file.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_upload_file.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_switch_dispatcher.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/docs/error.md:
--------------------------------------------------------------------------------
1 | Net有完善的错误处理机制, 具备捕获异常/取消请求/错误提示/追踪链路
2 |
3 | !!! success "收集网络日志"
4 | 在Net作用域内发生的异常都会被全局错误处理捕获, 可以将其筛选上传日志
5 |
6 |
7 | 以下位置抛出异常会被捕获
8 |
9 | | 函数 | 描述 |
10 | |-|-|
11 | | 作用域 | `scopeXX`代码块中 |
12 | | 拦截器 | `Interceptor/RequestInterceptor` |
13 | | 转换器 | `NetConverter` |
14 |
15 | 如果捕获到错误默认会执行以下操作
16 |
17 | 1. `Logcat`输出异常堆栈信息, [自定义异常抛出](error-throws.md)
18 | 2. `Toast`显示错误文本, [自定义错误提示](error-tip.md)
19 |
20 |
21 | !!! failure "捕获不到异常"
22 | 如果请求未执行`await()`, 那么即使发生错误也不会被捕获到
23 |
24 |
25 | 自定义请阅读[全局错误处理](error-global.md)
--------------------------------------------------------------------------------
/docs/coroutine-request.md:
--------------------------------------------------------------------------------
1 | Net的协程作用域会自动处理协程生命周期
2 |
3 | 在上章节已经介绍如何发起并发网络请求, 这里演示同时(并发)请求`一万次`, 然后取消全部
4 |
5 | ```kotlin
6 | val job = scopeNetLife {
7 | repeat(10000) {
8 | // 这里将返回的数据显示在TextView上
9 | launch {
10 | tv.text = Get(Api.PATH).await()
11 | }
12 | }
13 | }
14 | ```
15 |
16 |
17 | 等待五秒后取消请求
18 | ```kotlin
19 | thread {
20 | Thread.sleep(5000) // 等待五秒
21 | job.cancel()
22 | }
23 | ```
24 |
25 |
26 |
27 | Net主要使用协程请求, 但也支持其他方式发起请求
28 |
29 | - [同步请求](sync-request.md)
30 | - [回调请求](callback.md)
31 | - 协程请求
32 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/constants/Api.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.constants
2 |
3 |
4 | /*
5 | 建议请求路径都写在一个单例类中, 方便查找和替换
6 | */
7 | object Api {
8 | const val HOST = "http://127.0.0.1:8091"
9 |
10 | const val TEXT = "/text"
11 | const val DELAY = "/delay"
12 | const val UPLOAD = "/upload"
13 | const val GAME = "/game"
14 | const val DATA = "/data"
15 | const val ARRAY = "/array"
16 | const val CONFIG = "/config"
17 | const val USER_INFO = "/userInfo"
18 | const val TIME = "/time"
19 | const val Token = "/token"
20 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/interceptor/GlobalHeaderInterceptor.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.interceptor
2 |
3 | import com.drake.net.interceptor.RequestInterceptor
4 | import com.drake.net.request.BaseRequest
5 | import com.drake.net.sample.constants.UserConfig
6 |
7 |
8 | /** 演示添加全局请求头/参数 */
9 | class GlobalHeaderInterceptor : RequestInterceptor {
10 |
11 | /** 本方法每次请求发起都会调用, 这里添加的参数可以是动态参数 */
12 | override fun interceptor(request: BaseRequest) {
13 | request.setHeader("client", "Android")
14 | request.setHeader("token", UserConfig.token)
15 | }
16 | }
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_read_cache.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_interval.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/menu/menu_converter.xml:
--------------------------------------------------------------------------------
1 |
2 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_simple_request.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/converter/FastJsonConverter.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.converter
2 |
3 | import com.alibaba.fastjson.JSON
4 | import com.drake.net.convert.JSONConvert
5 | import org.json.JSONObject
6 | import java.lang.reflect.Type
7 |
8 | class FastJsonConverter : JSONConvert(code = "errorCode", message = "errorMsg", success = "0") {
9 |
10 | override fun String.parseBody(succeed: Type): R? {
11 | val string = try {
12 | JSONObject(this).getString("data")
13 | } catch (e: Exception) {
14 | this
15 | }
16 | return JSON.parseObject(string, succeed)
17 | }
18 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/model/GameModel.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.model
2 |
3 | @kotlinx.serialization.Serializable
4 | data class GameModel(
5 | var total: Int = 0,
6 | var list: List = listOf()
7 | ) {
8 |
9 | @kotlinx.serialization.Serializable
10 | data class Data(
11 | var id: Int = 0,
12 | var img: String = "",
13 | var name: String = "",
14 | var label: List = listOf(),
15 | var price: String = "",
16 | var initialPrice: String = "",
17 | var grade: Int = 0,
18 | var discount: Double = 0.0,
19 | var endTime: Int = 0
20 | )
21 | }
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_state_layout.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/values/styles.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
10 |
11 |
15 |
16 |
17 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_view_model.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/sample/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | #2FA8E6
5 | #2FA8E6
6 | #F44336
7 |
8 |
9 | #339e9e9e
10 | #fafafa
11 | #737373
12 |
13 |
14 | #333333
15 | #999999
16 |
17 |
18 | #FFFFFF
19 | #F44336
20 | #000000
21 |
22 |
23 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_pull_refresh.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
12 |
13 |
17 |
18 |
19 |
--------------------------------------------------------------------------------
/docs/issues.md:
--------------------------------------------------------------------------------
1 | Net最大的特点在于完美支持OkHttp的所有功能组件, 而OkHttp是Android主流网络解决方案
2 |
3 | 所以如果存在Net没有实现的功能可以谷歌搜索`"OkHttp如何实现XX"`, 然后可以很容易在Net中使用
4 |
5 | ## 低版本兼容
6 |
7 | 如果开发要求低至 Android 4.4 (API level 19)
8 | 请使用兼容版本: [Net-okhttp3](https://github.com/liangjingkanji/Net-okhttp3)
9 |
10 | 如果需更低版本支持请拉取仓库修改`minSdkVersion`后编译成aar使用
11 |
12 | ## 开发者交流
13 |
14 | - [反馈问题](https://github.com/liangjingkanji/Net/issues)
15 | - [其他开发者提及问题](https://github.com/liangjingkanji/Net/issues)
16 | - [交流社区](https://github.com/liangjingkanji/Net/discussions)
17 | - 
18 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/converter/GsonConverter.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.converter
2 |
3 | import com.drake.net.convert.JSONConvert
4 | import com.google.gson.GsonBuilder
5 | import org.json.JSONObject
6 | import java.lang.reflect.Type
7 |
8 | class GsonConverter : JSONConvert(code = "errorCode", message = "errorMsg") {
9 | companion object {
10 | private val gson = GsonBuilder().serializeNulls().create()
11 | }
12 |
13 | override fun String.parseBody(succeed: Type): R? {
14 | val string = try {
15 | JSONObject(this).getString("data")
16 | } catch (e: Exception) {
17 | this
18 | }
19 | return gson.fromJson(string, succeed)
20 | }
21 | }
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_fastest.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_sync_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
10 |
11 |
18 |
19 |
20 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_async_task.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_push_refresh.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_callback_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
10 |
11 |
18 |
19 |
20 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_interceptor.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_coroutine_scope.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_exception_trace.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_error_handler.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_parallel_network.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_simple_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_switch_dispatcher.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/sample/src/main/res/menu/menu_interval.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
--------------------------------------------------------------------------------
/docs/api/images/anchor-copy-button.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/docs/cookie.md:
--------------------------------------------------------------------------------
1 | 可以实现OkHttp的`CookieJar`, 且提供持久化的[PersistentCookieJar](https://github.com/liangjingkanji/Net/blob/2abf07e1d003ef44574278fd2010f3375225d964/net/src/main/java/com/drake/net/cookie/PersistentCookieJar.kt)
2 |
3 | ```kotlin
4 | NetConfig.initialize(Api.HOST, this) {
5 | // 添加持久化Cookie
6 | cookieJar(PersistentCookieJar(this@App))
7 | }
8 | ```
9 |
10 | 可以手动增删Cookie
11 |
12 | | PersistentCookieJar | 描述 |
13 | |-|-|
14 | | addAll | 添加Cookie |
15 | | getAll | 获取某个域名的所有Cookie |
16 | | remove | 删除某个域名下所有或者指定名称的Cookie |
17 | | clear | 删除客户端全部Cookie |
18 |
19 |
20 | 可通过客户端获取到已配置cookieJar
21 | ```kotlin
22 | (NetConfig.okHttpClient.cookieJar as? PersistentCookieJar)?.clear()
23 | ```
24 |
25 | !!! note "隔绝Cookies共享"
26 | 为`PersistentCookieJar`指定不同`dbName`阻止不同的客户端共享Cookies
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_super_interval.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
20 |
21 |
22 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_exception_trace.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_auto_dialog.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
20 |
21 |
22 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_read_cache.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
20 |
21 |
22 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_error_handler.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/StateLayoutFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Get
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.constants.Api
7 | import com.drake.net.sample.databinding.FragmentStateLayoutBinding
8 | import com.drake.net.utils.scope
9 |
10 |
11 | class StateLayoutFragment :
12 | EngineFragment(R.layout.fragment_state_layout) {
13 |
14 | override fun initData() {
15 | }
16 |
17 | override fun initView() {
18 | binding.state.onRefresh {
19 | scope {
20 | binding.tvFragment.text = Get(Api.TEXT).await()
21 | }
22 | }.showLoading()
23 | }
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/sample/src/androidTest/java/com/drake/net/ExampleInstrumentedTest.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net
2 |
3 | import androidx.test.ext.junit.runners.AndroidJUnit4
4 | import androidx.test.platform.app.InstrumentationRegistry
5 | import org.junit.Assert.assertEquals
6 | import org.junit.Test
7 | import org.junit.runner.RunWith
8 |
9 | /**
10 | * Instrumented test, which will execute on an Android device.
11 | *
12 | * See [testing documentation](http://d.android.com/tools/testing).
13 | */
14 | @RunWith(AndroidJUnit4::class)
15 | class ExampleInstrumentedTest {
16 | @Test
17 | fun useAppContext() {
18 | // Context of the app under test.
19 | val appContext = InstrumentationRegistry.getInstrumentation().targetContext
20 | assertEquals("com.drake.net", appContext.packageName)
21 | }
22 | }
23 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_state_layout.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
12 |
13 |
20 |
21 |
22 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_push_refresh.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
14 |
15 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/utils/LegacyTLS.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.utils
2 |
3 | import android.os.Build
4 | import okhttp3.CipherSuite
5 | import okhttp3.ConnectionSpec
6 | import okhttp3.OkHttpClient
7 |
8 | /**
9 | * API<21 支持 TLSv1.1 和 TLSv1.2
10 | */
11 | fun OkHttpClient.Builder.useLegacyTLS() {
12 | if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
13 | val legacyTls: ConnectionSpec = ConnectionSpec.Builder(ConnectionSpec.MODERN_TLS)
14 | .cipherSuites(
15 | *ConnectionSpec.MODERN_TLS.cipherSuites()?.toTypedArray() ?: emptyArray(),
16 | CipherSuite.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
17 | CipherSuite.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
18 | ).build()
19 |
20 | connectionSpecs(listOf(legacyTls, ConnectionSpec.CLEARTEXT))
21 | }
22 | }
--------------------------------------------------------------------------------
/sample/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # You can control the set of applied configuration files using the
3 | # proguardFiles setting in build.gradle.
4 | #
5 | # For more details, see
6 | # http://developer.android.com/guide/developing/tools/proguard.html
7 |
8 | # If your project uses WebView with JS, uncomment the following
9 | # and specify the fully qualified class name to the JavaScript interface
10 | # class:
11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
12 | # public *;
13 | #}
14 |
15 | # Uncomment this to preserve the line number information for
16 | # debugging stack traces.
17 | #-keepattributes SourceFile,LineNumberTable
18 |
19 | # If you keep the line number information, uncomment this to
20 | # hide the original source file name.
21 | #-renamesourcefileattribute SourceFile
--------------------------------------------------------------------------------
/docs/sync-request.md:
--------------------------------------------------------------------------------
1 | Net支持在当前线程执行阻塞线程的同步请求
2 |
3 | !!! question "什么是同步请求"
4 | 即上个请求结束才会发起下个请求, 实际上协程也可以实现但是他不会阻塞线程
5 |
6 | 同步请求应用场景一般是在拦截器(执行在子线程)中使用
7 |
8 | 因为Android主线程不允许发起网络请求, 这里创建一个子线程来演示
9 |
10 | === "返回数据"
11 |
12 | ```kotlin
13 | thread {
14 | val result = Net.post(Api.PATH).execute() // 网络请求不允许在主线程
15 | tv?.post {
16 | tv?.text = result // view要求在主线程更新
17 | }
18 | }
19 | ```
20 |
21 | === "返回Result"
22 |
23 | ```kotlin
24 | thread {
25 | val result = Net.post(Api.PATH).toResult().getOrDefault("请求发生错误, 我是默认值")
26 | tv?.post {
27 | tv?.text = result // view要求在主线程更新
28 | }
29 | }
30 | ```
31 |
32 | 1. `execute`在请求错误时会直接抛出异常
33 | 2. `toResult`不会抛出异常, 可`getOrThrow/exceptionOrNull`等返回异常对象
34 |
35 |
36 |
37 |
38 |
39 |
--------------------------------------------------------------------------------
/docs/error-global.md:
--------------------------------------------------------------------------------
1 | 可实现`NetErrorHandler`接口来监听全局错误处理
2 |
3 | === "创建"
4 | ```kotlin
5 | class NetworkingErrorHandler : NetErrorHandler {
6 | override fun onError(e: Throwable) {
7 | // .... 其他错误
8 | if (e is ResponseException && e.tag == 401) { // 判断异常为token失效
9 | // 打开登录界面或者弹登录失效对话框
10 | }
11 | }
12 | }
13 | ```
14 | === "配置"
15 | ```kotlin
16 | NetConfig.initialize(Api.HOST, this) {
17 | setErrorHandler(NetworkingErrorHandler))
18 | }
19 | ```
20 |
21 | |NetErrorHandler|使用场景|触发位置|
22 | |-|-|-|
23 | |`onError`| 吐司错误信息 | `scopeNetLife/scopeDialog` |
24 | |`onStateError` | 要求错误显示在缺省页 |`PageRefreshLayout.scope/StateLayout.scope`|
25 |
26 |
27 | !!! warning "以下情况全局错误处理无效"
28 |
29 | 1. 异步任务作用域(`scope/scopeLife`)发生的错误
30 | 2. 使用[单例错误处理](error-single.md)处理的错误
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/converter/MoshiConverter.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.converter
2 |
3 | import com.drake.net.convert.JSONConvert
4 | import com.squareup.moshi.Moshi
5 | import com.squareup.moshi.kotlin.reflect.KotlinJsonAdapterFactory
6 | import org.json.JSONObject
7 | import java.lang.reflect.Type
8 |
9 | class MoshiConverter : JSONConvert(code = "errorCode", message = "errorMsg", success = "0") {
10 |
11 | companion object {
12 | private val moshi = Moshi.Builder().add(KotlinJsonAdapterFactory()).build()
13 | }
14 |
15 | override fun String.parseBody(succeed: Type): R? {
16 | val string = try {
17 | JSONObject(this).getString("data")
18 | } catch (e: Exception) {
19 | this
20 | }
21 | return moshi.adapter(succeed).fromJson(string)
22 | }
23 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/ExceptionTraceFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Get
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.databinding.FragmentExceptionTraceBinding
7 | import com.drake.net.utils.scopeNetLife
8 |
9 |
10 | class ExceptionTraceFragment :
11 | EngineFragment(R.layout.fragment_exception_trace) {
12 |
13 | override fun initView() {
14 | scopeNetLife {
15 | // 这是一个错误的地址, 请查看LogCat的错误信息, 在[initNet]函数中的[onError]回调中你也可以进行自定义错误信息打印
16 | binding.tvFragment.text =
17 | Get("https://githuberror.com/liangjingkanji/Net/").await()
18 | }
19 | }
20 |
21 | override fun initData() {
22 | }
23 |
24 | }
25 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/InterceptorFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Get
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.constants.Api
7 | import com.drake.net.sample.databinding.FragmentInterceptorBinding
8 | import com.drake.net.utils.scopeNetLife
9 |
10 |
11 | class InterceptorFragment :
12 | EngineFragment(R.layout.fragment_interceptor) {
13 |
14 | override fun initView() {
15 | scopeNetLife {
16 | binding.tvFragment.text = Get(Api.TEXT) {
17 | // 拦截器只支持全局, 无法单例, 请查看[com.drake.net.sample.interceptor.NetInterceptor]
18 | }.await()
19 | }
20 | }
21 |
22 | override fun initData() {
23 | }
24 |
25 | }
26 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_limited_time.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
8 |
11 |
12 |
13 |
14 |
18 |
19 |
25 |
26 |
27 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_debounce.xml:
--------------------------------------------------------------------------------
1 |
8 |
11 |
12 |
--------------------------------------------------------------------------------
/docs/upload-file.md:
--------------------------------------------------------------------------------
1 | ```kotlin
2 | scopeNetLife {
3 | Post(Api.UPLOAD) {
4 | param("fileName", assetsFile())
5 | }.await()
6 | }
7 | ```
8 |
9 | 使用`addUploadListener`添加上传进度监听器, 阅读[进度监听](progress.md)章节
10 |
11 | ## 指定类型
12 |
13 | 默认根据文件后缀名生成`MediaType`, 如果想自定义MediaType可以直接创建`RequestBody`
14 |
15 | ```kotlin
16 | scopeNetLife {
17 | Post(Api.UPLOAD) {
18 | param("file", assetsFile().toRequestBody("image/webp".toMediaType()))
19 | }.await()
20 | }
21 | ```
22 |
23 | ## 上传类型
24 |
25 | 自定义RequestBody可以实现任何数据类型的上传
26 |
27 | ```kotlin
28 | scopeNetLife {
29 | Post(Api.UPLOAD) {
30 | // 表单上传
31 | param("file", Uri)
32 | param("file", File)
33 | }.await()
34 | }
35 | ```
36 |
37 | 直接上传`InputStream`可能内存泄露, 建议你保存到文件后上传
38 |
39 | 1. [使用文件流上传文件](https://github.com/liangjingkanji/Net/discussions/190)
40 |
41 |
42 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/ErrorHandlerFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Get
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.databinding.FragmentErrorHandlerBinding
7 | import com.drake.net.utils.scopeNetLife
8 |
9 |
10 | class ErrorHandlerFragment :
11 | EngineFragment(R.layout.fragment_error_handler) {
12 |
13 | override fun initView() {
14 | scopeNetLife {
15 | // 该请求是错误的路径会在控制台打印出错误信息
16 | Get("error").await()
17 | }.catch {
18 | // 重写该函数后, 错误不会流到[NetConfig.onError]中的全局错误处理, 在App.kt中可以自定义该全局处理, 同时包含onStateError
19 | binding.tvFragment.text = it.message
20 | }
21 | }
22 |
23 | override fun initData() {
24 | }
25 |
26 | }
27 |
--------------------------------------------------------------------------------
/docs/auto-pull.md:
--------------------------------------------------------------------------------
1 | 首先请阅读上章节 [自动下拉刷新](auto-refresh.md), 已提及内容不再重复
2 |
3 |
4 | ## 自动分页
5 |
6 | 提供`addData()`来简化分页, 开发者可以借鉴实现
7 |
8 | ```kotlin
9 | page.onRefresh {
10 | scope {
11 | val data = Get(Api.PATH) {
12 | param("page", index)
13 | }.await().data
14 | addData(data.list) {
15 | index < data.total
16 | }
17 | }
18 | }.autoRefresh()
19 | ```
20 |
21 | ## 索引自增
22 | `index` 每次上拉加载自动++1, 刷新列表重置为`PageRefreshLayout.startIndex`
23 |
24 | ## 有更多页
25 |
26 | 根据`hasMore`返回结果是否关闭上拉加载, `isEmpty`决定是否显示`空数据`缺省页
27 |
28 | ```kotlin
29 | fun addData(
30 | data: List?,
31 | adapter: BindingAdapter? = null,
32 | isEmpty: () -> Boolean = { data.isNullOrEmpty() },
33 | hasMore: BindingAdapter.() -> Boolean = { true }
34 | )
35 | ```
36 |
37 |
38 | 1. [PageRefreshLayout 下拉刷新/上拉加载](https://liangjingkanji.github.io/BRV/refresh.html)
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_config_dialog.xml:
--------------------------------------------------------------------------------
1 |
6 |
9 |
10 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/contract/AlbumSelectContract.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.contract
2 |
3 | import android.content.Context
4 | import android.content.Intent
5 | import android.net.Uri
6 | import android.provider.MediaStore
7 | import androidx.activity.result.contract.ActivityResultContract
8 |
9 | class AlbumSelectContract : ActivityResultContract() {
10 |
11 | override fun createIntent(context: Context, input: Unit?): Intent {
12 | val intent = Intent(Intent.ACTION_PICK)
13 | intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*")
14 | return intent
15 | }
16 |
17 | class AlbumSelectResult(val code: Int, val uri: Uri?)
18 |
19 | override fun parseResult(resultCode: Int, intent: Intent?): AlbumSelectResult {
20 | return AlbumSelectResult(resultCode, intent?.data)
21 | }
22 | }
--------------------------------------------------------------------------------
/sample/src/main/res/menu/menu_request_method.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
--------------------------------------------------------------------------------
/docs/cancel.md:
--------------------------------------------------------------------------------
1 | 部分场景开发者想手动取消请求
2 |
3 | ```kotlin
4 | downloadScope = scopeNetLife {
5 | // 下载文件
6 | val file = Get(Api.DOWNLOAD).await()
7 | }
8 |
9 | downloadScope.cancel() // 取消下载
10 | ```
11 |
12 | ## 任意位置取消
13 | 发起请求时指定`Id`
14 |
15 | ```kotlin
16 | scopeNetLife {
17 | tv.text = Get(Api.DOWNLOAD){
18 | setId("请求用户信息")
19 | }.await()
20 | }
21 | ```
22 |
23 | === "根据ID取消"
24 | ``` kotlin
25 | Net.cancelId("请求用户信息")
26 | ```
27 | === "根据Group取消"
28 | ``` kotlin
29 | Net.cancelGroup("请求分组名称")
30 | ```
31 |
32 | ## Group和Id区别
33 |
34 | | 函数 | 描述 |
35 | |-|-|
36 | | id | 请求唯一Id, 实际上重复也行, 但是取消请求时遍历到指定Id就会结束遍历 |
37 | | group | 允许多个请求使用相同group, 在取消请求时会遍历所有分组的请求
|
38 |
39 | !!! warning "作用域结束请求自动取消"
40 | 在`scopeXX()`作用域中发起请求时会默认使用当前协程错误处理器作为Group
41 | ```kotlin
42 | setGroup(coroutineContext[CoroutineExceptionHandler])
43 | ```
44 | 在作用域结束时 会`cancelGroup`, 所以如果你手动指定分组会导致无法自动取消
--------------------------------------------------------------------------------
/docs/okhttp-client.md:
--------------------------------------------------------------------------------
1 | Net全局持有一个`OkHttpClient`对象发起请求
2 |
3 | ```kotlin
4 | object NetConfig {
5 | var okHttpClient: OkHttpClient
6 | }
7 | ```
8 |
9 | ## 全局
10 |
11 | ```kotlin
12 | NetConfig.initialize(Api.HOST, this) {
13 | // 此处this即为OkHttpClient.Builder
14 | }
15 | ```
16 |
17 |
18 | ## 单例
19 |
20 | 单独指定当前请求客户端
21 |
22 | === "修改全局客户端"
23 | ```kotlin
24 | scopeNetLife {
25 | tv_response.text = Get(Api.PATH) {
26 | setClient {
27 | // 此处this即为OkHttpClient.Builder
28 | trustCertificate()
29 | }
30 | }.await()
31 | }
32 | ```
33 | 在全局`OkHttpClient`基础上修改
34 |
35 | === "创建新客户端"
36 | ```kotlin
37 | scopeNetLife {
38 | tv_response.text = Get(Api.PATH) {
39 | okHttpClient = OkHttpClient.Builder().build()
40 | }.await()
41 | }
42 | ```
43 | 创建新的OkHttpClient, 一般不使用, 因为新OkHttpClient会重新创建线程池/连接池等造成内存消耗
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/utils/HttpUtils.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.utils
2 |
3 | import com.drake.net.Get
4 | import com.drake.net.sample.constants.Api
5 | import com.drake.net.sample.model.ConfigModel
6 | import com.drake.net.sample.model.UserInfoModel
7 | import kotlinx.coroutines.CoroutineScope
8 | import kotlinx.coroutines.coroutineScope
9 |
10 |
11 | /**
12 | * 常用的请求方法建议写到一个工具类中
13 | */
14 | object HttpUtils {
15 |
16 | /**
17 | * 获取配置信息
18 | *
19 | * 本方法需要再调用await()才会返回结果, 属于异步方法
20 | */
21 | fun getConfigAsync(scope: CoroutineScope) = scope.Get(Api.CONFIG)
22 |
23 | /**
24 | * 获取用户信息
25 | * 阻塞返回可直接返回结果
26 | *
27 | * @param userId 如果为空表示请求自身用户信息
28 | */
29 | suspend fun getUser(userId: String? = null) = coroutineScope {
30 | Get(Api.USER_INFO) {
31 | param("userId", userId)
32 | }.await()
33 | }
34 |
35 | }
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | ## For more details on how to configure your build environment visit
2 | # http://www.gradle.org/docs/current/userguide/build_environment.html
3 | #
4 | # Specifies the JVM arguments used for the daemon process.
5 | # The setting is particularly useful for tweaking memory settings.
6 | # Default value: -Xmx1024m -XX:MaxPermSize=256m
7 | # org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
8 | #
9 | # When configured, Gradle will run in incubating parallel mode.
10 | # This option should only be used with decoupled projects. More details, visit
11 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
12 | # org.gradle.parallel=true
13 | #Fri Mar 18 17:49:14 CST 2022
14 | kotlin.code.style=official
15 | kotlin.incremental=false
16 | org.gradle.jvmargs=-Xmx2048M -Dkotlin.daemon.jvm.options\="-Xmx2048M"
17 | android.useAndroidX=true
18 | android.enableJetifier=true
19 |
--------------------------------------------------------------------------------
/sample/src/main/res/drawable/ic_https.xml:
--------------------------------------------------------------------------------
1 |
7 |
10 |
11 |
--------------------------------------------------------------------------------
/docs/log-notice.md:
--------------------------------------------------------------------------------
1 | 使用三方库 [Chucker](https://github.com/ChuckerTeam/chucker) 在通知栏记录网络请求日志
2 |
3 |
4 | { width="300" }
5 | Chucker
6 |
7 |
8 | 依赖
9 |
10 | ```groovy
11 | implementation "com.github.chuckerteam.chucker:library:3.5.2"
12 | ```
13 |
14 | 添加拦截器
15 |
16 | ```kotlin
17 | NetConfig.initialize(Api.HOST, this) {
18 | // ...
19 | if (BuildConfig.DEBUG) {
20 | addInterceptor(
21 | ChuckerInterceptor.Builder(this@App)
22 | .collector(ChuckerCollector(this@App))
23 | .maxContentLength(250000L)
24 | .redactHeaders(emptySet())
25 | .alwaysReadResponseBody(false)
26 | .build()
27 | )
28 | }
29 | }
30 | ```
31 |
32 | 自定义功能浏览 [Chucker](https://github.com/ChuckerTeam/chucker) 官网
33 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/SwitchDispatcherFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.databinding.FragmentSwitchDispatcherBinding
6 | import com.drake.net.utils.scopeLife
7 | import com.drake.net.utils.withIO
8 | import com.drake.net.utils.withMain
9 | import kotlinx.coroutines.launch
10 |
11 |
12 | class SwitchDispatcherFragment :
13 | EngineFragment(R.layout.fragment_switch_dispatcher) {
14 |
15 | override fun initView() {
16 | scopeLife {
17 |
18 | // 点击函数名查看更多相关函数
19 | launch {
20 | val data = withMain {
21 | "异步调度器切换到主线程"
22 | }
23 | }
24 |
25 | val data = withIO {
26 | "主线程切换到IO调度器"
27 | }
28 | }
29 | }
30 |
31 | override fun initData() {
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/AsyncTaskFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.databinding.FragmentAsyncTaskBinding
6 | import com.drake.net.utils.scope
7 | import kotlinx.coroutines.*
8 |
9 | class AsyncTaskFragment : EngineFragment(R.layout.fragment_async_task) {
10 |
11 | override fun initView() {
12 | scope {
13 | binding.tvFragment.text = withContext(Dispatchers.IO) {
14 | delay(2000)
15 | "结果"
16 | }
17 | }
18 | }
19 |
20 | override fun initData() {
21 | }
22 |
23 | /**
24 | * 抽出异步任务为一个函数
25 | */
26 | private suspend fun withDownloadFile() = withContext(Dispatchers.IO) {
27 | delay(200)
28 | "结果"
29 | }
30 |
31 | private fun CoroutineScope.asyncDownloadFile() = async {
32 | "结果"
33 | }
34 | }
35 |
--------------------------------------------------------------------------------
/docs/debounce.md:
--------------------------------------------------------------------------------
1 | !!! question "节流"
2 | 在一定时间间隔内，只执行最后一次请求, 忽略其他多余的请求
3 |
4 | 搜索输入框一般都是输入完关键词后自动开始搜索
5 |
6 | 这个过程涉及到
7 |
8 | 1. 每次变化都搜索会导致服务器压力, 应在停止输入满足一定时间后自动搜索
9 | 2. 当产生新的搜索请求后应取消旧请求, 以防止旧数据覆盖新数据
10 | 3. 当输入内容没有变化(例复制粘贴重复内容到搜索框)不会发起搜索请求
11 |
12 |
13 |
14 | 
15 |
16 |
17 |
18 | ```kotlin
19 | var scope: CoroutineScope? = null
20 |
21 | // distinctUntilChanged 表示过滤掉重复结果
22 | binding.etInput.debounce().distinctUntilChanged().launchIn(this) {
23 | scope?.cancel() // 发起新的请求前取消旧的请求, 避免旧数据覆盖新数据
24 | scope = scopeNetLife { // 保存旧的请求到一个变量中
25 | tv.text = "请求中"
26 | tv.text = Get(Api.TIME).await()
27 | }
28 | }
29 | ```
30 |
31 | 指定参数设置节流阀超时时间
32 | ```kotlin
33 | fun EditText.debounce(timeoutMillis: Long = 800)
34 | ```
35 |
36 | 1. [示例-自动搜索分页列表](https://github.com/liangjingkanji/Net/blob/a78d46118666a3509d3fcc79c1d28ad81e2d5a57/sample/src/main/java/com/drake/net/sample/ui/fragment/EditDebounceFragment.kt)
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/ParallelNetworkFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Get
5 | import com.drake.net.Post
6 | import com.drake.net.Trace
7 | import com.drake.net.sample.R
8 | import com.drake.net.sample.constants.Api
9 | import com.drake.net.sample.databinding.FragmentParallelNetworkBinding
10 | import com.drake.net.utils.scopeNetLife
11 |
12 |
13 | class ParallelNetworkFragment :
14 | EngineFragment(R.layout.fragment_parallel_network) {
15 |
16 | override fun initView() {
17 | scopeNetLife {
18 |
19 | // 同时发起三个请求
20 | val deferred = Get(Api.TEXT)
21 | val deferred1 = Post(Api.TEXT)
22 | val deferred2 = Trace(Api.TEXT)
23 |
24 | // 同时接收三个请求数据
25 | deferred.await()
26 | deferred1.await()
27 | deferred2.await()
28 | }
29 | }
30 |
31 | override fun initData() {
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/ReadCacheFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Post
5 | import com.drake.net.cache.CacheMode
6 | import com.drake.net.sample.R
7 | import com.drake.net.sample.constants.Api
8 | import com.drake.net.sample.databinding.FragmentReadCacheBinding
9 | import com.drake.net.utils.scopeNetLife
10 |
11 |
12 | /**
13 | * 默认支持Http标准缓存协议
14 | * 如果需要自定义缓存模式来强制读写缓存，可以使用[CacheMode], 这会覆盖默认的Http标准缓存协议.
15 | * 可以缓存任何数据, 包括文件. 并且遵守LRU缓存策略限制最大缓存空间
16 | */
17 | class ReadCacheFragment : EngineFragment(R.layout.fragment_read_cache) {
18 |
19 | override fun initView() {
20 | scopeNetLife {
21 | binding.tvFragment.text =
22 | Post(Api.TEXT) {
23 | setCacheMode(CacheMode.REQUEST_THEN_READ) // 请求网络失败会读取缓存, 请断网测试
24 | // setCacheKey("自定义缓存KEY")
25 | }.await()
26 | }
27 | }
28 |
29 | override fun initData() {
30 | }
31 |
32 | }
33 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/converter/FastJsonConvertFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment.converter
2 |
3 | import com.drake.net.Get
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.constants.Api
6 | import com.drake.net.sample.converter.FastJsonConverter
7 | import com.drake.net.sample.databinding.FragmentCustomConvertBinding
8 | import com.drake.net.sample.model.GameModel
9 | import com.drake.net.utils.scopeNetLife
10 |
11 |
12 | class FastJsonConvertFragment :
13 | BaseConvertFragment(R.layout.fragment_custom_convert) {
14 |
15 | override fun initView() {
16 | binding.tvConvertTip.text = """
17 | 1. 阿里巴巴出品的Json解析库
18 | 2. 引入kotlin-reflect库可以支持kotlin默认值
19 | """.trimIndent()
20 |
21 | scopeNetLife {
22 | binding.tvFragment.text = Get(Api.GAME) {
23 | converter = FastJsonConverter() // 单例转换器, 此时会忽略全局转换器
24 | }.await().list[0].name
25 | }
26 | }
27 |
28 | override fun initData() {
29 | }
30 |
31 | }
32 |
--------------------------------------------------------------------------------
/docs/error-single.md:
--------------------------------------------------------------------------------
1 | 捕获当前请求/作用域错误, 将不会再被全局错误处理
2 |
3 | ## 捕获请求
4 |
5 | 一个请求发生错误会取消当前作用域内所有请求, 但单独捕获后不会再影响其他请求
6 |
7 | 例如
8 | ```kotlin
9 | scopeNetLife {
10 | Get("path").await() // 失败
11 | Get("path2").await() // 上面失败, 此处也不会执行
12 | }
13 | ```
14 |
15 | 捕获第一个协程避免终止后续执行
16 | ```kotlin
17 | scopeNetLife {
18 | try {
19 | Get("path").await() // 失败
20 | } catch(e:Exception) {
21 | }
22 | Get("path2").await() // 上面失败, 此处继续执行
23 | }
24 | ```
25 | 当然如果创建不同的作用域分别请求那是互不影响的
26 | ```kotlin
27 | scopeNetLife {
28 | Get("path").await() // 失败
29 | }
30 | scopeNetLife {
31 | Get("path2").await() // 上面失败, 此处完全不受影响
32 | }
33 | ```
34 |
35 |
36 |
37 | ## 捕获作用域
38 |
39 | ```kotlin
40 | scope {
41 | val data = Get("http://www.error.com/").await()
42 | }.catch {
43 | // 协程内发生错误回调, it为异常对象
44 | }.finally {
45 | // 协程执行完毕回调(不论成败), it为异常对象
46 | }
47 | ```
48 |
49 | | 函数 | 区别 |
50 | |-|-|
51 | | catch | 发生错误后回调, 取消不回调
不会再执行全局错误处理, 可使用`handleError`再次传递给全局 |
52 | | finally | 执行完毕回调(不论成败), 取消作用域时`it`为`CancellationException`
执行全局错误处理 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2023 劉強東
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/SyncRequestFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Net
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.constants.Api
7 | import com.drake.net.sample.databinding.FragmentSyncRequestBinding
8 | import kotlin.concurrent.thread
9 |
10 | class SyncRequestFragment :
11 | EngineFragment(R.layout.fragment_sync_request) {
12 |
13 | override fun initView() {
14 | thread { // 网络请求不允许在主线程
15 | val result = try {
16 | Net.post(Api.TEXT).execute()
17 | } catch (e: Exception) { // 同步请求失败会导致崩溃要求捕获异常
18 | "请求错误 = ${e.message}"
19 | }
20 |
21 | // val result = Net.post(Api.BANNER).toResult().getOrDefault("请求发生错误, 我这是默认值")
22 |
23 | binding.tvFragment?.post { // 这里用?号是避免界面被销毁依然赋值
24 | binding.tvFragment?.text = result // view要求在主线程更新
25 | }
26 | }
27 | }
28 |
29 | override fun initData() {
30 | }
31 | }
--------------------------------------------------------------------------------
/docs/interval.md:
--------------------------------------------------------------------------------
1 | Net自带轮询器(计时器), 包含以下特性
2 |
3 | - 正计时
4 | - 倒计时
5 | - 指定次数
6 | - 支持开始/停止/暂停/继续/重置/切换开关
7 | - 仅页面显示时计时
8 | - 页面销毁自动取消
9 |
10 |
11 | === "限制次数/间隔"
12 | ```kotlin
13 | interval = Interval(100, 1, TimeUnit.SECONDS).life(this) // 自定义计数器个数的轮询器
14 | ```
15 | === "无限执行"
16 | ```kotlin
17 | interval = Interval(1, TimeUnit.SECONDS) // 每秒回调一次, 不会自动结束
18 | ```
19 | === "倒计时"
20 | ```kotlin
21 | // 倒计时轮询器, 当[start]]比[end]值大, 且end不等于-1时, 即为倒计时
22 | interval = Interval(1, 1, TimeUnit.SECONDS, 5).life(this)
23 | ```
24 |
25 | 监听轮询器
26 | ```kotlin
27 | interval.subscribe {
28 | tv.text = it.toString()
29 | }.finish {
30 | tv.text = "计时完成" // 最后一位数时同时回调 subscribe/finish
31 | }.start()
32 | ```
33 |
34 | | Interval | 描述 |
35 | |-|-|
36 | | start | 开始轮询器 |
37 | | stop | 停止 |
38 | | cancel | 取消, 区别于stop, 此函数执行后并不会回调finish |
39 | | pause | 暂停 |
40 | | resume | 继续 |
41 | | reset | 重置 |
42 | | switch | 切换开关 |
43 | | subscribe | 每次计时都会执行该回调 |
44 | | finish | 当计时器完成时执行该回调, 执行stop后也会回调 |
45 | | life | 指定生命周期自动取消轮询器 |
46 | | onlyResumed | 当界面不可见时暂停, 当界面可见时继续 |
47 |
48 | !!! failure "后台运行"
49 | 由于系统限制, 本工具无法保证一直后台运行
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/converter/GsonConvertFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment.converter
2 |
3 | import com.drake.net.Get
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.constants.Api
6 | import com.drake.net.sample.converter.GsonConverter
7 | import com.drake.net.sample.databinding.FragmentCustomConvertBinding
8 | import com.drake.net.sample.model.GameModel
9 | import com.drake.net.utils.scopeNetLife
10 |
11 |
12 | class GsonConvertFragment :
13 | BaseConvertFragment(R.layout.fragment_custom_convert) {
14 |
15 | override fun initView() {
16 | binding.tvConvertTip.text = """
17 | 1. Google官方出品
18 | 2. Json解析库Java上的老牌解析库
19 | 3. 不支持Kotlin构造参数默认值
20 | 4. 支持动态解析
21 | """.trimIndent()
22 |
23 | scopeNetLife {
24 | binding.tvFragment.text = Get(Api.GAME) {
25 | converter = GsonConverter() // 单例转换器, 此时会忽略全局转换器, 在Net中可以直接解析List等嵌套泛型数据
26 | }.await().list[0].name
27 | }
28 | }
29 |
30 | override fun initData() {
31 | }
32 |
33 | }
34 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/UniqueRequestFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import android.util.Log
4 | import com.drake.engine.base.EngineFragment
5 | import com.drake.net.Post
6 | import com.drake.net.sample.R
7 | import com.drake.net.sample.constants.Api
8 | import com.drake.net.sample.databinding.FragmentUniqueRequestBinding
9 | import com.drake.net.scope.AndroidScope
10 | import com.drake.net.utils.scopeNetLife
11 |
12 | class UniqueRequestFragment :
13 | EngineFragment(R.layout.fragment_unique_request) {
14 |
15 | private var scope: AndroidScope? = null
16 |
17 | override fun initView() {
18 | binding.btnRequest.setOnClickListener {
19 | binding.tvResult.text = "请求中"
20 | scope?.cancel() // 如果存在则取消
21 |
22 | scope = scopeNetLife {
23 | val result = Post(Api.TEXT).await()
24 | Log.d("日志", "请求到结果") // 你一直重复点击"发起请求"按钮会发现永远无法拿到请求结果, 因为每次发起新的请求会取消未完成的
25 | binding.tvResult.text = result
26 | }
27 | }
28 | }
29 |
30 | override fun initData() {
31 | }
32 | }
--------------------------------------------------------------------------------
/docs/timing.md:
--------------------------------------------------------------------------------
1 | 以下为提供实现定时/限时请求思路, 并不限定只有以下方式
2 |
3 |
4 | ## 限时请求
5 |
6 | 即超过指定时间后立即取消请求
7 |
8 | ```kotlin
9 | scopeDialog {
10 | // 当接口请求在100毫秒内没有完成会抛出异常TimeoutCancellationException
11 | withTimeout(100) {
12 | Get(Api.PATH).await()
13 | }
14 | }.catch {
15 | Log.e("日志", "请求错误", it) // catch无法接收到CancellationException异常
16 | }.finally {
17 | Log.e("日志", "请求完成", it) // TimeoutCancellationException属于CancellationException子类故只会被finally接收到
18 | if (it is TimeoutCancellationException) {
19 | toast("由于未在指定时间完成请求则取消请求")
20 | }
21 | }
22 | ```
23 |
24 | ## 定时请求
25 |
26 | 指定请求10次
27 |
28 | ```kotlin
29 | scopeNetLife {
30 | // 每秒请求一次, 总共执行10次
31 | repeat(20) {
32 | delay(1000)
33 | val data = Get(Api.PATH).await()
34 | if(it = 10) {
35 | return@repeat
36 | }
37 | }
38 | }
39 | ```
40 |
41 | 每秒无限循环请求, 根据某个条件`break`退出
42 |
43 | ```kotlin
44 | scopeNetLife {
45 | while (true) {
46 | delay(1.toDuration(DurationUnit.SECONDS))
47 | val data = Get(Api.PATH).await()
48 | if(data.type = 3) {
49 | break
50 | }
51 | }
52 | }
53 | ```
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/AutoDialogFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Post
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.constants.Api
7 | import com.drake.net.sample.databinding.FragmentAutoDialogBinding
8 | import com.drake.net.utils.scopeDialog
9 | import com.drake.tooltip.toast
10 | import kotlinx.coroutines.CancellationException
11 |
12 |
13 | class AutoDialogFragment :
14 | EngineFragment(R.layout.fragment_auto_dialog) {
15 |
16 | override fun initView() {
17 | scopeDialog {
18 | binding.tvFragment.text = Post(Api.DELAY) {
19 | param("username", "你的账号")
20 | param("password", "123456")
21 | }.await()
22 | }.finally {
23 | // 关闭对话框后执行的异常
24 | if (it is CancellationException) {
25 | toast("对话框被关闭, 网络请求自动取消") // 这里存在Handler吐司崩溃, 如果不想处理就直接使用我的吐司库 https://github.com/liangjingkanji/Tooltip
26 | }
27 | }
28 | }
29 |
30 | override fun initData() {
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/converter/MoshiConvertFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment.converter
2 |
3 | import com.drake.net.Get
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.constants.Api
6 | import com.drake.net.sample.converter.MoshiConverter
7 | import com.drake.net.sample.databinding.FragmentCustomConvertBinding
8 | import com.drake.net.sample.model.GameModel
9 | import com.drake.net.utils.scopeNetLife
10 |
11 |
12 | class MoshiConvertFragment :
13 | BaseConvertFragment(R.layout.fragment_custom_convert) {
14 |
15 | override fun initView() {
16 | binding.tvConvertTip.text = """
17 | 1. Square出品的JSON解析库
18 | 2. 支持Kotlin构造默认值
19 | 3. 具备注解和反射两种使用方式
20 | 4. 非可选类型反序列化时赋值Null会抛出异常
21 | 5, 不支持动态解析
22 | """.trimIndent()
23 |
24 | scopeNetLife {
25 | binding.tvFragment.text = Get(Api.GAME) {
26 | converter = MoshiConverter() // 单例转换器, 此时会忽略全局转换器
27 | }.await().list[0].name
28 | }
29 | }
30 |
31 | override fun initData() {
32 | }
33 | }
34 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/PullRefreshFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.brv.utils.linear
4 | import com.drake.brv.utils.setup
5 | import com.drake.engine.base.EngineFragment
6 | import com.drake.net.Get
7 | import com.drake.net.sample.R
8 | import com.drake.net.sample.constants.Api
9 | import com.drake.net.sample.databinding.FragmentPullRefreshBinding
10 | import com.drake.net.sample.model.GameModel
11 | import com.drake.net.utils.scope
12 |
13 |
14 | class PullRefreshFragment :
15 | EngineFragment(R.layout.fragment_pull_refresh) {
16 |
17 | override fun initView() {
18 | binding.rv.linear().setup {
19 | addType(R.layout.item_pull_list)
20 | }
21 |
22 | binding.page.onRefresh {
23 | scope {
24 | val response = Get(String.format(Api.GAME, index)).await()
25 | addData(response.list) {
26 | itemCount < response.total
27 | }
28 | }
29 | }.autoRefresh()
30 | }
31 |
32 | override fun initData() {
33 | }
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/vm/UserViewModel.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.vm
2 |
3 | import androidx.lifecycle.MutableLiveData
4 | import androidx.lifecycle.ViewModel
5 | import androidx.lifecycle.scopeNetLife
6 | import com.drake.net.Get
7 | import com.drake.net.sample.constants.Api
8 | import kotlinx.coroutines.CoroutineScope
9 | import kotlinx.coroutines.coroutineScope
10 |
11 |
12 | /**
13 | * 不要将请求结果抛来抛去, 增加代码复杂度
14 | */
15 | class UserViewModel : ViewModel() {
16 |
17 | // 用户信息
18 | var userInfo: MutableLiveData = MutableLiveData()
19 |
20 | /**
21 | * 使用LiveData接受请求结果, 将该liveData直接使用DataBinding绑定到页面上, 会在请求成功自动更新视图
22 | */
23 | fun fetchUserInfo() = scopeNetLife {
24 | userInfo.value = Get(Api.GAME).await()
25 | }
26 |
27 | /**
28 | * 开始非阻塞异步任务
29 | * 返回Deferred, 调用await()才会返回结果
30 | */
31 | fun fetchList(scope: CoroutineScope) = scope.Get(Api.TEXT)
32 |
33 | /**
34 | * 开始阻塞异步任务
35 | * 直接返回结果
36 | */
37 | suspend fun fetchPrecessData() = coroutineScope {
38 | val response = Get(Api.TEXT).await()
39 | response + "处理数据"
40 | }
41 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/PushRefreshFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.brv.utils.linear
4 | import com.drake.brv.utils.models
5 | import com.drake.brv.utils.setup
6 | import com.drake.engine.base.EngineFragment
7 | import com.drake.net.Get
8 | import com.drake.net.sample.R
9 | import com.drake.net.sample.constants.Api
10 | import com.drake.net.sample.databinding.FragmentPushRefreshBinding
11 | import com.drake.net.sample.model.GameModel
12 | import com.drake.net.utils.scope
13 |
14 | /** 本页面已禁用上拉加载(添加xml属性app:srlEnableLoadMore="false"), 只允许下拉刷新 */
15 | class PushRefreshFragment :
16 | EngineFragment(R.layout.fragment_push_refresh) {
17 |
18 | override fun initView() {
19 | binding.rv.linear().setup {
20 | addType(R.layout.item_game)
21 | }
22 |
23 | binding.page.onRefresh {
24 | scope {
25 | binding.rv.models = Get(Api.GAME).await().list
26 | }
27 | // }.autoRefresh() // 首次下拉刷新
28 | }.showLoading() // 首次加载缺省页
29 | }
30 |
31 | override fun initData() {
32 | }
33 |
34 | }
35 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_custom_convert.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
21 |
22 |
29 |
30 |
31 |
--------------------------------------------------------------------------------
/docs/view-model.md:
--------------------------------------------------------------------------------
1 | Net支持在ViewModel中创建网络请求/异步任务
2 |
3 | !!! Warning "不推荐"
4 | 1. 网络请求不一定要写在ViewModel
5 | 2. 网络请求不要写接口回调
6 | 3. 可以在Activity中直接返回请求结果
7 |
8 |
9 | ## 自动生命周期
10 |
11 | - [示例代码](https://github.com/liangjingkanji/Net/blob/c4d7c4cde6a34b9fa97a75cb357276b75432f8d1/sample/src/main/java/com/drake/net/sample/ui/fragment/ViewModelRequestFragment.kt)
12 |
13 | 使用`scopeXXLife()`创建作用域, 在ViewModel被销毁时自动取消请求
14 |
15 | ```kotlin
16 | class UserViewModel : ViewModel() {
17 |
18 | // 用户信息
19 | var userInfo: MutableLiveData = MutableLiveData()
20 |
21 | /**
22 | * 使用LiveData接受请求结果, 将该liveData直接使用DataBinding绑定到页面上, 会在请求成功自动更新视图
23 | */
24 | fun fetchUserInfo() = scopeNetLife {
25 | userInfo.value = Get(Api.GAME).await()
26 | }
27 |
28 | /**
29 | * 开始非阻塞异步任务
30 | * 返回Deferred, 调用await()才会返回结果
31 | */
32 | fun fetchList(scope: CoroutineScope) = scope.Get(Api.TEST)
33 |
34 | /**
35 | * 开始阻塞异步任务
36 | * 直接返回结果
37 | */
38 | suspend fun fetchPrecessData() = coroutineScope {
39 | val response = Get(Api.TEST).await()
40 | response + "处理数据"
41 | }
42 | }
43 | ```
44 |
45 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/item_game.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
8 |
11 |
12 |
13 |
16 |
17 |
24 |
25 |
32 |
33 |
34 |
35 |
36 |
37 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/item_pull_list.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
8 |
11 |
12 |
13 |
16 |
17 |
24 |
25 |
32 |
33 |
34 |
35 |
36 |
37 |
--------------------------------------------------------------------------------
/sample/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
13 |
22 |
23 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/converter/BaseConvertFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment.converter
2 |
3 | import android.os.Bundle
4 | import android.view.Menu
5 | import android.view.MenuInflater
6 | import android.view.MenuItem
7 | import androidx.annotation.LayoutRes
8 | import androidx.databinding.ViewDataBinding
9 | import androidx.navigation.fragment.findNavController
10 | import androidx.navigation.ui.onNavDestinationSelected
11 | import com.drake.engine.base.EngineFragment
12 | import com.drake.net.sample.R
13 |
14 | abstract class BaseConvertFragment(@LayoutRes contentLayoutId: Int = 0) :
15 | EngineFragment(contentLayoutId) {
16 |
17 | override fun onCreate(savedInstanceState: Bundle?) {
18 | super.onCreate(savedInstanceState)
19 | setHasOptionsMenu(true)
20 | }
21 |
22 | override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
23 | super.onCreateOptionsMenu(menu, inflater)
24 | inflater.inflate(R.menu.menu_converter, menu)
25 | }
26 |
27 | override fun onOptionsItemSelected(item: MenuItem): Boolean {
28 | item.onNavDestinationSelected(findNavController())
29 | return true
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/sample/src/main/res/navigation/nav_converter.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
8 |
12 |
17 |
21 |
25 |
--------------------------------------------------------------------------------
/net/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: "com.android.library"
2 | apply plugin: "kotlin-android"
3 | apply plugin: 'org.jetbrains.dokka'
4 |
5 | android {
6 | compileSdkVersion 30
7 | defaultConfig {
8 | minSdkVersion 19
9 | targetSdkVersion 30
10 | versionCode 1
11 | versionName "1.0"
12 |
13 | testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
14 | consumerProguardFiles "consumer-rules.pro"
15 | }
16 |
17 | kotlinOptions {
18 | freeCompilerArgs = ["-Xinline-classes", "-Xallow-result-return-type"]
19 | }
20 |
21 | dokkaHtml {
22 | outputDirectory.set(file("$rootDir/docs/api"))
23 | suppressInheritedMembers.set(true)
24 | moduleName.set("Net")
25 | }
26 | }
27 |
28 |
29 | dependencies {
30 | implementation 'androidx.appcompat:appcompat:1.3.1'
31 | implementation 'androidx.startup:startup-runtime:1.0.0'
32 | implementation 'androidx.documentfile:documentfile:1.0.1'
33 |
34 | api "com.squareup.okhttp3:okhttp:3.12.13"
35 |
36 | compileOnly "com.github.liangjingkanji:BRV:$brv_version"
37 | compileOnly "org.jetbrains.kotlinx:kotlinx-coroutines-core:$coroutine_version"
38 | compileOnly "org.jetbrains.kotlinx:kotlinx-coroutines-android:$coroutine_version"
39 | }
40 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/CallbackRequestFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import com.drake.engine.base.EngineFragment
4 | import com.drake.net.Net
5 | import com.drake.net.compatible.body
6 | import com.drake.net.sample.R
7 | import com.drake.net.sample.constants.Api
8 | import com.drake.net.sample.databinding.FragmentCallbackRequestBinding
9 | import com.drake.net.utils.runMain
10 | import okhttp3.Call
11 | import okhttp3.Callback
12 | import okhttp3.Response
13 | import java.io.IOException
14 |
15 | class CallbackRequestFragment :
16 | EngineFragment(R.layout.fragment_callback_request) {
17 |
18 | override fun initData() {
19 | }
20 |
21 | override fun initView() {
22 | // Net同样支持OkHttp原始的队列任务
23 | Net.post(Api.TEXT).enqueue(object : Callback {
24 | override fun onFailure(call: Call, e: IOException) {
25 | }
26 |
27 | override fun onResponse(call: Call, response: Response) {
28 | // 此处为子线程
29 | val body = response.body?.string() ?: "无数据"
30 | runMain {
31 | // 此处为主线程
32 | binding.tvFragment.text = body
33 | }
34 | }
35 | })
36 | }
37 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/ViewModelRequestFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import androidx.fragment.app.viewModels
4 | import com.drake.engine.base.EngineFragment
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.databinding.FragmentViewModelRequestBinding
7 | import com.drake.net.sample.utils.HttpUtils
8 | import com.drake.net.sample.vm.UserViewModel
9 | import com.drake.net.utils.scopeNetLife
10 |
11 | class ViewModelRequestFragment :
12 | EngineFragment(R.layout.fragment_view_model_request) {
13 |
14 | private val userViewModel: UserViewModel by viewModels() // 创建ViewModel
15 |
16 | override fun initView() {
17 |
18 | // 直接将用户信息绑定到视图上
19 | binding.lifecycleOwner = this
20 | binding.m = userViewModel
21 |
22 | // 动作开始拉取服务器数据
23 | binding.btnFetchUserinfo.setOnClickListener {
24 | userViewModel.fetchUserInfo()
25 | }
26 | }
27 |
28 | override fun initData() {
29 |
30 | scopeNetLife {
31 | val configAsync = HttpUtils.getConfigAsync(this)
32 | // 经常使用的请求可以封装函数
33 | val userInfo = HttpUtils.getUser()
34 | configAsync.await() // 实际上在getUser之前就发起请求, 此处只是等待结果, 这就是并发请求
35 | }
36 | }
37 | }
--------------------------------------------------------------------------------
/docs/api/styles/jetbrains-mono.css:
--------------------------------------------------------------------------------
1 | @font-face{
2 | font-family: 'JetBrains Mono';
3 | src: local('Iosevka Curly Medium'),
4 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/iosevka-curly/iosevka-curly-medium.woff2') format('woff2');
5 | font-display: swap;
6 | font-weight: normal;
7 | font-style: normal;
8 | }
9 | @font-face{
10 | font-family: 'JetBrains Mono';
11 | src: local('Iosevka Curly Bold'),
12 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/iosevka-curly/iosevka-curly-bold.woff2') format('woff2');
13 | font-display: swap;
14 | font-weight: bold;
15 | font-style: normal;
16 | }
17 | @font-face{
18 | font-family: 'HYZhengYuan';
19 | src: local('HYYouYuan-55W'),
20 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/HYYouYuan/HYYouYuan-55W.ttf') format('truetype');
21 | font-display: swap;
22 | font-weight: normal;
23 | font-style: normal;
24 | }
25 | @font-face{
26 | font-family: 'HYZhengYuan';
27 | src: local('HYYouYuan-75W'),
28 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/HYYouYuan/HYYouYuan-75W.ttf') format('truetype');
29 | font-display: swap;
30 | font-weight: bold;
31 | font-style: normal;
32 | }
--------------------------------------------------------------------------------
/sample/src/main/res/layout/layout_empty.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
7 |
8 |
18 |
19 |
29 |
30 |
31 |
--------------------------------------------------------------------------------
/docs/api/images/docs_logo.svg:
--------------------------------------------------------------------------------
1 |
8 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/CoroutineScopeFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import androidx.lifecycle.Lifecycle
4 | import com.drake.engine.base.EngineFragment
5 | import com.drake.net.sample.R
6 | import com.drake.net.sample.databinding.FragmentCoroutineScopeBinding
7 | import com.drake.net.utils.scope
8 | import com.drake.net.utils.scopeLife
9 | import com.drake.net.utils.scopeNet
10 | import com.drake.net.utils.scopeNetLife
11 | import kotlinx.coroutines.delay
12 |
13 |
14 | class CoroutineScopeFragment :
15 | EngineFragment(R.layout.fragment_coroutine_scope) {
16 | override fun initData() {
17 | // 其作用域在应用进程销毁时才会被动取消
18 | scope {
19 |
20 | }
21 |
22 | // 其作用域在Activity或者Fragment销毁(onDestroy)时被动取消 [scopeNetLife]
23 | scopeLife {
24 | delay(2000)
25 | binding.tvFragment.text = "任务结束"
26 | }
27 |
28 | // 自定义取消跟随的生命周期, 失去焦点时立即取消作用域
29 | scopeLife(Lifecycle.Event.ON_PAUSE) {
30 |
31 | }
32 |
33 | // 此作用域会捕捉发生的异常, 如果是网络异常会进入网络异常的全局处理函数, 例如自动弹出吐司 [NetConfig.onError]
34 | scopeNet {
35 |
36 | }
37 |
38 | // 自动网络处理 + 生命周期管理
39 | scopeNetLife {
40 |
41 | }
42 | }
43 |
44 | override fun initView() {
45 | }
46 | }
47 |
--------------------------------------------------------------------------------
/docs/https.md:
--------------------------------------------------------------------------------
1 | Net可快速配置Https证书, 或者使用OkHttp的方式
2 |
3 | ## 使用CA证书
4 |
5 | Https如果使用的CA证书, 不需要任何配置可以直接访问
6 |
7 | ```kotlin
8 | scopeNetLife {
9 | tv.text = Get(Api.PATH).await()
10 | }
11 | ```
12 |
13 | ## 信任所有证书
14 |
15 | 信任所有证书可以解决无法访问私有证书的Https地址问题
16 |
17 | === "全局配置"
18 |
19 | ```kotlin
20 | NetConfig.initialize(Api.HOST, this){
21 | trustSSLCertificate() // 信任所有证书
22 | }
23 | ```
24 | === "单例配置"
25 |
26 | ```kotlin
27 | scopeNetLife {
28 | Get(Api.PATH){
29 | setClient {
30 | trustSSLCertificate()
31 | }
32 | }.await()
33 | }
34 | ```
35 |
36 | ## 导入证书
37 |
38 | 私有证书可以放到任何位置, 只要读取到`InputStream`流对象即可
39 |
40 | === "全局配置"
41 |
42 | ```kotlin
43 | NetConfig.initialize(Api.HOST, this) {
44 | val privateCertificate = resources.assets.open("https.certificate")
45 | setSSLCertificate(privateCertificate)
46 | }
47 | ```
48 |
49 | === "单例配置"
50 |
51 | ```kotlin
52 | scopeNetLife {
53 | Get(Api.PATH) {
54 | setClient {
55 | val privateCertificate = resources.assets.open("https.certificate") // 这里的证书是放到应用的资产目录下
56 | setSSLCertificate(privateCertificate)
57 | }
58 | }.await()
59 | }
60 | ```
61 |
62 |
63 |
64 |
65 |
66 |
67 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/PreviewCacheFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import android.util.Log
4 | import com.drake.engine.base.EngineFragment
5 | import com.drake.net.Get
6 | import com.drake.net.cache.CacheMode
7 | import com.drake.net.sample.R
8 | import com.drake.net.sample.constants.Api
9 | import com.drake.net.sample.databinding.FragmentReadCacheBinding
10 | import com.drake.net.utils.scopeNetLife
11 |
12 |
13 | /** 预览缓存. 其实不仅仅是双重加载缓存/网络也可以用于回退请求, 可以执行两次作用域并且忽略preview{}内的所有错误 */
14 | class PreviewCacheFragment : EngineFragment(R.layout.fragment_read_cache) {
15 |
16 | override fun initView() {
17 |
18 | // 一般用于秒开首页或者回退加载数据. 我们可以在preview{}只加载缓存. 然后再执行scopeNetLife来请求网络, 做到缓存+网络双重加载的效果
19 |
20 | scopeNetLife {
21 | // 然后执行这里(网络请求)
22 | binding.tvFragment.text = Get(Api.TEXT) {
23 | setCacheMode(CacheMode.WRITE)
24 | }.await()
25 | Log.d("日志", "网络请求")
26 | }.preview(true) {
27 | // 先执行这里(仅读缓存), 任何异常都视为读取缓存失败
28 | binding.tvFragment.text = Get(Api.TEXT) {
29 | setCacheMode(CacheMode.READ)
30 | }.await()
31 | Log.d("日志", "读取缓存")
32 | }
33 | }
34 |
35 | override fun initData() {
36 | }
37 |
38 | }
39 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/converter/SerializationConvertFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment.converter
2 |
3 | import com.drake.net.Get
4 | import com.drake.net.sample.R
5 | import com.drake.net.sample.constants.Api
6 | import com.drake.net.sample.converter.SerializationConverter
7 | import com.drake.net.sample.databinding.FragmentCustomConvertBinding
8 | import com.drake.net.sample.model.GameModel
9 | import com.drake.net.utils.scopeNetLife
10 |
11 | class SerializationConvertFragment :
12 | BaseConvertFragment(R.layout.fragment_custom_convert) {
13 |
14 | override fun initView() {
15 | binding.tvConvertTip.text = """
16 | 1. kotlin官方出品, 推荐使用
17 | 2. kotlinx.serialization 是Kotlin上是最完美的序列化工具
18 | 3. 支持多种反序列化数据类型Pair/枚举/Map...
19 | 4. 多配置选项
20 | 5. 支持动态解析
21 | 6. 支持ProtoBuf/CBOR/JSON等数据
22 | """.trimIndent()
23 |
24 | scopeNetLife {
25 | val data = Get(Api.GAME) {
26 | // 该转换器直接解析JSON中的data字段, 而非返回的整个JSON字符串
27 | converter = SerializationConverter() // 单例转换器, 此时会忽略全局转换器
28 | }.await()
29 |
30 | binding.tvFragment.text = data.list[0].name
31 | }
32 | }
33 |
34 | override fun initData() {
35 | }
36 |
37 | }
38 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/interceptor/RefreshTokenInterceptor.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.interceptor
2 |
3 | import com.drake.net.Net
4 | import com.drake.net.exception.ResponseException
5 | import com.drake.net.sample.constants.Api
6 | import com.drake.net.sample.constants.UserConfig
7 | import com.drake.net.sample.model.TokenModel
8 | import okhttp3.Interceptor
9 | import okhttp3.Response
10 |
11 |
12 | /**
13 | * 客户端token自动续期示例
14 | */
15 | class RefreshTokenInterceptor : Interceptor {
16 | override fun intercept(chain: Interceptor.Chain): Response {
17 | val request = chain.request()
18 | val response = chain.proceed(request)
19 | return synchronized(RefreshTokenInterceptor::class.java) {
20 | if (response.code == 401 && UserConfig.isLogin && !request.url.encodedPath.contains(Api.Token)) {
21 | val tokenInfo = Net.get(Api.Token).execute() // 同步请求token
22 | if (tokenInfo.isExpired) {
23 | // token过期抛出异常, 由全局错误处理器处理, 在其中可以跳转到登陆界面提示用户重新登陆
24 | throw ResponseException(response, "登录状态失效")
25 | } else {
26 | UserConfig.token = tokenInfo.token
27 | }
28 | chain.proceed(request)
29 | } else {
30 | response
31 | }
32 | }
33 | }
34 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/utils/AESUtils.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.utils
2 |
3 | import okio.ByteString
4 | import okio.ByteString.Companion.decodeHex
5 | import javax.crypto.Cipher
6 | import javax.crypto.spec.SecretKeySpec
7 |
8 | object AESUtils {
9 |
10 | private const val KEY = "123456789"
11 | private const val IV = "123456789"
12 |
13 | fun encrypt(data: String): String {
14 | val key = KEY.decodeHex()
15 | val iv = IV.decodeHex()
16 | val cipher = Cipher.getInstance("AES/CBC/PKCS5Padding")
17 | val keySpec = SecretKeySpec(key.toByteArray(), "AES")
18 | val ivSpec = javax.crypto.spec.IvParameterSpec(iv.toByteArray())
19 | cipher.init(Cipher.ENCRYPT_MODE, keySpec, ivSpec)
20 | val encrypted = cipher.doFinal(data.toByteArray())
21 | return ByteString.of(*encrypted).hex()
22 | }
23 |
24 | fun decrypt(data: String): String {
25 | val key = KEY.decodeHex()
26 | val iv = IV.decodeHex()
27 | val cipher = Cipher.getInstance("AES/CBC/PKCS5Padding")
28 | val keySpec = SecretKeySpec(key.toByteArray(), "AES")
29 | val ivSpec = javax.crypto.spec.IvParameterSpec(iv.toByteArray())
30 | cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec)
31 | val encrypted = cipher.doFinal(data.decodeHex().toByteArray())
32 | return String(encrypted)
33 | }
34 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/time/IntervalStatus.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.time
26 |
27 | /**
28 | * 计时器的状态
29 | */
30 | enum class IntervalStatus {
31 | STATE_ACTIVE, STATE_IDLE, STATE_PAUSE
32 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/LimitedTimeFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import android.util.Log
4 | import android.view.View
5 | import com.drake.engine.base.EngineFragment
6 | import com.drake.net.Get
7 | import com.drake.net.sample.R
8 | import com.drake.net.sample.constants.Api
9 | import com.drake.net.sample.databinding.FragmentLimitedTimeBinding
10 | import com.drake.net.utils.scopeDialog
11 | import com.drake.tooltip.toast
12 | import kotlinx.coroutines.TimeoutCancellationException
13 | import kotlinx.coroutines.withTimeout
14 |
15 | class LimitedTimeFragment : EngineFragment(R.layout.fragment_limited_time) {
16 | override fun initView() {
17 | binding.v = this
18 | }
19 |
20 | override fun initData() {
21 | }
22 |
23 | override fun onClick(v: View) {
24 | scopeDialog {
25 | // 当接口请求在100毫秒内没有完成会抛出异常TimeoutCancellationException
26 | withTimeout(100) {
27 | Get(Api.TEXT).await()
28 | }
29 | }.catch {
30 | Log.e("日志", "catch", it) // catch无法接收到CancellationException异常
31 | }.finally {
32 | Log.e("日志", "finally", it) // TimeoutCancellationException属于CancellationException子类故只会被finally接收到
33 | if (it is TimeoutCancellationException) {
34 | toast("由于未在指定时间完成请求则取消请求")
35 | }
36 | }
37 | }
38 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/request/Method.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.request
26 |
27 | enum class Method {
28 | GET, HEAD, OPTIONS, TRACE, // Url request
29 | POST, DELETE, PUT, PATCH // Body request
30 | }
--------------------------------------------------------------------------------
/net/src/main/res/xml/network_security_config.xml:
--------------------------------------------------------------------------------
1 |
24 |
25 |
26 |
27 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_edit_debounce.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
6 |
7 |
12 |
13 |
20 |
21 |
22 |
27 |
28 |
33 |
34 |
35 |
36 |
37 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/layout_error.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
8 |
9 |
10 |
20 |
21 |
32 |
33 |
34 |
35 |
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_https_certificate.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
12 |
13 |
18 |
19 |
24 |
25 |
35 |
36 |
37 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/reflect/TypeUtils.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.reflect
26 |
27 | import kotlin.reflect.javaType
28 | import kotlin.reflect.typeOf
29 |
30 | @OptIn(ExperimentalStdlibApi::class)
31 | inline fun typeTokenOf() = typeOf().javaType
--------------------------------------------------------------------------------
/docs/download-file.md:
--------------------------------------------------------------------------------
1 | 泛型改为`File`即可
2 |
3 | ```kotlin
4 | scopeNetLife {
5 | val file = Get(Api.DOWNLOAD).await()
6 | }
7 | ```
8 |
9 | ## 下载选项
10 |
11 | 丰富的下载定制方案, 并且在不断更新
12 |
13 | ```kotlin
14 | scopeNetLife {
15 | val file =
16 | Get("https://github.com/liangjingkanji/Net/releases/latest/download/net-sample.apk") {
17 | setDownloadFileName("net.apk")
18 | setDownloadDir(requireContext().filesDir)
19 | setDownloadMd5Verify()
20 | }.await()
21 | }
22 | ```
23 |
24 | | 配置选项 | 描述 |
25 | | --------------------------- | ------------------------------------------------------------ |
26 | | addDownloadListener | [下载进度监听器](progress.md) |
27 | | setDownloadFileName | 下载文件名 |
28 | | setDownloadDir | 下载目录 |
29 | | setDownloadMd5Verify | 下载文件MD5校验 |
30 | | setDownloadFileNameConflict | 下载文件同名冲突解决 |
31 | | setDownloadFileNameDecode | 文件名Url解码中文 |
32 | | setDownloadTempFile | 临时文件名 |
33 |
34 | ## 重复下载
35 |
36 | 防止重复下载有以下方式
37 |
38 | | 函数 | 描述 |
39 | | -------- | --------------------------------------------------------- |
40 | | 文件判断 | 判断本地是否存在同名文件 |
41 | | 缓存模式 | 开启缓存, 占用设备两份空间(缓存/下载成功文件都占空间) |
42 | | MD5校验 | 服务器返回`Content-MD5`, 客户端开启`setDownloadMd5Verify` |
--------------------------------------------------------------------------------
/docs/img/discussesions.svg:
--------------------------------------------------------------------------------
1 |
2 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/cache/CacheMode.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.cache
26 |
27 | enum class CacheMode {
28 |
29 | /** 只读取缓存, 本操作并不会请求网络故不存在写入缓存 */
30 | READ,
31 |
32 | /** 只请求网络, 强制写入缓存 */
33 | WRITE,
34 |
35 | /** 先从缓存读取，如果失败再从网络读取, 强制写入缓存 */
36 | READ_THEN_REQUEST,
37 |
38 | /** 先从网络读取，如果失败再从缓存读取, 强制写入缓存 */
39 | REQUEST_THEN_READ,
40 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/interceptor/RequestInterceptor.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.interceptor
26 |
27 | import com.drake.net.request.BaseRequest
28 |
29 | interface RequestInterceptor {
30 |
31 | /**
32 | * 当你使用Net发起请求的时候就会触发该拦截器
33 | * 该拦截器属于轻量级不具备重发的功能, 一般用于请求参数的修改
34 | * 请勿在这里进行请求重发可能会导致死循环
35 | */
36 | fun interceptor(request: BaseRequest)
37 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/NetConnectException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import okhttp3.Request
28 |
29 | /**
30 | * 连接错误
31 | * @param request 请求信息
32 | * @param message 错误描述信息
33 | * @param cause 错误原因
34 | */
35 | class NetConnectException(
36 | request: Request,
37 | message: String? = null,
38 | cause: Throwable? = null
39 | ) : HttpFailureException(request, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/NetworkingException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import okhttp3.Request
28 |
29 | /**
30 | * 无网络情况
31 | * @param request 请求信息
32 | * @param message 错误描述信息
33 | * @param cause 错误原因
34 | */
35 | class NetworkingException(
36 | request: Request,
37 | message: String? = null,
38 | cause: Throwable? = null
39 | ) : HttpFailureException(request, message, cause)
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_upload_file.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
13 |
14 |
19 |
20 |
25 |
26 |
35 |
36 |
42 |
43 |
44 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/NetUnknownHostException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import okhttp3.Request
28 |
29 | /**
30 | * 主机域名无法访问
31 | * @param request 请求信息
32 | * @param message 错误描述信息
33 | * @param cause 错误原因
34 | */
35 | class NetUnknownHostException(
36 | request: Request,
37 | message: String? = null,
38 | cause: Throwable? = null
39 | ) : HttpFailureException(request, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/HttpFailureException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import okhttp3.Request
28 |
29 | /**
30 | * 该类表示Http请求在服务器响应之前失败
31 | * @param request 请求信息
32 | * @param message 错误描述信息
33 | * @param cause 错误原因
34 | */
35 | open class HttpFailureException(
36 | request: Request,
37 | message: String? = null,
38 | cause: Throwable? = null
39 | ) : NetException(request, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/NetSocketTimeoutException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import okhttp3.Request
28 |
29 | /**
30 | * 请求过程中读取或者写入超时
31 | * @param request 请求信息
32 | * @param message 错误描述信息
33 | * @param cause 错误原因
34 | */
35 | class NetSocketTimeoutException(
36 | request: Request,
37 | message: String? = null,
38 | cause: Throwable? = null
39 | ) : HttpFailureException(request, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/transform/DeferredTransform.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.transform
26 |
27 | import kotlinx.coroutines.Deferred
28 |
29 | /**
30 | * 可以将[Deferred]返回结果进行转换
31 | * [block]在[Deferred]执行成功返回结果时执行
32 | */
33 | fun Deferred.transform(block: (T) -> R): DeferredTransform {
34 | return DeferredTransform(this, block)
35 | }
36 |
37 | data class DeferredTransform(val deferred: Deferred, val block: (T) -> R)
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_view_model_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
6 |
7 |
10 |
11 |
12 |
13 |
19 |
20 |
26 |
27 |
35 |
36 |
43 |
44 |
45 |
46 |
47 |
--------------------------------------------------------------------------------
/net/src/main/res/drawable/ic_limited_time.xml:
--------------------------------------------------------------------------------
1 |
24 |
25 |
30 |
33 |
34 |
--------------------------------------------------------------------------------
/docs/img/issues.svg:
--------------------------------------------------------------------------------
1 |
2 |
--------------------------------------------------------------------------------
/docs/model-generate.md:
--------------------------------------------------------------------------------
1 | 应该没人会完全手写数据模型吧? 建议使用`JSON To Kotlin Class` 插件完成
2 |
3 | ## 安装插件
4 |
5 | 在Plugins里面搜索kotlin关键词下载安装
6 | 
7 |
8 |
9 | ## 使用插件
10 |
11 | 选中分包后, 使用快捷键或者鼠标右键打开填写Json界面
12 |
13 | 
14 |
15 | 添加Json然后点击`Generate`生成
16 |
17 | 
18 |
19 | 然后就会在选中的分包下生成一个数据模型类了
20 |
21 | !!! Warning "不要生成数组"
22 | 不要输入JSON数组生成(否则生成的类会继承ArrayList), 输入JSON对象, 请求使用`Get>`
23 |
24 | ## 高级设置
25 |
26 | 点击`Advanced`打开设置界面
27 |
28 | ### 可空选项
29 |
30 | 截图即为我的推荐配置
31 |
32 | 
33 |
34 | 1. Keyword 创建的数据模型的字段是 Val还是Var
35 | 2. Type 字段是否是可空类型, 最后选项表示根据Json的值判断是否可空
36 | 3. 默认值的策略, 无法选择不介绍
37 |
38 | ### 使用的框架
39 |
40 | 生成数据模型时会兼容你使用的框架, 例如Moshi和ks可能需要注解, 然后会自动生成SerialName这些名称注解
41 | 
42 |
43 |
44 | ### 其他
45 |
46 | 截图即为我的推荐配置
47 |
48 | 
49 |
50 | 1. 是否使用注释, 既会将Json字符串作为注释保留在数据模型类中
51 | 2. 根据字母排序数据模型的字段
52 | 3. 使用内部类. 例如Json中的Json对象会作为内部类被创建在数据模型类中 (推荐开启, 保持高内聚低耦合)
53 | 4. 如果Json对象的字段都是原始类型则使用Map来表示
54 | 5. 只在需要时创建注解
55 | 6. 自动验证Json正确性(在填写时)
56 | 7. Json格式化时使用的空格数量
57 | 8. 指定一个类作为父类模板(既创建的数据模型都会继承该类)
58 |
59 | ### 扩展
60 |
61 | 截图即为我的推荐配置
62 |
63 | 
64 |
65 | 1. 添加@Keep注解, 为防止被代码混淆
66 | 2. 注解和字段处于同一行, 便于美观
67 | 3. 使用Parcelable序列化
68 | 4. 为字段添加前缀/后缀
69 | 5. 为数据模型类添加前缀/后缀
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/URLParseException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | /**
28 | * URL地址错误
29 | *
30 | * @param message 错误描述信息
31 | * @param cause 错误原因
32 | */
33 | open class URLParseException(
34 | message: String? = null,
35 | cause: Throwable? = null,
36 | ) : Exception(message, cause) {
37 |
38 | var occurred: String = ""
39 |
40 | override fun getLocalizedMessage(): String? {
41 | return super.getLocalizedMessage() + occurred
42 | }
43 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/log/MessageType.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.log
26 |
27 | enum class MessageType(var type: String) {
28 | REQUEST_URL("RQU"),
29 | REQUEST_TIME("RQT"),
30 | REQUEST_METHOD("RQM"),
31 | REQUEST_HEADER("RQH"),
32 | REQUEST_BODY("RQB"),
33 | REQUEST_END("RQD"),
34 | RESPONSE_TIME("RST"),
35 | RESPONSE_STATUS("RSS"),
36 | RESPONSE_HEADER("RSH"),
37 | RESPONSE_BODY("RSB"),
38 | RESPONSE_END("RSD"),
39 | RESPONSE_ERROR("REE"),
40 | UNKNOWN("UNKNOWN");
41 | }
--------------------------------------------------------------------------------
/docs/auto-refresh.md:
--------------------------------------------------------------------------------
1 | !!! success "模块化依赖"
2 | 如果自己处理下拉刷新可跳过本章, Net可以仅仅作为简单的网络框架存在
3 |
4 |
5 | Net可依赖三方库 [BRV](https://github.com/liangjingkanji/BRV) 实现自动处理下拉刷新
6 |
7 | 
8 |
9 | ```groovy
10 | implementation 'com.github.liangjingkanji:BRV:+' // 使用固定版本号替换+符号
11 | ```
12 |
13 | ## PageRefreshLayout
14 |
15 | ```xml
16 |
23 |
24 |
28 |
29 |
30 | ```
31 |
32 | ## 创建列表
33 |
34 | ```kotlin
35 | rv_push.linear().setup {
36 | addType(R.layout.item_list)
37 | }
38 | ```
39 |
40 | ## 网络请求
41 |
42 | 1. 请求开始, 显示下拉刷新动画
43 | 2. 请求成功, 显示`内容`缺省页
44 | 3. 请求失败, 显示`错误`缺省页
45 |
46 | ```kotlin hl_lines="2"
47 | page.onRefresh {
48 | scope {
49 | // 请求到数据设置到RecyclerView
50 | rv_push.models = Get(Api.PATH).await().data.list
51 | }
52 | }.autoRefresh()
53 | ```
54 |
55 | ## 生命周期
56 |
57 | | 生命周期 | 描述 |
58 | | -------- | -------------------------------------------------- |
59 | | 开始 | `showLoading/autoRefresh`触发`onRefresh`, 开始请求 |
60 | | 结束 | PageRefreshLayout被销毁, 请求自动取消 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/ConvertException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 | package com.drake.net.exception
25 |
26 | import okhttp3.Response
27 | import com.drake.net.compatible.*
28 |
29 |
30 | /**
31 | * 转换数据异常
32 | * @param response 响应信息
33 | * @param message 错误描述信息
34 | * @param cause 错误原因
35 | * @param tag 可携带任意对象, 一般用于在转换器/拦截器中添加然后传递给错误处理器去使用判断
36 | */
37 | class ConvertException(
38 | response: Response,
39 | message: String? = null,
40 | cause: Throwable? = null,
41 | var tag: Any? = null
42 | ) : HttpResponseException(response, message, cause)
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/converter/ProtobufConverter.kt:
--------------------------------------------------------------------------------
1 | @file:Suppress("UNCHECKED_CAST", "MemberVisibilityCanBePrivate")
2 |
3 | package com.drake.net.sample.converter
4 |
5 | import com.drake.net.compatible.body
6 | import com.drake.net.compatible.code
7 | import com.drake.net.compatible.request
8 | import com.drake.net.convert.NetConverter
9 | import com.drake.net.exception.ConvertException
10 | import com.drake.net.exception.RequestParamsException
11 | import com.drake.net.exception.ServerResponseException
12 | import com.drake.net.request.kType
13 | import kotlinx.serialization.protobuf.ProtoBuf
14 | import kotlinx.serialization.serializer
15 | import okhttp3.Response
16 | import java.lang.reflect.Type
17 |
18 | class ProtobufConverter : NetConverter {
19 |
20 | override fun onConvert(succeed: Type, response: Response): R? {
21 | try {
22 | return NetConverter.onConvert(succeed, response)
23 | } catch (e: ConvertException) {
24 | val code = response.code
25 | when {
26 | code in 200..299 -> { // 请求成功
27 | val bytes = response.body?.bytes() ?: return null
28 | val kType = response.request.kType ?: throw ConvertException(response, "Request does not contain KType")
29 | return ProtoBuf.decodeFromByteArray(ProtoBuf.serializersModule.serializer(kType), bytes) as R
30 | }
31 | code in 400..499 -> throw RequestParamsException(response, code.toString()) // 请求参数错误
32 | code >= 500 -> throw ServerResponseException(response, code.toString()) // 服务器异常错误
33 | else -> throw ConvertException(response, message = "Http status code not within range")
34 | }
35 | }
36 | }
37 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/DownloadFileException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import com.drake.net.compatible.*
28 | import okhttp3.Response
29 |
30 | /**
31 | * 下载文件异常
32 | * @param response 响应信息
33 | * @param message 错误描述信息
34 | * @param cause 错误原因
35 | * @param tag 可携带任意对象, 一般用于在转换器/拦截器中添加然后传递给错误处理器去使用判断
36 | */
37 | class DownloadFileException(
38 | response: Response,
39 | message: String? = null,
40 | cause: Throwable? = null,
41 | var tag: Any? = null
42 | ) : HttpResponseException(response, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/okhttp/OkHttpExtension.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.okhttp
26 |
27 | import com.drake.net.compatible.dispatcher
28 | import com.drake.net.compatible.interceptors
29 | import com.drake.net.interceptor.NetOkHttpInterceptor
30 | import okhttp3.OkHttpClient
31 |
32 | /**
33 | * Net要求经过该函数处理创建特殊的OkHttpClient
34 | */
35 | fun OkHttpClient.toNetOkhttp() = run {
36 | if (!interceptors.contains(NetOkHttpInterceptor)) {
37 | newBuilder().addInterceptor(NetOkHttpInterceptor).build()
38 | } else {
39 | this
40 | }
41 | }
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_download_file.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
12 |
13 |
27 |
28 |
39 |
40 |
41 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/interfaces/ProgressListener.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 | package com.drake.net.interfaces
25 |
26 | import com.drake.net.component.Progress
27 |
28 | /**
29 | * 进度监听器, 可能为下载或上传
30 | *
31 | * @param interval 进度监听器刷新的间隔时间, 单位为毫秒, 默认值为500ms
32 | */
33 | abstract class ProgressListener(var interval: Long = 500) {
34 | // 上次进度变化的的开机时间
35 | var elapsedTime = 0L
36 |
37 | // 距离上次进度变化的新增字节数
38 | var intervalByteCount = 0L
39 |
40 | /**
41 | * 监听上传/下载进度回调函数
42 | * @param p 上传或者下载进度
43 | */
44 | abstract fun onProgress(p: Progress)
45 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/RequestParamsException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import com.drake.net.compatible.*
28 | import okhttp3.Response
29 |
30 | /**
31 | * 400 - 499 客户端请求异常
32 | * @param response 响应信息
33 | * @param message 错误描述信息
34 | * @param cause 错误原因
35 | * @param tag 可携带任意对象, 一般用于在转换器/拦截器中添加然后传递给错误处理器去使用判断
36 | */
37 | class RequestParamsException(
38 | response: Response,
39 | message: String? = null,
40 | cause: Throwable? = null,
41 | var tag: Any? = null
42 | ) : HttpResponseException(response, message, cause)
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/ServerResponseException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import com.drake.net.compatible.*
28 | import okhttp3.Response
29 |
30 |
31 | /**
32 | * >= 500 服务器异常
33 | * @param response 响应信息
34 | * @param message 错误描述信息
35 | * @param cause 错误原因
36 | * @param tag 可携带任意对象, 一般用于在转换器/拦截器中添加然后传递给错误处理器去使用判断
37 | */
38 | class ServerResponseException(
39 | response: Response,
40 | message: String? = null,
41 | cause: Throwable? = null,
42 | var tag: Any? = null
43 | ) : HttpResponseException(response, message, cause)
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_timing_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
8 |
11 |
12 |
13 |
14 |
20 |
21 |
27 |
28 |
34 |
35 |
41 |
42 |
49 |
50 |
51 |
--------------------------------------------------------------------------------
/docs/css/extra.css:
--------------------------------------------------------------------------------
1 | @font-face{
2 | font-family: 'Iosevka Curly';
3 | src: local('Iosevka Curly Medium'),
4 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/iosevka-curly/iosevka-curly-medium.woff2') format('woff2');
5 | font-display: swap;
6 | font-weight: normal;
7 | font-style: normal;
8 | }
9 | @font-face{
10 | font-family: 'Iosevka Curly';
11 | src: local('Iosevka Curly Bold'),
12 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/iosevka-curly/iosevka-curly-bold.woff2') format('woff2');
13 | font-display: swap;
14 | font-weight: bold;
15 | font-style: normal;
16 | }
17 | @font-face{
18 | font-family: 'HYYouYuan';
19 | src: local('HYYouYuan-55W'),
20 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/HYYouYuan/HYYouYuan-55W.ttf') format('truetype');
21 | font-display: swap;
22 | font-weight: normal;
23 | font-style: normal;
24 | }
25 | @font-face{
26 | font-family: 'HYYouYuan';
27 | src: local('HYYouYuan-75W'),
28 | url('https://raw.githubusercontent.com/liangjingkanji/liangjingkanji/master/font/HYYouYuan/HYYouYuan-75W.ttf') format('truetype');
29 | font-display: swap;
30 | font-weight: bold;
31 | font-style: normal;
32 | }
33 |
34 | * {
35 | -webkit-font-feature-settings: "liga" on, "calt" on;
36 | -webkit-font-smoothing: subpixel-antialiased;
37 | -moz-osx-font-smoothing: auto;
38 | text-rendering: optimizeLegibility;
39 | font-family: "Iosevka Curly", HYYouYuan !important;
40 | }
41 |
42 | code,
43 | .md-nav,
44 | .md-typeset code,
45 | .md-typeset {
46 | font-size: 14px !important;
47 | }
48 |
49 | .highlight span.filename,
50 | .md-typeset .admonition-title,
51 | .md-typeset summary {
52 | font-weight: normal;
53 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/internal/NetInitializer.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.internal
26 |
27 | import android.content.Context
28 | import androidx.startup.Initializer
29 | import com.drake.net.NetConfig
30 |
31 | /**
32 | * 使用AppStartup默认初始化[NetConfig.app], 仅应用主进程下有效
33 | * 在其他进程使用Net请手动在Application中初始化[NetConfig.initialize]
34 | */
35 | internal class NetInitializer : Initializer {
36 | override fun create(context: Context) {
37 | NetConfig.app = context
38 | }
39 |
40 | override fun dependencies(): MutableList>> {
41 | return mutableListOf()
42 | }
43 | }
--------------------------------------------------------------------------------
/docs/converter.md:
--------------------------------------------------------------------------------
1 | Net支持请求返回的数据类型取决于你的转换器实现
2 |
3 | # Get<任何对象>(Api.PATH).await()
4 |
5 | 默认转换器支持返回以下数据类型
6 |
7 | | 函数 | 描述 |
8 | |-|-|
9 | | String | 字符串 |
10 | | ByteArray | 字节数组 |
11 | | ByteString | 更多功能的字符串对象 |
12 | | File | 文件对象, 这种情况其实应当称为[下载文件](download-file.md) |
13 | | Response | 所有响应信息(响应体/响应头/请求信息等) |
14 |
15 | 使用示例
16 |
17 | ```kotlin
18 | scopeNetLife {
19 | Get(Api.PATH).await().headers("响应头名称") // 返回响应头
20 | }
21 | ```
22 |
23 | ??? example "转换器实现非常简单"
24 | ```kotlin title="NetConverter.kt" linenums="1"
25 | interface NetConverter {
26 |
27 | @Throws(Throwable::class)
28 | fun onConvert(succeed: Type, response: Response): R?
29 |
30 | companion object DEFAULT : NetConverter {
31 | /**
32 | * 返回结果应当等于泛型对象, 可空
33 | * @param succeed 请求要求返回的泛型类型
34 | * @param response 请求响应对象
35 | */
36 | override fun onConvert(succeed: Type, response: Response): R? {
37 | return when {
38 | succeed === String::class.java && response.isSuccessful -> response.body?.string() as R
39 | succeed === ByteString::class.java && response.isSuccessful -> response.body?.byteString() as R
40 | succeed is GenericArrayType && succeed.genericComponentType === Byte::class.java && response.isSuccessful -> response.body?.bytes() as R
41 | succeed === File::class.java && response.isSuccessful -> response.file() as R
42 | succeed === Response::class.java -> response as R
43 | else -> throw ConvertException(response, "An exception occurred while converting the NetConverter.DEFAULT")
44 | }
45 | }
46 | }
47 | }
48 | ```
49 |
50 | 假设不支持你需要的数据类型, 例如JSON/ProtoBuf/Bitmap等请[自定义转换器](converter-customize.md#_3)
--------------------------------------------------------------------------------
/sample/src/main/res/layout/activity_main.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
11 |
12 |
13 |
17 |
18 |
25 |
26 |
33 |
34 |
35 |
36 |
43 |
44 |
45 |
46 |
47 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/ResponseException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | @file:Suppress("MemberVisibilityCanBePrivate")
26 |
27 | package com.drake.net.exception
28 |
29 | import com.drake.net.compatible.*
30 | import okhttp3.Response
31 |
32 | /**
33 | * 状态码在200..299, 但是返回数据不符合业务要求可以抛出该异常
34 | * @param response 响应信息
35 | * @param message 错误描述信息
36 | * @param cause 错误原因
37 | * @param tag 可携带任意对象, 一般用于在转换器/拦截器中添加然后传递给错误处理器去使用判断
38 | */
39 | class ResponseException(
40 | response: Response,
41 | message: String? = null,
42 | cause: Throwable? = null,
43 | var tag: Any? = null
44 | ) : HttpResponseException(response, message, cause)
--------------------------------------------------------------------------------
/net/src/main/res/drawable/ic_timing.xml:
--------------------------------------------------------------------------------
1 |
24 |
25 |
30 |
33 |
36 |
37 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/SuperIntervalFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import android.view.Menu
4 | import android.view.MenuInflater
5 | import android.view.MenuItem
6 | import com.drake.engine.base.EngineFragment
7 | import com.drake.net.sample.R
8 | import com.drake.net.sample.databinding.FragmentSuperIntervalBinding
9 | import com.drake.net.time.Interval
10 | import java.util.concurrent.TimeUnit
11 |
12 |
13 | class SuperIntervalFragment :
14 | EngineFragment(R.layout.fragment_super_interval) {
15 |
16 | private lateinit var interval: Interval // 轮询器
17 |
18 | override fun initView() {
19 | setHasOptionsMenu(true)
20 | // 自定义计数器个数的轮询器, 当[start]]比[end]值大, 且end不等于-1时, 即为倒计时
21 | interval = Interval(0, 1, TimeUnit.SECONDS, 10).life(this)
22 | // interval = Interval(1, TimeUnit.SECONDS) // 每秒回调一次, 不会自动结束
23 | interval.subscribe {
24 | binding.tvFragment.text = it.toString()
25 | }.finish {
26 | binding.tvFragment.text = "计时完成"
27 | }.start()
28 | }
29 |
30 | override fun initData() {
31 | }
32 |
33 | override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
34 | super.onCreateOptionsMenu(menu, inflater)
35 | inflater.inflate(R.menu.menu_interval, menu)
36 | }
37 |
38 | override fun onOptionsItemSelected(item: MenuItem): Boolean {
39 | when (item.itemId) {
40 | R.id.start -> interval.start()
41 | R.id.pause -> interval.pause()
42 | R.id.resume -> interval.resume()
43 | R.id.reset -> interval.reset()
44 | R.id.switch_interval -> interval.switch()
45 | R.id.stop -> interval.stop()
46 | R.id.cancel -> interval.cancel()
47 | }
48 | return super.onOptionsItemSelected(item)
49 | }
50 |
51 | }
52 |
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/HttpResponseException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import com.drake.net.compatible.request
28 | import okhttp3.Response
29 |
30 | /**
31 | * 该类表示Http请求在服务器响应成功后失败
32 | * @param response 响应信息
33 | * @param message 错误描述信息
34 | * @param cause 错误原因
35 | *
36 | * @see ResponseException HttpStatusCode 200...299
37 | * @see RequestParamsException HttpStatusCode 400...499
38 | * @see ServerResponseException HttpStatusCode 500...599
39 | */
40 | open class HttpResponseException(
41 | open val response: Response,
42 | message: String? = null,
43 | cause: Throwable? = null
44 | ) : NetException(response.request, message, cause)
--------------------------------------------------------------------------------
/sample/src/main/res/layout/fragment_unique_request.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 |
6 |
7 |
11 |
12 |
20 |
21 |
31 |
32 |
42 |
43 |
44 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/interceptor/EncryptDataInterceptor.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.interceptor
2 |
3 | import com.drake.net.request.MediaConst
4 | import com.drake.net.sample.utils.AESUtils
5 | import okhttp3.Interceptor
6 | import okhttp3.RequestBody.Companion.toRequestBody
7 | import okhttp3.Response
8 | import okhttp3.ResponseBody.Companion.toResponseBody
9 | import okio.Buffer
10 |
11 | /**
12 | * 演示如何加密请求参数/解密响应数据
13 | */
14 | class EncryptDataInterceptor : Interceptor {
15 | override fun intercept(chain: Interceptor.Chain): Response {
16 | var request = chain.request()
17 |
18 | // 加密, 仅加密 POST请求/JSON参数类型
19 | if (request.method == "POST" && request.header("Content-Type") == MediaConst.JSON.toString()) {
20 | val body = request.body
21 | if (body != null) {
22 | val buff = Buffer()
23 | body.writeTo(buff)
24 | val json = buff.readUtf8()
25 | if (json.isNotBlank()) {
26 | val encryptJson = AESUtils.encrypt(json)
27 | val newBody = encryptJson.toRequestBody(MediaConst.JSON)
28 | request = request.newBuilder().post(newBody).build()
29 | }
30 | }
31 | }
32 |
33 | var response = chain.proceed(request)
34 |
35 | // 解密, 仅解密JSON响应类型
36 | if (response.header("Content-Type") == MediaConst.JSON.toString()) {
37 | val body = response.body
38 | if (body != null) {
39 | val json = body.string()
40 | if (json.isNotBlank()) {
41 | val decryptJson = AESUtils.decrypt(json)
42 | val requestBody = decryptJson.toResponseBody(MediaConst.JSON)
43 | response = response.newBuilder().body(requestBody).build()
44 | }
45 | }
46 | }
47 |
48 | return response
49 | }
50 | }
--------------------------------------------------------------------------------
/sample/src/main/res/layout/layout_drawer_nav_header.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
5 |
6 |
7 |
10 |
11 |
21 |
22 |
26 |
27 |
35 |
36 |
44 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/docs/api/scripts/clipboard.js:
--------------------------------------------------------------------------------
1 | window.addEventListener('load', () => {
2 | document.querySelectorAll('span.copy-icon').forEach(element => {
3 | element.addEventListener('click', (el) => copyElementsContentToClipboard(element));
4 | })
5 |
6 | document.querySelectorAll('span.anchor-icon').forEach(element => {
7 | element.addEventListener('click', (el) => {
8 | if(element.hasAttribute('pointing-to')){
9 | const location = hrefWithoutCurrentlyUsedAnchor() + '#' + element.getAttribute('pointing-to')
10 | copyTextToClipboard(element, location)
11 | }
12 | });
13 | })
14 | })
15 |
16 | const copyElementsContentToClipboard = (element) => {
17 | const selection = window.getSelection();
18 | const range = document.createRange();
19 | range.selectNodeContents(element.parentNode.parentNode);
20 | selection.removeAllRanges();
21 | selection.addRange(range);
22 |
23 | copyAndShowPopup(element, () => selection.removeAllRanges())
24 | }
25 |
26 | const copyTextToClipboard = (element, text) => {
27 | var textarea = document.createElement("textarea");
28 | textarea.textContent = text;
29 | textarea.style.position = "fixed";
30 | document.body.appendChild(textarea);
31 | textarea.select();
32 |
33 | copyAndShowPopup(element, () => document.body.removeChild(textarea))
34 | }
35 |
36 | const copyAndShowPopup = (element, after) => {
37 | try {
38 | document.execCommand('copy');
39 | element.nextElementSibling.classList.add('active-popup');
40 | setTimeout(() => {
41 | element.nextElementSibling.classList.remove('active-popup');
42 | }, 1200);
43 | } catch (e) {
44 | console.error('Failed to write to clipboard:', e)
45 | }
46 | finally {
47 | if(after) after()
48 | }
49 | }
50 |
51 | const hrefWithoutCurrentlyUsedAnchor = () => window.location.href.split('#')[0]
52 |
53 |
--------------------------------------------------------------------------------
/docs/interceptor.md:
--------------------------------------------------------------------------------
1 | 根据使用场景选择
2 |
3 | 1. `Interceptor`: 支持三方OkHttp拦截器组件, 允许修改请求/响应信息, 可以转发请求
4 | 2. `RequestInterceptor`: Net独有的轻量级拦截器, 允许修改全局请求头/请求参数, 无法转发请求
5 |
6 |
7 | !!! Failure "禁止无效封装"
8 | 不应为全局参数/加密等封装请求方法, 应自定义拦截器/转换器来实现, [常见拦截器示例](https://github.com/liangjingkanji/Net/tree/master/sample/src/main/java/com/drake/net/sample/interceptor)
9 |
10 |
11 |
12 | ## 拦截器
13 |
14 | 添加拦截器
15 |
16 | ```kotlin
17 | NetConfig.initialize(Api.HOST, this) {
18 | addInterceptor(RefreshTokenInterceptor())
19 | }
20 | ```
21 |
22 | 客户端token自动续期示例
23 |
24 | ```kotlin
25 | class RefreshTokenInterceptor : Interceptor {
26 | override fun intercept(chain: Interceptor.Chain): Response {
27 | val request = chain.request()
28 | val response = chain.proceed(request)
29 | return synchronized(RefreshTokenInterceptor::class.java) {
30 | if (response.code == 401 && UserConfig.isLogin && !request.url.encodedPath.contains(Api.Token)) {
31 | val tokenInfo = Net.get(Api.Token).execute() // 同步请求token
32 | if (tokenInfo.isExpired) {
33 | // token过期抛出异常, 由全局错误处理器处理, 在其中可以跳转到登陆界面提示用户重新登陆
34 | throw ResponseException(response, "登录状态失效")
35 | } else {
36 | UserConfig.token = tokenInfo.token
37 | }
38 | chain.proceed(request)
39 | } else {
40 | response
41 | }
42 | }
43 | }
44 | }
45 | ```
46 |
47 | ## 请求拦截器
48 |
49 | 轻量级拦截器(`RequestInterceptor`), 其Api更适合添加全局请求头/参数
50 |
51 | ```kotlin
52 | NetConfig.initialize(Api.HOST, this) {
53 | setRequestInterceptor(object : RequestInterceptor {
54 | override fun interceptor(request: BaseRequest) {
55 | request.param("client", "Net")
56 | request.setHeader("token", "123456")
57 | }
58 | })
59 | }
60 | ```
61 |
62 | 可以看出`setRequestInterceptor`仅支持一个, `addInterceptor`支持多个拦截器
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/utils/TipUtils.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.utils
26 |
27 | import android.annotation.SuppressLint
28 | import android.widget.Toast
29 | import com.drake.net.NetConfig
30 |
31 | object TipUtils {
32 |
33 | private var toast: Toast? = null
34 |
35 | /**
36 | * 重复显示不会覆盖, 可以在子线程显示
37 | * 本方法会导致报内存泄露, 这是因为为了避免吐司反复显示导致重叠会长期持有Toast引用来保持单例导致, 可以无视或者自己实现吐司
38 | */
39 | @SuppressLint("ShowToast")
40 | @JvmStatic
41 | fun toast(message: String?) {
42 | message ?: return
43 | runMain {
44 | toast?.cancel()
45 | toast = Toast.makeText(NetConfig.app, message, Toast.LENGTH_SHORT)
46 | toast?.show()
47 | }
48 | }
49 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/fragment/HttpsCertificateFragment.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.fragment
2 |
3 | import android.view.View
4 | import com.drake.engine.base.EngineFragment
5 | import com.drake.net.Get
6 | import com.drake.net.okhttp.setSSLCertificate
7 | import com.drake.net.okhttp.trustSSLCertificate
8 | import com.drake.net.sample.R
9 | import com.drake.net.sample.databinding.FragmentHttpsCertificateBinding
10 | import com.drake.net.utils.scopeNetLife
11 | import com.drake.tooltip.toast
12 | import okhttp3.OkHttpClient
13 |
14 | class HttpsCertificateFragment :
15 | EngineFragment(R.layout.fragment_https_certificate) {
16 |
17 | override fun initView() {
18 | binding.btnTrustCertificate.setOnClickListener(this::trustAllCertificate)
19 | binding.btnImportCertificate.setOnClickListener(this::importCertificate)
20 | }
21 |
22 | override fun initData() {
23 | }
24 |
25 | /**
26 | * 信任全部证书
27 | * 大部分情况下还是建议在Application中配置一次全局的证书
28 | */
29 | private fun trustAllCertificate(view: View) {
30 | scopeNetLife {
31 | binding.tvResponse.text = Get("https://github.com/liangjingkanji/Net/") {
32 | // 构建新的客户端
33 | okHttpClient = OkHttpClient.Builder().trustSSLCertificate().build()
34 | }.await()
35 | }
36 | }
37 |
38 | /**
39 | * 导入私有证书
40 | */
41 | private fun importCertificate(view: View) {
42 | scopeNetLife {
43 | Get("https://github.com/liangjingkanji/Net/") {
44 | // 使用现在客户端
45 | setClient {
46 | val privateCertificate = resources.assets.open("https.certificate")
47 | setSSLCertificate(privateCertificate)
48 | }
49 | }.await()
50 | }.catch {
51 | toast("作者没有证书, 只是演示代码, O(∩_∩)O哈哈~")
52 | }
53 | }
54 |
55 | }
--------------------------------------------------------------------------------
/net/src/main/java/com/drake/net/exception/NoCacheException.kt:
--------------------------------------------------------------------------------
1 | /*
2 | * MIT License
3 | *
4 | * Copyright (c) 2023 劉強東 https://github.com/liangjingkanji
5 | *
6 | * Permission is hereby granted, free of charge, to any person obtaining a copy
7 | * of this software and associated documentation files (the "Software"), to deal
8 | * in the Software without restriction, including without limitation the rights
9 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 | * copies of the Software, and to permit persons to whom the Software is
11 | * furnished to do so, subject to the following conditions:
12 | *
13 | * The above copyright notice and this permission notice shall be included in all
14 | * copies or substantial portions of the Software.
15 | *
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 | * SOFTWARE.
23 | */
24 |
25 | package com.drake.net.exception
26 |
27 | import com.drake.net.cache.ForceCache
28 | import okhttp3.Request
29 |
30 | /**
31 | * 读取缓存失败
32 | * 仅当设置强制缓存模式[com.drake.net.cache.CacheMode.READ]和[com.drake.net.cache.CacheMode.REQUEST_THEN_READ]才会发生此异常
33 | * @param request 请求信息
34 | * @param message 错误描述信息
35 | * @param cause 错误原因
36 | */
37 | class NoCacheException(
38 | request: Request,
39 | message: String? = null,
40 | cause: Throwable? = null
41 | ) : NetException(request, message, cause) {
42 |
43 | override fun getLocalizedMessage(): String {
44 | return "cacheKey = " + ForceCache.key(request) + " " + super.getLocalizedMessage()
45 | }
46 | }
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/ui/activity/MainActivity.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.ui.activity
2 |
3 | import androidx.core.view.GravityCompat
4 | import androidx.navigation.findNavController
5 | import androidx.navigation.fragment.FragmentNavigator
6 | import androidx.navigation.ui.AppBarConfiguration
7 | import androidx.navigation.ui.setupWithNavController
8 | import com.bumptech.glide.Glide
9 | import com.drake.engine.base.EngineActivity
10 | import com.drake.net.sample.R
11 | import com.drake.net.sample.databinding.ActivityMainBinding
12 | import com.drake.statusbar.immersive
13 |
14 | /**
15 | * 以下代码设置导航, 和框架本身无关无需关心, 请查看[com.drake.net.sample.ui.fragment]内的Fragment
16 | */
17 | class MainActivity : EngineActivity(R.layout.activity_main) {
18 |
19 | override fun initView() {
20 | immersive(binding.toolbar, true)
21 | setSupportActionBar(binding.toolbar)
22 | val navController = findNavController(R.id.nav)
23 |
24 | Glide.with(this)
25 | .load("https://avatars.githubusercontent.com/u/21078112?v=4")
26 | .circleCrop()
27 | .into(binding.drawerNav.getHeaderView(0).findViewById(R.id.iv))
28 |
29 | binding.toolbar.setupWithNavController(
30 | navController,
31 | AppBarConfiguration(binding.drawerNav.menu, binding.drawer)
32 | )
33 | navController.addOnDestinationChangedListener { _, destination, _ ->
34 | binding.toolbar.subtitle =
35 | (destination as FragmentNavigator.Destination).className.substringAfterLast('.')
36 | }
37 | binding.drawerNav.setupWithNavController(navController)
38 | }
39 |
40 | override fun initData() {
41 | }
42 |
43 | override fun onBackPressed() {
44 | if (binding.drawer.isDrawerOpen(GravityCompat.START)) binding.drawer.closeDrawers() else super.onBackPressed()
45 | }
46 | }
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
--------------------------------------------------------------------------------
18 |
--------------------------------------------------------------------------------
/sample/src/main/java/com/drake/net/sample/converter/GsonConverter.kt:
--------------------------------------------------------------------------------
1 | package com.drake.net.sample.converter
2 |
3 | import com.drake.net.convert.JSONConvert
4 | import com.google.gson.GsonBuilder
5 | import org.json.JSONObject
6 | import java.lang.reflect.Type
7 |
8 | class GsonConverter : JSONConvert(code = "errorCode", message = "errorMsg") {
9 | companion object {
10 | private val gson = GsonBuilder().serializeNulls().create()
11 | }
12 |
13 | override fun