すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:キャッシュ

最終更新日:Jan 17, 2025

キャッシュ機構は、appId と userId に基づくローカルキャッシュであるため、キャッシュを使用する前に MPLogger.setUserId(String userId); メソッドを使用してホワイトリスト ID を設定する必要があります。

my.setStorage

この API は、指定されたキーのデータをローカルキャッシュに保存するために使用されます。キーに対応する元のデータは上書きされます。

説明
  • mPaaS 10.1.32 以降のバージョンでこのインターフェイスがサポートされています。

  • これは非同期インターフェイスです。

  • 埋め込み WebView のストレージは、ミニプログラムのストレージから分離してサポートされており、埋め込み WebView に指定されたキーで保存されたデータは、ミニプログラム自体の同じキーに対応するデータを上書きしません。

パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

data

Object/String

はい

キャッシュするデータ

success

関数

いいえ

呼び出し成功時のコールバック関数

fail

関数

いいえ

呼び出し失敗時のコールバック関数

complete

関数

いいえ

呼び出し終了時のコールバック関数(呼び出しの成功または失敗に関係なく実行されます)

コードサンプル

my.setStorage({
  key: 'currentCity',
  data: {
    cityName: 'Hangzhou',
    adCode: '330100',
    spell: ' hangzhou',
  },
  success: function() {
    my.alert({content: '書き込み成功'});
  }
});
説明

単一のデータを文字列に変換した後、文字列の最大長は 200 × 1024 文字です。同じ mPaaS ミニプログラムユーザーの場合、単一のミニプログラムの合計キャッシュ制限は 10 MB です。

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.setStorageSync

この API は、指定されたキーのデータをローカルキャッシュに同期的に保存するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは同期インターフェイスです。

パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

data

Object/String

はい

キャッシュするデータ

コードサンプル

my.setStorageSync({
  key: 'currentCity',
  data: {
    cityName: 'Hangzhou',
    adCode: '330100',
    spell: ' hangzhou',
  }
});

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.getStorage

この API は、キャッシュデータを取得するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは非同期インターフェイスです。

  • 埋め込み WebView 内部キャッシュとミニプログラムキャッシュの分離をサポートします。埋め込み WebView の指定されたキーのキャッシュを取得しても、ミニプログラムの同じキーのキャッシュデータは同時に返されません。

パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

success

関数

いいえ

呼び出し成功時のコールバック関数

fail

関数

いいえ

呼び出し失敗時のコールバック関数

complete

関数

いいえ

呼び出し終了時のコールバック関数(呼び出しの成功または失敗に関係なく実行されます)

success の戻り値

名前

タイプ

説明

data

Object/String

キーに対応するコンテンツ

コードサンプル

my.getStorage({
  key: 'currentCity',
  success: function(res) {
    my.alert({content: '取得成功: ' + res.data.cityName});
  },
  fail: function(res){
    my.alert({content: res.errorMessage});
  }
});

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.getStorageSync

この API は、キャッシュデータを同期的に取得するために使用されます。

説明
  • mPaaS 10.1.32 以降のバージョンでこのインターフェイスがサポートされています。

  • これは非同期インターフェイスです。

入力パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

success 戻り値

名前

タイプ

説明

data

Object/String

キーに対応するコンテンツ

コードサンプル

let res = my.getStorageSync({ key: 'currentCity' });
 my.alert({
    content: JSON.stringify(res.data),
 });

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.removeStorage

この API は、キャッシュデータを削除するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは非同期インターフェイスです。

  • 埋め込み WebView の保存データを削除する場合、現在のミニプログラムの保存データは削除されません。

パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

success

関数

いいえ

呼び出し成功時のコールバック関数

fail

関数

いいえ

呼び出し失敗時のコールバック関数

complete

関数

いいえ

呼び出し終了時のコールバック関数(呼び出しの成功または失敗に関係なく実行されます)

コードサンプル

my.removeStorage({
  key: 'currentCity',
  success: function(){
    my.alert({content: '削除成功'});
  }
});

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.removeStorageSync

この API は、キャッシュデータを同期的に削除するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは同期インターフェイスです。

パラメーター

名前

タイプ

必須

説明

key

String

はい

キャッシュデータのキー

コードサンプル

my.removeStorageSync({
  key: 'currentCity',
});

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.clearStorage

この API は、ローカルデータキャッシュをクリアするために使用されます。

説明
  • mPaaS 10.1.32 以降のバージョンでこのインターフェイスがサポートされています。

  • これは非同期インターフェイスです。

  • 埋め込み WebView のストレージをクリアする場合、現在のミニプログラム自体のストレージデータは同時にクリアされません。

コードサンプル

my.clearStorage()

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.clearStorageSync

この API は、ローカルデータキャッシュを同期的にクリアするために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは同期インターフェイスです。

コードサンプル

my.clearStorageSync()

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.getStorageInfo

この API は、現在のストレージに関する情報を非同期で取得するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは非同期インターフェイスです。

  • 埋め込み WebView の現在のストレージに関する情報を取得しても、現在のミニプログラムのストレージに関する情報は取得されません。

パラメーター

名前

タイプ

必須

説明

success

関数

いいえ

呼び出し成功時のコールバック関数

fail

関数

いいえ

呼び出し失敗時のコールバック関数

complete

関数

いいえ

呼び出し終了時のコールバック関数(呼び出しの成功または失敗に関係なく実行されます)

戻り値 success

名前

タイプ

説明

keys

String 配列

現在のストレージ内のすべてのキー

currentSize

Number

現在占有されているスペースのサイズ(KB 単位)

limitSize

Number

スペースのサイズ制限(KB 単位)

コードサンプル

my.getStorageInfo({
  success: function(res) {
    console.log(res.keys)
    console.log(res.currentSize)
    console.log(res.limitSize)
  }
})

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。

my.getStorageInfoSync

この API は、現在のストレージに関する情報を同期的に取得するために使用されます。

説明
  • このインターフェイスは mPaaS 10.1.32 以降でサポートされています。

  • これは同期インターフェイスです。

戻り値 success

名前

タイプ

説明

keys

String 配列

現在のストレージ内のすべてのキー

currentSize

Number

現在占有されているスペースのサイズ(KB 単位)

limitSize

Number

スペースのサイズ制限(KB 単位)

コードサンプル

var res = my.getStorageInfoSync()
console.log(res.keys)
console.log(res.currentSize)
console.log(res.limitSize)

その他の情報

  • キャッシュデータは暗号化されてローカルに保存され、API を介して読み取られる際に自動的に復号化されて返されます。

  • iOS クライアントでは iTunes バックアップがサポートされています。