Riferimento API

Esplora database

Esplorare il database dell’applicazione tramite operazioni strutturate, non SQL arbitrario. Tutte le operazioni sul database richiedono la modalità sviluppatore; altrimenti restituiscono “No permission: developer mode is disabled”.

Definizioni di tipo

graphql
type Mutation {
  createDbTableRow(table: String!, row: JSON!): Boolean!
  deleteDbTableRows(table: String!, ids: [String!]!): Boolean!
}

type Query {
  dbPath: String!
  dbTableRowCount(table: String!): Long!
  dbTableRows(table: String!, offset: Int!, limit: Int!): [JSON!]!
  dbTables: [DbTable!]!
}

enum DbColumnType {
	TEXT
	INTEGER
	REAL
	BLOB
	NUMERIC
	UNKNOWN
}

type DbTable {
	name: String!
	createSql: String!
	columns: [DbTableColumn!]!
}

type DbTableColumn {
	name: String!
	dataType: DbColumnType!
	notNull: Boolean!
	defaultValue: String
	primaryKey: Boolean!
}

scalar JSON

scalar Long

Operazioni

mutation

createDbTableRow

Inserire una riga da un oggetto JSON; richiede la modalità sviluppatore. Gli altri tipi vengono rifiutati; le righe non valide restituiscono false.

graphql
mutation createDbTableRow($table: String!, $row: JSON!) {
  createDbTableRow(table: $table, row: $row)
}
mutation

deleteDbTableRows

Eliminare le righe selezionate della tabella tramite i valori di identità; richiede la modalità sviluppatore.

graphql
mutation deleteDbTableRows($table: String!, $ids: [String!]!) {
  deleteDbTableRows(table: $table, ids: $ids)
}
query

dbPath

Leggere il percorso del database SQLite dell’applicazione; richiede la modalità sviluppatore.

graphql
query dbPath {
  dbPath
}
query

dbTableRowCount

Contare le righe di una tabella; richiede la modalità sviluppatore.

graphql
query dbTableRowCount($table: String!) {
  dbTableRowCount(table: $table)
}
query

dbTableRows

Leggere righe paginate come oggetti JSON; richiede la modalità sviluppatore. I valori restano stringhe o null; JSON.parse non serve.

graphql
query dbTableRows($table: String!, $offset: Int!, $limit: Int!) {
  dbTableRows(table: $table, offset: $offset, limit: $limit)
}
query

dbTables

Elencare i nomi delle tabelle nel database dell’applicazione; richiede la modalità sviluppatore.

graphql
query dbTables {
  dbTables { name createSql }
}