Tabell
Definisjonen av én dataenhet, kolonnene og indeksene, lagret gjennom en utskiftbar databasedriver.
En Tabell definerer én dataenhet: kolonnene, indeksene som brukes til å slå opp rader, og hvilken databasedriver som lagrer den. I motsetning til et program har en Tabell ingen arbeidsflyt, ingen hendelser og ingen UI, skjemaet er hele kontrakten. Hver lesing og skriving i en Xuda-app peker til slutt på en Tabell gjennom en Get Data-, Set Data-, Batch- eller Component-datakilde.
Egenskaper
Tabellen ligger under studio_meta.parentId: "database" (eller en mappe nestet under den).
tableFields
En tabell som heter "ORD - Orders" gir hver kolonne prefiks: ORD_Id, ORD_Total, ORD_Status. Det holder feltnavn entydige når flere tabeller står i samme uttrykk, og det er konvensjonen hver eksisterende tabell i et prosjekt følger.
tableIndexes
En tabell trenger minst ett felt før den kan ha en indeks. En indeks i seg selv er bare obligatorisk for tabeller på en annen databasedriver enn den innebygde. Plattformens egen motor (@xuda.io/xuda-dbs-plugin-xuda) godtar en tabell uten indekser, men i praksis trenger hver tabell som en Component eller et set_data-program kan binde til én enkelt post en unik <TBL>_Id-indeks for å gjøre det.
Å bruke en tabell
- Les eller skriv en rad:
progDataSource.dataSourceTableIdi et Get Data-, Set Data- eller Batch-program navngir denne tabellens_id. - Bind en Component direkte: det samme paret
dataSourceTableId/dataSourceIndexId, innebygd på Component-en i stedet for et eget program. - Fra et skript:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, kalt med tabellens_id, aldri navnet.
Eksempel
Modeller kolonnene
Én tabell per enhet, ett prefiks på 3 bokstaver per tabell: STU_Student_Id, STU_Full_Name.
Legg til en unik indeks på id-en
Gi hver tabell en unik indeks på sitt <TBL>_Id-felt. Components som binder en enkelt post med nøkkel, og set_data-programmer i oppdaterings- eller slettemodus, finner målraden gjennom denne indeksen.
Pek en datakilde mot den
dataSourceTableId i et Get Data- eller Set Data-program navngir denne tabellens _id. dataSourceIndexId navngir en av id-ene i tableIndexes.
Under Database i Studio-treet legger du til en tabell, og så rader i Felt-rutenettet (id, type, påkrevd) og Indekser-rutenettet (navn, nøkler, unik). Fanen Data på samme node viser og redigerer rader direkte.
En tabell har ingen .xu-kildeform, xuda-cli-prosjekter deklarerer den som en .table.json5-fil i stedet (dette er den filen, vist som JSON).