Armazenamento de dados da plataforma de desenvolvimento móvel YonBuilder
Os desenvolvedores da plataforma de desenvolvimento móvel YonBuilder fornecem uma variedade de soluções de armazenamento de dados locais, incluindo armazenamento local, dados de preferência, arquivos e bancos de dados, para atender às necessidades de armazenamento de dados de diferentes escalas. Entre eles, armazenamento local e dados de preferência são geralmente usados para armazenar dados relativamente simples e de pequena escala, enquanto arquivos e bancos de dados são usados principalmente para armazenar grandes quantidades de dados e são fáceis de gerenciar.
1. Armazenamento local
A plataforma de desenvolvimento móvel YonBuilder encapsula o armazenamento local de html5, que é mais conveniente para armazenamento. O método setStorage do objeto $api pode não apenas armazenar strings, mas também armazenar objetos JSON diretamente, e getStorage também pode obter objetos JSON diretamente. O uso é o seguinte:
var key = 'user';
var user = {};
user.name = 'kenny';
user.email = '[email protected]';
$api.setStorage(key, user);
user = $api.getStorage(key);2. Dados de preferência
É adequado para armazenar uma pequena quantidade de dados de preferência e geralmente é usado para salvar alguns valores de estado, etc. Não é recomendado armazenar uma grande quantidade de dados dessa maneira. O objeto api fornece os métodos setPrefs, getPrefs e removePrefs, e os parâmetros são passados como pares chave-valor para configuração, obtenção e remoção, como registrar se o aplicativo foi iniciado pela primeira vez:
api.setPrefs({
firstLaunch:false
});Para outros métodos, consulte a documentação do objeto API.
3. Documentação
(1) Método de objeto da API
Os desenvolvedores da plataforma de desenvolvimento móvel YonBuilder fornecem APIs de operação relacionadas a arquivos e pastas, incluindo criação, movimentação, exclusão de arquivos e pastas, etc., bem como operações de leitura e gravação em conteúdo de texto. Entre eles, o objeto api fornece os métodos básicos readFile e writeFile e oferece suporte às operações de leitura e gravação de todo o conteúdo do arquivo. O código de exemplo para ler e gravar arquivos é o seguinte:
api.readFile({
path: 'fs://a.txt'
}, function(ret, err){
if(ret.status){
var data = ret.data;
}
});api.writeFile({
path: 'fs://a.txt',
data:'writeFile测试内容'
}, function(ret, err){
if(ret.status){
api.alert({msg:'写入文件成功'});
} else{
api.alert({msg:err.msg});
}
});(2) método de objeto fs
Se quiser usar uma API de operação de arquivo mais rica, você precisa introduzir o plug-in nativo fs, que define as operações relacionadas de arquivos e pastas em detalhes e oferece suporte à leitura e gravação de conteúdo de texto em locais especificados. O código de exemplo para gravar arquivos é o seguinte:
var fs = api.require('fs');
fs.open({
path:'fs://test.txt',
flags:'read_write'
},function(ret, err) {
if (ret.status) {
var fd = ret.fd; //fd为文件句柄
fs.write({
fd:fd,
data:'text',
offset:0
},function(ret,err){
if (ret.status) {
api.alert({msg:'write操作成功'});
} else{
api.alert({msg:err.msg});
}
});
}
});Para outros métodos, consulte a documentação do plug-in nativo fs.
4. Banco de dados
Os desenvolvedores da plataforma de desenvolvimento móvel YonBuilder fornecem uma interface para operar bancos de dados locais, mas os desenvolvedores precisam estar familiarizados com instruções SQL básicas, como criar tabelas, inserir e atualizar dados e obter dados.
O plug-in nativo db fornece APIs de operação relacionadas ao banco de dados, consulte a documentação do plug-in nativo db para obter detalhes. Alguns códigos de amostra são os seguintes:
Crie uma tabela chamada Pessoas:
var db = api.require('db');
var sql = 'CREATE TABLE Persons(Id_P int, LastName varchar(255), FirstName varchar(255),
Address varchar(255), City varchar(255))';
db.executeSql({
name: 'databaseName',
sql: sql
}, function(ret, err){
if(ret.status){
api.alert({msg:'创建表成功'});
} else{
api.alert({msg:err.msg});
}
});Consulte os dados da tabela Persons:
var db = api.require('db');
var sql = 'SELECT * FROM Persons';
db.selectSql({
name:'databaseName',
sql: sql
}, function(ret, err){
if(ret.status){
var data = ret.data;
} else{
};
});