HarmonyOS オープンソースサードパーティコンポーネント

[[414837]]

詳細については、以下をご覧ください。

51CTOとHuaweiが共同で構築したHarmonyOSテクノロジーコミュニティ。

https://harmonyos..com

背景

Kalle は、HTTP 標準プロトコルに準拠し、同期リクエストと非同期リクエストの両方をサポートする HttpClient です。

特性

GET、HEAD、OPTIONS、TRACE、POST、PUT、PATCH、および DELETE リクエストメソッドをサポートします。
プレーン文字列フォームやファイル付きフォーム（複数のファイルや大きなファイルを含む）などのフォーム送信。
ファイルや文字列 (JSON、XML、プレーン文字列) などの RequestBody をカスタマイズします。
SSLはサポートされていますが、証明書はデフォルトでは検証されません。開発者は証明書をカスタマイズできます。
9 つのキャッシュモードが利用可能で、デフォルト設定では AES アルゴリズムを使用してキャッシュデータを暗号化します。
自動 Cookie 管理、HTTP プロトコルに準拠し、ブラウザと同じ原則を実装します。
リクエストは、開始前や進行中など、いつでもキャンセルできます。
JavaBeans を直接要求するグローバルデシリアライゼーションコンバーター。
インターセプターに基づくインテリジェントなリダイレクトとインテリジェントな再試行
開発者は、ログの印刷、ログインの再試行、パラメータの署名などのインターセプターを追加できます。
ネットワーク可用性キャッシュ方式。URLConnection、OkHttp、ApacheHttpClient などの接続層を動的に置き換えることができます。

コンポーネント例の効果

リクエストリスト情報

Kalle.get(UrlConfig.GET_LIST)
                .param( "ページ番号" , PAGE_NUMBER)
 .param( "ページサイズ" , PAGE_SIZE)
 .tag(これ)
 .perform(新しい SimpleCallback<NewsWrapper>(this) {
 @オーバーライド
パブリックvoid onResponse(SimpleResponse<NewsWrapper, String> レスポンス) {
 if (response.isSucceed()) {
 NewsWrapper ラッパー = response.succeed();
 mDataList = wrapper.getDataList();
 mPage = wrapper.getPage();
                            ListContainer listContainer = (ListContainer) findComponentById(ResourceTable.Id_normal_list_container);
 MainItemProvider の sampleItemProvider = 新しい MainItemProvider(mDataList、NormalAbilitySlice.this);
                            listContainer.setItemProvider(sampleItemProvider);
 }それ以外{
新しい ToastDialog(NormalAbilitySlice.this)
 .setText(UrlConfig.GET_LIST + " 応答に失敗しました: " + response.failed())
 .setAlignment(レイアウト配置.CENTER)
 。見せる（）;
 }
 }
 });

ファイルをアップロード

Kalle.post(UrlConfig.UPLOAD_BODY_FILE)
 .urlParam( "ファイル名" , file.getName())
 .body(新しいファイルボディ(ファイル))
 .tag(これ)
 .perform(新しいDialogCallback<BodyInfo>(this) {
 @オーバーライド
パブリックvoid onResponse(SimpleResponse<BodyInfo, String> レスポンス) {
 if (response.isSucceed()) {
 bodyItems = null ;
 statusBtn.setText(アップロード結果Str);
 }それ以外{
新しい ToastDialog(BodyAbilitySlice.this)
 .setText( "クリックしました:" + response.failed())
 .setAlignment(レイアウト配置.CENTER)
 。見せる（）;
 }
 }
 });

ファイルをダウンロード

Kalle.Download.get(UrlConfig.DOWNLOAD)
 .directory(AppConfig.get().PATH_APP_DOWNLOAD)
                    .fileName( "sou.apk" )
 .onProgress(新しいダウンロード.ProgressBar() {
 @オーバーライド
public void onProgress( int progress, long byteCount, long speed) は NotExistException、WrongTypeException、IOException をスローします {
 BigDecimal bg = 新しい BigDecimal(速度 / BYTE_NUMBER / BYTE_NUMBER);
文字列 speedText = bg.setScale(2, BigDecimal.ROUND_HALF_UP).toPlainString();
文字列のダウンロード速度 = resourceManager.getElement(ResourceTable.String_download_speed).getString();
 speedText = String.format(ダウンロード速度、speedText);
 viewSetProgress(進行状況、スピードテキスト);
 }
 })
 .perform(新しい DownloadCallback1(this));

使い方

構成

必要に応じてカスタマイズされた構成を作成できますが、構成項目は必須ではありません。

設定された API は次のとおりです。

プライベートvoid kalle() {
 Kalle.setConfig(KalleConfig.newBuilder()
 .connectFactory(OkHttpConnectFactory.newBuilder().build())
 .cookieStore(DBCookieStore.newBuilder(this).build())
 .cacheStore(DiskCacheStore.newBuilder(AppConfig.get().PATH_APP_CACHE).build())
 .network(新しいBroadcastNetwork(this))
 .addInterceptor(新しいログインインターセプター())
 .addInterceptor(新しいLoggerInterceptor( "KalleSample" 、 BuildConfig.DEBUG))
 .converter(新しいJsonConverter(this))
 。建てる（））;
 }

接続する

Kalleは完全に独立したネットワークライブラリであり、基盤となるHTTPプロトコル接続ライブラリの使用を制限しません。そのため、開発者はURLConnection、OkHttp、HttpClientなど、どの基盤接続ライブラリを使用するかを選択できます。コンパイル済みのKalleのサイズを縮小するため、KalleはURLConnectionをベースにしたデフォルトの基盤接続ライブラリを提供します（URLConnectionはJavaにデフォルトで含まれているため）。また、OkHttpをベースにした代替の基盤接続ライブラリも実装しています。関心のある開発者は、他のプロジェクトを参考にして独自の基盤接続ライブラリを実装することもできます。

HTTPリクエスト

HTTPリクエストは、リクエスト方法に基づいて、URLリクエストとボディリクエストの2つの主要なカテゴリに分けられます。一方はシンプルなURLのみを使用でき、もう一方はシンプルなURLだけでなく、ストリームを使用してカスタムリクエストボディを送信できます。

URL クラスのリクエストメソッド:

 GET、HEAD、OPTIONS、TRACE

Bodyクラスのリクエストメソッド:

 POST、PUT、 DELETE 、PATCH

URLベースのリクエストの場合、URLRequestを構築する必要があります。例えば、以下のコードで構築されたURLRequestは、最終的にhttp://www.example.com?name=kalle&password=123というURLになります。

 Url.Builder url = Url.newBuilder( "http://www.example.com" );
 UrlRequest urlRequest = UrlRequest.newBuilder(url, RequestMethod.GET)
 .param( "name" , kalle)
 .param( "パスワード" , 123)
 。建てる（）;

BodyRequest の使い方は基本的に URLRequest と同じです。

 Url.Builder url = Url.newBuilder( "http://www.example.com" );
 BodyRequest bodyRequest = BodyRequest.newBuilder(url, RequestMethod.GET)
 .param( "name" , kalle)
 .param( "パスワード" , 123)
 。建てる（）;

スケジュール

進行状況の監視は通常、フォームファイルのアップロードや PUSH カスタム RequestBody などの Body タイプのリクエストに使用されます。

フォームを使用する場合、特定のファイルのアップロードの進行状況を監視したり、フォーム全体の送信の進行状況を監視したりすることができます。

 FileBinary ヘッダー = 新しい FileBinary(新しいファイル ( "/sdcard/header.jpg" ))
 .onProgress(新しいOnProgress<FileBinary>() {
 @オーバーライド
パブリックvoid progress(FileBinary origin, int progress) {
 // ファイル 1 の進行状況: progress。
 }
 });
 FileBinary バナー = 新しい FileBinary(新しいファイル ( "/sdcard/banner.jpg" ))
 .onProgress(新しいOnProgress<FileBinary>() {
 @オーバーライド
パブリックvoid progress(FileBinary origin, int progress) {
 // ファイル 2 の進行状況: progress。
 }
 }); 
 
フォームボディ formBody = FormBody.newBuilder()
    .param( "名前" , "カレ" )
 .param( "年齢" , 18)
 .binary ( "ヘッダー" , ヘッダー)
 .binary ( "バナー" , バナー)
 。建てる（）;
 formBody.onProgress(新しいOnProgress<FormBody>() {
 @オーバーライド
パブリックvoid progress(FormBody origin, int progress) {
 // 全体的な進捗状況: progress.
 }
 }); 
 
 Kalle.post(UrlConfig.UPLOAD_BODY_FILE)
 .urlParam( "ファイル名" , "qq.apk" )
 .body(フォームボディ)
 。実行する（...）;

統合方法

プロジェクト自体 (entity、yoga、yoga_layout、fb) をコンパイルして、libyoga.so、libfb.so、libyogacore.so を生成します。

統合する libs フォルダーに追加し、エンティティの gradle ファイルに次のコードを追加します。

方法1:

ライブラリを使用して .har パッケージを生成し、 .har パッケージを libs フォルダーに追加します。

エントリの Gradle ファイルに次のコードを追加します。

実装 fileTree(dir: 'libs' , include:[ '*.jar' , '*.har' ])

方法2:

すべてのプロジェクト{
リポジトリ{
 mavenCentral()
 }
 }
実装'io.github.dzsf:kalle:1.0.0'  
実装「io.github.dzsf:okalle:1.0.0」

付録1：関連資料のコピー

公式IDEダウンロードリンク: https://developer.harmonyos.com/cn/develop/deveco-studio

元のコンポーネントの GitBook アドレス: https://yanzhenjie.com/Kalle

詳細については、以下をご覧ください。

51CTOとHuaweiが共同で構築したHarmonyOSテクノロジーコミュニティ。

https://harmonyos..com

DUICUO

HarmonyOS オープンソースサードパーティコンポーネント - HttpClient コンポーネント Kalle

背景

特性