PlainApp
Referência da API

Explorador de base de dados

Explorar a base de dados da aplicação através de operações estruturadas, não SQL arbitrário. Todas as operações da base de dados exigem o Modo de Programador; caso contrário devolvem “No permission: developer mode is disabled”.

Definições de 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

Operações

mutation

createDbTableRow

Inserir uma linha a partir de um objeto JSON; requer o modo de desenvolvedor. Outros tipos são rejeitados; linhas inválidas retornam false.

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

deleteDbTableRows

Eliminar as linhas selecionadas da tabela pelos valores de identidade; exige o Modo de Programador.

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

dbPath

Consultar o caminho da base de dados SQLite da aplicação; exige o Modo de Programador.

graphql
query dbPath {
  dbPath
}
query

dbTableRowCount

Contar as linhas de uma tabela; exige o Modo de Programador.

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

dbTableRows

Ler linhas paginadas como objetos JSON; requer o modo de desenvolvedor. Os valores continuam como strings ou null; JSON.parse não é necessário.

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

dbTables

Listar os nomes das tabelas da base de dados da aplicação; exige o Modo de Programador.

graphql
query dbTables {
  dbTables { name createSql }
}