SuperApp:Cache

Use as APIs JavaScript do WVStorage para armazenar, recuperar, remover e limpar dados em cache em seus aplicativos HTML5 e miniapps.

O WVStorage integra a ponte JavaScript WindVane e fornece armazenamento persistente de chave-valor para cache local. Todas as APIs seguem o mesmo padrão de chamada:

window.WindVane.call('WVStorage', '<method>', params, successCallback, failureCallback)

WVStorage.setItem

WVStorage.setItem(key: string, value: string)

Armazena um valor do tipo string no cache local sob a chave especificada. Se a chave já existir, seu valor será substituído.

Parâmetros de entrada

• [string] key (obrigatório): Chave da entrada de cache.

• [string] value (obrigatório): Valor a ser armazenado.

Parâmetros de callback

Em caso de sucesso:

• Nenhum parâmetro de callback.

Em caso de falha:

• [string] msg: Mensagem de erro.

var params = {
  key: 'key',
  value: 'value'
};

window.WindVane.call('WVStorage', 'setItem', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVStorage.getItem

WVStorage.getItem(key: string): string

Recupera o valor em cache associado à chave especificada.

Parâmetros de entrada

• [string] key (obrigatório): Chave da entrada de cache.

Parâmetros de callback

Em caso de sucesso:

• [string] data: Valor associado à chave.

Em caso de falha:

• [string] msg: Mensagem de erro.

var params = {
  key: 'key'
};

window.WindVane.call('WVStorage', 'getItem', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVStorage.removeItem

WVStorage.removeItem(key: string)

Remove a entrada de cache correspondente à chave especificada.

Parâmetros de entrada

• [string] key (obrigatório): Chave da entrada de cache a ser removida.

Parâmetros de callback

Em caso de sucesso:

• Nenhum parâmetro de callback.

Em caso de falha:

• [string] msg: Mensagem de erro.

var params = {
  key: 'key'
};

window.WindVane.call('WVStorage', 'removeItem', params, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVStorage.clearStorage

WVStorage.clearStorage()

Limpa todas as entradas do cache local de forma assíncrona. Use este método para evitar o bloqueio do aplicativo durante operações de cache.

Parâmetros de entrada

• Nenhum parâmetro de entrada.

Parâmetros de callback

Em caso de sucesso:

• Nenhum parâmetro de callback.

Em caso de falha:

• [string] msg: Mensagem de erro.

window.WindVane.call('WVStorage', 'clearStorage', {}, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVStorage.clearStorageSync

WVStorage.clearStorageSync()

Limpa todas as entradas do cache local de forma síncrona. A chamada bloqueia a execução até que a operação seja concluída.

Parâmetros de entrada

• Nenhum parâmetro de entrada.

Parâmetros de callback

Em caso de sucesso:

• Nenhum parâmetro de callback.

Em caso de falha:

• [string] msg: Mensagem de erro.

window.WindVane.call('WVStorage', 'clearStorageSync', {}, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});