Home / Wilkommen-en / API-en
Mit dbXwebApp können Sie auch ohne "Programmierung" beeindruckende Ergebnisse erzielen. Der Schwerpunkt von dbXwebApp liegt aber in individuellen Realisierung komplexer Anwendungen.
Damit das "Rad" nicht immer wieder neu erfunden werden muss stellt dbXwebApp eine Vielzahl von leistungsfähigen Funktionen zur Verfügung.
Die API von dbXwebApp ermöglicht einen einfachen Zugriff auf Funktionen, die Ihrerseits teilweise recht komplexe Objektstrukturen nutzen.
Für die Nutzung der API-Funktionen ist ein Wissen über die Objektstruktur, deren Funktionen und Verbindungen, nicht nötig.
Ein "simpler" Funktionsaufruf und dbXwebApp erledigt umfangreiche Aufgaben.
Alle API Funktionen lassen sich auch ohne OOP nutzen. Die API Funktionen erstellen und nutzen bei Bedarf die benötigten Objekte selbstständig.
Dadurch ist die Nutzung dieser Funktionen, auch innerhalb eigener Klassen/Objekte, sehr einfach.
Das Einmischen der Daten, alle Template Funktionen, und das Einbinden von Modulaufrufen erfolgt automatisch.
Beispiel: Wenn Sie z.B. einen Datensatz lesen, ändern und speichern wollen.
Bemerkenswert dabei ist auch, dass das System völlig unkritisch auf Veränderungen der Tabellen-Struktur reagiert.
Ein paar neue Felder in der db-Tabelle. Eine Type Veränderung. Das Löschen unnötiger Felder in der db. Alles kein Problem.
Ohne jegliche Änderung an den PHP-Sourcen.
Jedes Modul besitzt eine eindeutig benannte Funktion, welche vom System aufgerufen wird.
Alle Parameter und Formulardaten, die ein Modul benötigt, werden nicht „direkt" an diese Funktionen übergeben. Das würde Modulaufrufe auch zu sehr statisch machen.
Beispiel:
Normaler Weise" würde man in PHP eine Funktion mit seinen Parameter aufrufen. Etwas was im innerem des Systems, natürlich auch innerhalb der Module, auch gemacht wird. Bei dbXwebApp werden Parameter vom System zum Modul indirekt übergeben.
Beispiel für die klassische Nutzung von PHP Funktionen:
Beispiel für eine dbXwebApp Funktion mit indirekter Parameter Übergabe.
Der Parameter der mit dbx_get_GlobalVar abgefragt wird muss vorher natürlich gesetzt werden. Die Rückgabe des Wertes erfolgt nach einer hierarchischen Struktur.
Die Arrays $_gv und $_pv werden mit den GET und POST Werten automatisch gesetzt. Inhalte dieser Parameter/Felder werden vom System automatisch validiert.
Bei dbXwebApp werden verschiedene globale Arrays für die Parameter genutzt, die in folgender Reihenfolge verwendet werden.
Durch die Entkopplung von Anzeige/Eingabefelder und der Datenbank lassen sich sehr einfach Daten in jeglicher Form bearbeiten und anzeigen. Zum Kern von dbXwebApp gehört auch ein leistungsfähiger "Listengenerator" der insbesondere bezüglich der Gestaltung (Design) keinerlei Wünsche offen lässt.
API-en
dbXwebApp API
Mit dbXwebApp können Sie auch ohne "Programmierung" beeindruckende Ergebnisse erzielen. Der Schwerpunkt von dbXwebApp liegt aber in individuellen Realisierung komplexer Anwendungen.
Damit das "Rad" nicht immer wieder neu erfunden werden muss stellt dbXwebApp eine Vielzahl von leistungsfähigen Funktionen zur Verfügung.
Die API von dbXwebApp ermöglicht einen einfachen Zugriff auf Funktionen, die Ihrerseits teilweise recht komplexe Objektstrukturen nutzen.
Für die Nutzung der API-Funktionen ist ein Wissen über die Objektstruktur, deren Funktionen und Verbindungen, nicht nötig.
Ein "simpler" Funktionsaufruf und dbXwebApp erledigt umfangreiche Aufgaben.
Alle API Funktionen lassen sich auch ohne OOP nutzen. Die API Funktionen erstellen und nutzen bei Bedarf die benötigten Objekte selbstständig.
Dadurch ist die Nutzung dieser Funktionen, auch innerhalb eigener Klassen/Objekte, sehr einfach.
Das Einmischen der Daten, alle Template Funktionen, und das Einbinden von Modulaufrufen erfolgt automatisch.
Beispiel: Wenn Sie z.B. einen Datensatz lesen, ändern und speichern wollen.
- Datensatz lesen
$ok=dbx_Select("Tabelle","Select",Modus);
Ein einfacher Befehl, mit viel Funktion.
Das Caching System stellt nach Möglichkeit den Datensatz zur Verfügung.
Das System ermittelt selbstständig mit welchem db-Server es sich verbinden muss
Alle Berechtigungen werden überprüft.
Es wird ein Rückgabe-Datensatz zur Verfügung gestellt, der nur die Datensatz-Felder enthält für die eine Leseberechtigung besteht.
Es werden automatisch Funktionen, wie z.B das Erstellen einer Auswahlliste, ausgeführt.
Die Daten werden für die Ausgabe (Anzeigen) formatiert.
Der "Modus" kann nur intern gesetzt werden. Durch den Modus kann gesteuert werden ob die Berechtigung geprüft werden soll und ob automatische Funktionen ausgeführt werden sollen.
Modus 0 = Berechtigungen werden überprüft und automatische Funktionen werden ausgeführt und das Caching-System wird aktualisiert.
Modus -1 = Berechtigungen werden nicht überprüft (sinnvoll für interne Aktionen).
Modus -2 = Berechtigungen werden nicht geprüft, automatische Funktionen werden nicht ausgeführt.
Modus -3 = Keine Prüfung der Berechtigung, keine automatischen Funktionen, Caching-System wird nicht aktualisiert (sinnvoll z.b. für Session UpDate).
- Datensatz ändern
$_dv['meine_tabelle__mein_feld']="mein neuer Wert";
Ein vorher gelesener Datensatz steht als PHP-Array zur Verfügung.
Alle Felder können mit einer einfachen Zuweisung geändert werden.
Natürlich können Sie auch beliebige Berechnungen durchführen.
dbXwebApp stellt für die interne Nutzung verschiedene globale Arrays zur Verfügung.
$_dv (data values) Alle aktuellen Datensätze. Immmer im Format ['db_tabellenname__db_feldname'] (z.B. $name=$_dv['dbx_user__name'])
$_gv (get values) Alle via Get übergebenen Werte
$_pv (pos values) Alle via Post übergebenen Werte
$_mv (modul values) Alle Parameter die einem Modul vorrangig übergeben werden
$_av (activ values) Werte mit Vorrang, Können Werte aus allen anderen Arrays "überschreiben".
$_xv (xchange values) Nachrangige Werte, die auch an den Cache mit übergeben werden.
$_nc (no cache) Werte die nicht cachebar sind. (z.B Hit-Counter)
- Datensatz speichern
$ok=dbx_Save("Tabelle","Select",Data,Modus);
Wieder nur eine einfacher Funktionsaufruf.
Das Caching System erkennt welche Tabelle sich ändert und welche Inhalte dadurch "überholt" sind.
Das System ermittelt selbstständig mit welchem db-Server es sich verbinden muss
Die Berechtigungen werden bis auf Feld-Ebene geprüft.
Die Daten werden für das Speichern neu formatiert (Datums-Format, Dezimalpunkt u.s.w)
Alle Inhalte werden validiert, auf Ihren Datentyp und Grösse geprüft.
Falls im DataDictonary Funktionen angegeben wurden, die beim Speichern auszuführen sind, werden diese ausgeführt.
001 $ok=dbx_select("my_documente","id='123'"); 002 if ($ok) { 003 $_dv['my_documente__title'].="-Kopie" // Im Titel als Kopie kennzeichen 004 $ok=dbx_Save("my_documente","new",$_dv); 005 }
Bemerkenswert dabei ist auch, dass das System völlig unkritisch auf Veränderungen der Tabellen-Struktur reagiert.
Ein paar neue Felder in der db-Tabelle. Eine Type Veränderung. Das Löschen unnötiger Felder in der db. Alles kein Problem.
Ohne jegliche Änderung an den PHP-Sourcen.
Jedes Modul besitzt eine eindeutig benannte Funktion, welche vom System aufgerufen wird.
Alle Parameter und Formulardaten, die ein Modul benötigt, werden nicht „direkt" an diese Funktionen übergeben. Das würde Modulaufrufe auch zu sehr statisch machen.
Beispiel:
Normaler Weise" würde man in PHP eine Funktion mit seinen Parameter aufrufen. Etwas was im innerem des Systems, natürlich auch innerhalb der Module, auch gemacht wird. Bei dbXwebApp werden Parameter vom System zum Modul indirekt übergeben.
Beispiel für die klassische Nutzung von PHP Funktionen:
001 Function my_function_show($msg) { 002 echo $msg; 003 } 004
Beispiel für eine dbXwebApp Funktion mit indirekter Parameter Übergabe.
001 Function my_function_show() { 002 $msg=dbx_get_GlobalVar("msg"); 003 echo $msg; 004 }
Der Parameter der mit dbx_get_GlobalVar abgefragt wird muss vorher natürlich gesetzt werden. Die Rückgabe des Wertes erfolgt nach einer hierarchischen Struktur.
Die Arrays $_gv und $_pv werden mit den GET und POST Werten automatisch gesetzt. Inhalte dieser Parameter/Felder werden vom System automatisch validiert.
Bei dbXwebApp werden verschiedene globale Arrays für die Parameter genutzt, die in folgender Reihenfolge verwendet werden.
- $_av (Aktiv Values)
- $_mv(Modul Values)
- $_pv (Post Values)
- $_gv (Get Values)
- $_xv (X-change Values)
Durch die Entkopplung von Anzeige/Eingabefelder und der Datenbank lassen sich sehr einfach Daten in jeglicher Form bearbeiten und anzeigen. Zum Kern von dbXwebApp gehört auch ein leistungsfähiger "Listengenerator" der insbesondere bezüglich der Gestaltung (Design) keinerlei Wünsche offen lässt.
