ISAM-Datenbankunterstuetzung
Setzt den OpenSpec-Change phase-3-isam um (49/49 Aufgaben) und schliesst damit Phase 3 ab. Alle 22 ISAM-Elemente des Inventars sind implementiert; der Abdeckungsstand steigt auf 217 implementiert / 15 offen / 53 Non-Feature. Frontend - ISAM-Anweisungen als eigener Zweig im Parser: NAME [#]n [, arg ...], Sonderform ROLLBACK ALL ueber eine Sentinel-Kennung - 22 Signaturen in builtin_stmt/builtin_fn, neue Argumentart R (Satzvariable eines benutzerdefinierten Typs) - Satzargumente von INSERT/RETRIEVE/UPDATE werden gegen den Typ der Dateinummer geprueft, sofern beide literal bekannt sind - Die Unsupported-Absenkung von OPEN ... FOR ISAM entfaellt Speicherschicht (tb-runtime::isam, einziger Ort mit redb) - Je Tabelle eine Satztabelle satz-id -> Satzbytes, je Index eine Tabelle Schluesselbytes -> satz-id. Satz-IDs sind monoton und werden nie wiederverwendet: der Cursor merkt sich eine ID, eine neu vergebene koennte still auf einen fremden Satz zeigen - Satzbytes entstehen mit fileio::wert_schreiben/wert_lesen, also mit den Recordpuffern und der UTF-32-Festtextkodierung aus datei-eio - Ordnungserhaltende Schluesselkodierung je Spaltentyp; Text als UTF-8, dessen Bytereihenfolge die Codepoint-Reihenfolge ist und damit dieselbe Ordnung wie CmpStr der VM. Ein Eigenschaftstest ueber 5000 zufaellige Wertepaare je Typ haelt fest, dass der Bytevergleich dem fachlichen Vergleich entspricht -- eine Ordnungsverletzung faellt sonst erst bei bestimmten Datenwerten auf - Cursor als Wert (aktiver Index, letzte Satz-ID, unpositioniert), nicht als gehaltener Iterator: er ueberlebt Satzaenderungen und Transaktionsgrenzen - Sicherungspunkte ueber ein eigenes Ruecknahmeprotokoll; ROLLBACK ALL bricht die Bibliothekstransaktion direkt ab Semantik durchweg aus der Original-Hilfe - Die Argumentformen stammen erstmals aus den Einzelseiten, nicht nur aus der Themenliste. Das korrigierte eine Annahme des Entwurfs: die Spaltenliste von CREATEINDEX ist keine Zeichenkette mit Trennzeichen, sondern eine Folge einzelner Stringargumente - SEEKEQ mit unvollstaendigem Schluessel schlaegt immer fehl, SEEKGT mit Teilschluessel positioniert wie SEEKGE - Nach SETINDEX ist der erste Satz der neuen Ordnung aktuell, nach DELETE der folgende - Suche ueber den NULL-Index meldet 87, nicht 83; damit hat jeder Code von 81 bis 89 einen Ausloeser - Einzige Erweiterung: ein - vor dem Spaltennamen ordnet absteigend. Die Original-Hilfe kennt bei CREATEINDEX keine Sortierrichtung, die Anforderung verlangt sie. Kollisionsfrei, weil ein TYPE-Feldname nie mit - beginnen kann CLOSE beendet keine Transaktion - Erst schrieb es sie fest, womit das Schliessen irgendeiner Dateinummer die Transaktion aller anderen mit beendete und ein folgendes ROLLBACK ALL ins Leere lief. Ausstehende Aenderungen sind ohnehin festgeschrieben, weil jede Operation ausserhalb einer Transaktion fuer sich eine ist - Ueber das Ende entscheiden allein COMMITTRANS und ROLLBACK ALL; eine beim Programmende offene Transaktion verfaellt, in beiden Wegen gleich SETMEM und Fehler 89 - Ohne DOS-Speichermodell ist SETMEM die Obergrenze des ISAM-Puffers (Vorgabe 65536 Bytes); ohne echte Grenze waere Code 89 nie erreichbar und die Anweisung eine Attrappe Tests - 18 Einheitentests (Kodierung, Formatversion, Satz-IDs, Roundtrip ueber alle Feldtypen, Indexordnung, Cursor, Protokoll) - 6 Korpusprogramme: Tabellen, Indizes, Cursor, Saetze, Transaktionen, Puffer und Vergleichsordnung -- je in einem temporaeren Arbeits- verzeichnis, der Projektbaum bleibt sauber - Der VM-Test zu Fehler 73 prueft ISAM nicht mehr, sondern SETUEVENT; dafuer belegt ein neuer Test, dass OPEN ... FOR ISAM arbeitet Dokumentation: Datenbankdateiformat in dateiformate.md, Abschnitt 10a samt Sortierordnung und SETMEM-Abweichung in sprachreferenz.md, ISAM-Abschnitt in bibliothek.md, Inventar auf implementiert, PLAN.md schaerft die Leitplanke Referenzverhalten -- sie gilt auch gegenueber den eigenen Spezifikationen. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -11,3 +11,4 @@ unicode-width.workspace = true
|
||||
jiff.workspace = true
|
||||
thiserror.workspace = true
|
||||
log.workspace = true
|
||||
redb = "4"
|
||||
|
||||
@@ -25,6 +25,8 @@ pub struct RtState {
|
||||
pub screen: TextScreen,
|
||||
/// Offene Dateien nach Dateinummer.
|
||||
pub dateien: crate::fileio::Dateien,
|
||||
/// ISAM-Zustand: Tabellenbindungen, Cursor, laufende Transaktion.
|
||||
pub isam: crate::isam::Isam,
|
||||
pub print: PrintState,
|
||||
/// Noch nicht abgeholte Tastendrücke in `INKEY$`-Form.
|
||||
pub tasten: VecDeque<String>,
|
||||
@@ -60,6 +62,7 @@ impl Default for RtState {
|
||||
RtState {
|
||||
screen: TextScreen::new(),
|
||||
dateien: Default::default(),
|
||||
isam: Default::default(),
|
||||
print: PrintState::default(),
|
||||
tasten: VecDeque::new(),
|
||||
abbruch: false,
|
||||
@@ -359,7 +362,31 @@ pub mod ids {
|
||||
pub const STACK_STMT: u16 = 122;
|
||||
pub const ERDEV: u16 = 123;
|
||||
pub const ERDEV_S: u16 = 124;
|
||||
pub const COUNT: u16 = 125;
|
||||
// ISAM (Change `phase-3-isam`)
|
||||
pub const ISAM_OPEN: u16 = 125;
|
||||
pub const ISAM_CREATE_INDEX: u16 = 126;
|
||||
pub const ISAM_DELETE_INDEX: u16 = 127;
|
||||
pub const ISAM_SET_INDEX: u16 = 128;
|
||||
pub const ISAM_GET_INDEX_S: u16 = 129;
|
||||
pub const ISAM_INSERT: u16 = 130;
|
||||
pub const ISAM_RETRIEVE: u16 = 131;
|
||||
pub const ISAM_UPDATE: u16 = 132;
|
||||
pub const ISAM_DELETE: u16 = 133;
|
||||
pub const ISAM_DELETE_TABLE: u16 = 134;
|
||||
pub const ISAM_MOVE_FIRST: u16 = 135;
|
||||
pub const ISAM_MOVE_LAST: u16 = 136;
|
||||
pub const ISAM_MOVE_NEXT: u16 = 137;
|
||||
pub const ISAM_MOVE_PREVIOUS: u16 = 138;
|
||||
pub const ISAM_SEEK_EQ: u16 = 139;
|
||||
pub const ISAM_SEEK_GT: u16 = 140;
|
||||
pub const ISAM_SEEK_GE: u16 = 141;
|
||||
pub const ISAM_BEGIN_TRANS: u16 = 142;
|
||||
pub const ISAM_COMMIT_TRANS: u16 = 143;
|
||||
pub const ISAM_ROLLBACK: u16 = 144;
|
||||
pub const ISAM_SAVEPOINT: u16 = 145;
|
||||
pub const ISAM_SETMEM: u16 = 146;
|
||||
pub const ISAM_BOF: u16 = 147;
|
||||
pub const COUNT: u16 = 148;
|
||||
}
|
||||
|
||||
/// Dispatch-Tabelle in Index-Reihenfolge.
|
||||
@@ -490,6 +517,30 @@ pub fn builtin_table() -> &'static [BuiltinFn] {
|
||||
bi_stack_stmt,
|
||||
bi_erdev,
|
||||
bi_erdev_s,
|
||||
// ISAM
|
||||
bi_isam_open,
|
||||
bi_isam_create_index,
|
||||
bi_isam_delete_index,
|
||||
bi_isam_set_index,
|
||||
bi_isam_get_index,
|
||||
bi_isam_insert,
|
||||
bi_isam_retrieve,
|
||||
bi_isam_update,
|
||||
bi_isam_delete,
|
||||
bi_isam_delete_table,
|
||||
bi_isam_move_first,
|
||||
bi_isam_move_last,
|
||||
bi_isam_move_next,
|
||||
bi_isam_move_previous,
|
||||
bi_isam_seek_eq,
|
||||
bi_isam_seek_gt,
|
||||
bi_isam_seek_ge,
|
||||
bi_isam_begin_trans,
|
||||
bi_isam_commit_trans,
|
||||
bi_isam_rollback,
|
||||
bi_isam_savepoint,
|
||||
bi_isam_setmem,
|
||||
bi_isam_bof,
|
||||
];
|
||||
debug_assert_eq!(TABLE.len(), ids::COUNT as usize);
|
||||
TABLE
|
||||
@@ -951,10 +1002,15 @@ fn bi_open(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option
|
||||
}
|
||||
|
||||
fn bi_close(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.dateien.schliessen(arg_i32(a, 0)?).map(|_| None)
|
||||
let n = arg_i32(a, 0)?;
|
||||
if st.isam.ist_isam(n) {
|
||||
return st.isam.schliessen(n).map(|_| None);
|
||||
}
|
||||
st.dateien.schliessen(n).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_close_all(st: &mut RtState, _: &mut dyn Host, _: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.alles_schliessen();
|
||||
st.dateien.alle_schliessen().map(|_| None)
|
||||
}
|
||||
|
||||
@@ -998,17 +1054,33 @@ fn bi_write_file(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<
|
||||
}
|
||||
|
||||
fn bi_eof(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let e = st.dateien.get(arg_i32(a, 0)?)?.eof()?;
|
||||
let n = arg_i32(a, 0)?;
|
||||
// Bei einer ISAM-Dateinummer meldet EOF das Ende der Tabelle in der
|
||||
// Ordnung des aktiven Index, nicht das Dateiende.
|
||||
if st.isam.ist_isam(n) {
|
||||
return Ok(Some(Value::Int(if st.isam.eof(n) { -1 } else { 0 })));
|
||||
}
|
||||
let e = st.dateien.get(n)?.eof()?;
|
||||
Ok(Some(Value::Int(if e { -1 } else { 0 })))
|
||||
}
|
||||
|
||||
fn bi_lof(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let l = st.dateien.get(arg_i32(a, 0)?)?.laenge()?;
|
||||
let n = arg_i32(a, 0)?;
|
||||
// ISAM: Zahl der Sätze in der Tabelle.
|
||||
if st.isam.ist_isam(n) {
|
||||
return Ok(Some(Value::Lng(st.isam.satzzahl(n)? as i32)));
|
||||
}
|
||||
let l = st.dateien.get(n)?.laenge()?;
|
||||
Ok(Some(Value::Lng(l as i32)))
|
||||
}
|
||||
|
||||
fn bi_loc(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let d = st.dateien.get(arg_i32(a, 0)?)?;
|
||||
let n = arg_i32(a, 0)?;
|
||||
// ISAM: Kennung des aktuellen Satzes, 0 wenn unpositioniert.
|
||||
if st.isam.ist_isam(n) {
|
||||
return Ok(Some(Value::Lng(st.isam.satznummer(n)? as i32)));
|
||||
}
|
||||
let d = st.dateien.get(n)?;
|
||||
// Position der letzten Operation (1-basiert): Datensatz bzw. Byte.
|
||||
Ok(Some(Value::Lng(d.position.saturating_sub(1) as i32)))
|
||||
}
|
||||
@@ -1587,6 +1659,169 @@ fn bi_beep(_: &mut RtState, _: &mut dyn Host, _: &mut [Value]) -> Result<Option<
|
||||
Ok(None)
|
||||
}
|
||||
|
||||
// ---- ISAM -------------------------------------------------------------------
|
||||
//
|
||||
// Die Anweisungen legen ihre Argumente in der Reihenfolge der Original-Hilfe
|
||||
// ab; die Dateinummer ist überall das erste (bei `DELETETABLE` der
|
||||
// Datenbankname). Die Fachlogik steht in `crate::isam`.
|
||||
|
||||
fn bi_isam_open(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
// (datenbank$, nummer, tabelle$, spaltennamen$, udt-index)
|
||||
let datenbank = arg_str(a, 0)?;
|
||||
let nummer = arg_i32(a, 1)?;
|
||||
let tabelle = arg_str(a, 2)?;
|
||||
let spalten = arg_str(a, 3)?;
|
||||
let udt = arg_i32(a, 4)? as u16;
|
||||
st.isam.oeffnen(nummer, &datenbank, &tabelle, &spalten, udt).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_create_index(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
// (nummer, indexname$, eindeutig%, spalte$ …)
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let name = arg_str(a, 1)?;
|
||||
let eindeutig = arg_i32(a, 2)? != 0;
|
||||
let mut spalten = Vec::new();
|
||||
for i in 3..a.len() {
|
||||
spalten.push(arg_str(a, i)?.to_string());
|
||||
}
|
||||
st.isam.index_anlegen(nummer, &name, eindeutig, &spalten).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_delete_index(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let name = arg_str(a, 1)?;
|
||||
st.isam.index_loeschen(nummer, &name).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_set_index(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
// Ohne Indexnamen gilt der NULL-Index (Einfügereihenfolge).
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let name = if a.len() > 1 { arg_str(a, 1)?.to_string() } else { String::new() };
|
||||
st.isam.index_setzen(nummer, &name).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_get_index(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let n = arg_i32(a, 0)?;
|
||||
st.isam.index_name(n).map(|s| Some(Value::Str(Rc::from(s.as_str()))))
|
||||
}
|
||||
|
||||
fn bi_isam_insert(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let satz = a.get(1).cloned().ok_or(RuntimeError::TYPE_MISMATCH)?;
|
||||
st.isam.einfuegen(nummer, &satz).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_retrieve(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
// Das Satzargument ist ein geteiltes Record-Handle: die gelesenen
|
||||
// Feldwerte gehen direkt in die Variable des Programms.
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let ziel = match a.get(1) {
|
||||
Some(Value::Rec(r)) => r.clone(),
|
||||
_ => return Err(RuntimeError::TYPE_MISMATCH),
|
||||
};
|
||||
let gelesen = st.isam.satz_lesen(nummer)?;
|
||||
let Value::Rec(quelle) = gelesen else {
|
||||
return Err(RuntimeError::TYPE_MISMATCH);
|
||||
};
|
||||
let werte = quelle.borrow().fields.clone();
|
||||
let mut z = ziel.borrow_mut();
|
||||
if z.fields.len() != werte.len() {
|
||||
return Err(RuntimeError::TYPE_MISMATCH);
|
||||
}
|
||||
z.fields = werte;
|
||||
Ok(None)
|
||||
}
|
||||
|
||||
fn bi_isam_update(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
let satz = a.get(1).cloned().ok_or(RuntimeError::TYPE_MISMATCH)?;
|
||||
st.isam.aendern(nummer, &satz).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_delete(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.satz_loeschen(arg_i32(a, 0)?).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_delete_table(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let datenbank = arg_str(a, 0)?;
|
||||
let tabelle = arg_str(a, 1)?;
|
||||
st.isam.tabelle_loeschen(&datenbank, &tabelle).map(|_| None)
|
||||
}
|
||||
|
||||
fn isam_bewegen(
|
||||
st: &mut RtState,
|
||||
a: &[Value],
|
||||
richtung: crate::isam::Richtung,
|
||||
) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.bewegen(arg_i32(a, 0)?, richtung).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_move_first(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_bewegen(st, a, crate::isam::Richtung::Erster)
|
||||
}
|
||||
|
||||
fn bi_isam_move_last(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_bewegen(st, a, crate::isam::Richtung::Letzter)
|
||||
}
|
||||
|
||||
fn bi_isam_move_next(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_bewegen(st, a, crate::isam::Richtung::Naechster)
|
||||
}
|
||||
|
||||
fn bi_isam_move_previous(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_bewegen(st, a, crate::isam::Richtung::Voriger)
|
||||
}
|
||||
|
||||
fn isam_suchen(
|
||||
st: &mut RtState,
|
||||
a: &[Value],
|
||||
art: crate::isam::Suchart,
|
||||
) -> Result<Option<Value>, RuntimeError> {
|
||||
let nummer = arg_i32(a, 0)?;
|
||||
st.isam.suchen(nummer, art, &a[1..]).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_seek_eq(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_suchen(st, a, crate::isam::Suchart::Gleich)
|
||||
}
|
||||
|
||||
fn bi_isam_seek_gt(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_suchen(st, a, crate::isam::Suchart::Groesser)
|
||||
}
|
||||
|
||||
fn bi_isam_seek_ge(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
isam_suchen(st, a, crate::isam::Suchart::GroesserGleich)
|
||||
}
|
||||
|
||||
fn bi_isam_begin_trans(st: &mut RtState, _: &mut dyn Host, _: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.trans_beginn().map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_commit_trans(st: &mut RtState, _: &mut dyn Host, _: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.trans_festschreiben().map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_rollback(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
// Ohne Argument: bis zum letzten Sicherungspunkt bzw. Transaktionsbeginn.
|
||||
let kennung = if a.is_empty() { 0 } else { arg_i32(a, 0)? };
|
||||
st.isam.ruecknahme(kennung).map(|_| None)
|
||||
}
|
||||
|
||||
fn bi_isam_savepoint(st: &mut RtState, _: &mut dyn Host, _: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
st.isam.sicherungspunkt().map(|k| Some(Value::Int(k)))
|
||||
}
|
||||
|
||||
fn bi_isam_setmem(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let delta = arg_i32(a, 0)? as i64;
|
||||
let frei = st.isam.setmem(delta);
|
||||
Ok(Some(Value::Lng(frei.clamp(i32::MIN as i64, i32::MAX as i64) as i32)))
|
||||
}
|
||||
|
||||
fn bi_isam_bof(st: &mut RtState, _: &mut dyn Host, a: &mut [Value]) -> Result<Option<Value>, RuntimeError> {
|
||||
let n = arg_i32(a, 0)?;
|
||||
Ok(Some(Value::Int(if st.isam.bof(n) { -1 } else { 0 })))
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
1570
crates/tb-runtime/src/isam.rs
Normal file
1570
crates/tb-runtime/src/isam.rs
Normal file
File diff suppressed because it is too large
Load Diff
439
crates/tb-runtime/src/isam/tests.rs
Normal file
439
crates/tb-runtime/src/isam/tests.rs
Normal file
@@ -0,0 +1,439 @@
|
||||
//! Einheitentests des ISAM-Moduls: Schlüsselkodierung, Speicherschicht,
|
||||
//! Cursor und Rücknahmeprotokoll.
|
||||
|
||||
use super::*;
|
||||
use crate::value::RecordObj;
|
||||
use std::cell::RefCell;
|
||||
use std::rc::Rc;
|
||||
|
||||
/// Kleiner Zähler-PRNG für den Eigenschaftstest — reproduzierbar und ohne
|
||||
/// zusätzliche Abhängigkeit (xorshift32).
|
||||
struct Zufall(u32);
|
||||
|
||||
impl Zufall {
|
||||
fn next(&mut self) -> u32 {
|
||||
self.0 ^= self.0 << 13;
|
||||
self.0 ^= self.0 >> 17;
|
||||
self.0 ^= self.0 << 5;
|
||||
self.0
|
||||
}
|
||||
}
|
||||
|
||||
fn kodiere(w: &Value, t: &TypeInit, absteigend: bool) -> Vec<u8> {
|
||||
let mut v = Vec::new();
|
||||
schluessel_anhaengen(&mut v, w, t, absteigend);
|
||||
v
|
||||
}
|
||||
|
||||
// ---- Aufgabe 3.5: ordnungserhaltende Schlüsselkodierung --------------------
|
||||
|
||||
/// Kernanforderung aus D3: der Byte-Vergleich der Kodierung MUSS dem
|
||||
/// fachlichen Vergleich entsprechen — sonst stehen Sätze in falscher
|
||||
/// Reihenfolge, und zwar nur bei bestimmten Datenwerten.
|
||||
#[test]
|
||||
fn kodierung_erhaelt_die_ordnung_bei_zufallspaaren() {
|
||||
let mut r = Zufall(0x1234_5678);
|
||||
for _ in 0..5000 {
|
||||
// INTEGER
|
||||
let a = r.next() as i16;
|
||||
let b = r.next() as i16;
|
||||
assert_eq!(
|
||||
kodiere(&Value::Int(a), &TypeInit::Int, false)
|
||||
.cmp(&kodiere(&Value::Int(b), &TypeInit::Int, false)),
|
||||
a.cmp(&b),
|
||||
"INTEGER {a} vs {b}"
|
||||
);
|
||||
|
||||
// LONG
|
||||
let a = r.next() as i32;
|
||||
let b = r.next() as i32;
|
||||
assert_eq!(
|
||||
kodiere(&Value::Lng(a), &TypeInit::Lng, false)
|
||||
.cmp(&kodiere(&Value::Lng(b), &TypeInit::Lng, false)),
|
||||
a.cmp(&b),
|
||||
"LONG {a} vs {b}"
|
||||
);
|
||||
|
||||
// CURRENCY (skalierte Ganzzahl)
|
||||
let a = r.next() as i32 as i64;
|
||||
let b = r.next() as i32 as i64;
|
||||
assert_eq!(
|
||||
kodiere(&Value::Cur(a), &TypeInit::Cur, false)
|
||||
.cmp(&kodiere(&Value::Cur(b), &TypeInit::Cur, false)),
|
||||
a.cmp(&b),
|
||||
"CURRENCY {a} vs {b}"
|
||||
);
|
||||
|
||||
// DOUBLE — endliche Werte über einen weiten Bereich
|
||||
let a = (r.next() as i32 as f64) / 1024.0;
|
||||
let b = (r.next() as i32 as f64) / 1024.0;
|
||||
assert_eq!(
|
||||
kodiere(&Value::Dbl(a), &TypeInit::Dbl, false)
|
||||
.cmp(&kodiere(&Value::Dbl(b), &TypeInit::Dbl, false)),
|
||||
a.partial_cmp(&b).unwrap(),
|
||||
"DOUBLE {a} vs {b}"
|
||||
);
|
||||
|
||||
// SINGLE
|
||||
let a = (r.next() as i32 as f32) / 64.0;
|
||||
let b = (r.next() as i32 as f32) / 64.0;
|
||||
assert_eq!(
|
||||
kodiere(&Value::Sng(a), &TypeInit::Sng, false)
|
||||
.cmp(&kodiere(&Value::Sng(b), &TypeInit::Sng, false)),
|
||||
a.partial_cmp(&b).unwrap(),
|
||||
"SINGLE {a} vs {b}"
|
||||
);
|
||||
|
||||
// Fester Text: die Kodierung ordnet wie der Stringvergleich des
|
||||
// Dialekts, der auf UTF-8-Bytes vergleicht (interp::CmpStr).
|
||||
let mach = |x: u32| -> String {
|
||||
let zeichen = ['a', 'b', 'z', 'A', 'Z', 'ä', 'ß', '€'];
|
||||
(0..4).map(|i| zeichen[((x >> (i * 3)) & 7) as usize]).collect()
|
||||
};
|
||||
let sa = mach(r.next());
|
||||
let sb = mach(r.next());
|
||||
let t = TypeInit::FixedStr(4);
|
||||
assert_eq!(
|
||||
kodiere(&Value::Str(Rc::from(sa.as_str())), &t, false)
|
||||
.cmp(&kodiere(&Value::Str(Rc::from(sb.as_str())), &t, false)),
|
||||
sa.as_bytes().cmp(sb.as_bytes()),
|
||||
"TEXT {sa:?} vs {sb:?}"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn absteigende_spalte_kehrt_die_ordnung_um() {
|
||||
let a = kodiere(&Value::Lng(10), &TypeInit::Lng, true);
|
||||
let b = kodiere(&Value::Lng(20), &TypeInit::Lng, true);
|
||||
assert!(a > b, "absteigend muss 10 hinter 20 einordnen");
|
||||
}
|
||||
|
||||
/// Der Abschluss `00 00` sorgt dafür, dass ein echtes Präfix vor dem
|
||||
/// längeren Text steht — auch als Teil eines mehrspaltigen Schlüssels.
|
||||
#[test]
|
||||
fn textabschluss_ordnet_praefix_vor_laengerem_text() {
|
||||
let t = TypeInit::Str;
|
||||
let kurz = kodiere(&Value::Str(Rc::from("ab")), &t, false);
|
||||
let lang = kodiere(&Value::Str(Rc::from("abc")), &t, false);
|
||||
assert!(kurz < lang);
|
||||
// Auch absteigend bleibt die Umkehrung vollständig.
|
||||
let kurz_ab = kodiere(&Value::Str(Rc::from("ab")), &t, true);
|
||||
let lang_ab = kodiere(&Value::Str(Rc::from("abc")), &t, true);
|
||||
assert!(kurz_ab > lang_ab);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn nullbyte_im_text_stoert_den_abschluss_nicht() {
|
||||
let t = TypeInit::Str;
|
||||
let a = kodiere(&Value::Str(Rc::from("a")), &t, false);
|
||||
let b = kodiere(&Value::Str(Rc::from("a\u{0}b")), &t, false);
|
||||
assert!(a < b, "\"a\" muss vor \"a\\0b\" stehen");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn praefix_ende_zaehlt_hoch() {
|
||||
assert_eq!(praefix_ende(&[1, 2, 3]), Some(vec![1, 2, 4]));
|
||||
assert_eq!(praefix_ende(&[1, 0xFF]), Some(vec![2]));
|
||||
assert_eq!(praefix_ende(&[0xFF, 0xFF]), None);
|
||||
}
|
||||
|
||||
// ---- Testaufbau für die Speicherschicht ------------------------------------
|
||||
|
||||
/// Satztyp der Tests: `Nummer AS LONG`, `Name AS STRING * 6`.
|
||||
fn test_udts() -> Vec<UdtLayout> {
|
||||
vec![UdtLayout {
|
||||
name: "KUNDE".into(),
|
||||
fields: vec![TypeInit::Lng, TypeInit::FixedStr(6)],
|
||||
}]
|
||||
}
|
||||
|
||||
fn satz(nummer: i32, name: &str) -> Value {
|
||||
Value::Rec(Rc::new(RefCell::new(RecordObj {
|
||||
fields: vec![Value::Lng(nummer), Value::Str(Rc::from(name))],
|
||||
})))
|
||||
}
|
||||
|
||||
struct TempDb {
|
||||
dir: PathBuf,
|
||||
}
|
||||
|
||||
impl TempDb {
|
||||
fn neu(name: &str) -> TempDb {
|
||||
let dir = std::env::temp_dir().join(format!(
|
||||
"tb_isam_{name}_{}_{:?}",
|
||||
std::process::id(),
|
||||
std::thread::current().id()
|
||||
));
|
||||
let _ = std::fs::remove_dir_all(&dir);
|
||||
std::fs::create_dir_all(&dir).unwrap();
|
||||
TempDb { dir }
|
||||
}
|
||||
fn pfad(&self, datei: &str) -> String {
|
||||
self.dir.join(datei).to_string_lossy().to_string()
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for TempDb {
|
||||
fn drop(&mut self) {
|
||||
let _ = std::fs::remove_dir_all(&self.dir);
|
||||
}
|
||||
}
|
||||
|
||||
fn isam_mit_tabelle(db: &str) -> Isam {
|
||||
let mut i = Isam { udts: test_udts(), ..Default::default() };
|
||||
i.oeffnen(1, db, "Kunden", "Nummer,Name", 0).unwrap();
|
||||
i
|
||||
}
|
||||
|
||||
// ---- Aufgabe 3.2: Formatversion --------------------------------------------
|
||||
|
||||
#[test]
|
||||
fn hoehere_formatversion_wird_abgewiesen() {
|
||||
let t = TempDb::neu("version");
|
||||
let pfad = t.pfad("db.isam");
|
||||
{
|
||||
let mut i = isam_mit_tabelle(&pfad);
|
||||
i.alles_schliessen();
|
||||
}
|
||||
// Version künstlich hochsetzen.
|
||||
{
|
||||
let db = Database::create(&pfad).unwrap();
|
||||
let txn = db.begin_write().unwrap();
|
||||
meta_schreiben(&txn, "version", &(FORMATVERSION + 1).to_le_bytes()).unwrap();
|
||||
txn.commit().unwrap();
|
||||
}
|
||||
let mut i = Isam { udts: test_udts(), ..Default::default() };
|
||||
let e = i.oeffnen(1, &pfad, "Kunden", "Nummer,Name", 0).unwrap_err();
|
||||
assert_eq!(e, INKONSISTENT, "höhere Formatversion muss benannt scheitern");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn beschaedigte_datei_meldet_fehler_88() {
|
||||
let t = TempDb::neu("kaputt");
|
||||
let pfad = t.pfad("kaputt.isam");
|
||||
std::fs::write(&pfad, b"das ist keine Datenbankdatei").unwrap();
|
||||
let mut i = Isam { udts: test_udts(), ..Default::default() };
|
||||
let e = i.oeffnen(1, &pfad, "Kunden", "Nummer,Name", 0).unwrap_err();
|
||||
assert_eq!(e, RuntimeError(88));
|
||||
}
|
||||
|
||||
// ---- Aufgabe 3.3: Satz-IDs werden nie wiederverwendet -----------------------
|
||||
|
||||
#[test]
|
||||
fn geloeschte_satz_id_wird_nicht_neu_vergeben() {
|
||||
let t = TempDb::neu("ids");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.einfuegen(1, &satz(1, "eins")).unwrap();
|
||||
let erste = i.satznummer(1).unwrap();
|
||||
i.satz_loeschen(1).unwrap();
|
||||
i.einfuegen(1, &satz(2, "zwei")).unwrap();
|
||||
let zweite = i.satznummer(1).unwrap();
|
||||
assert_ne!(erste, zweite, "eine gelöschte ID darf nicht neu vergeben werden");
|
||||
assert!(zweite > erste);
|
||||
}
|
||||
|
||||
// ---- Aufgabe 3.4: Satzserialisierung ---------------------------------------
|
||||
|
||||
#[test]
|
||||
fn satz_roundtrip_ueber_alle_feldtypen() {
|
||||
let t = TempDb::neu("roundtrip");
|
||||
let udts = vec![UdtLayout {
|
||||
name: "ALLES".into(),
|
||||
fields: vec![
|
||||
TypeInit::Int,
|
||||
TypeInit::Lng,
|
||||
TypeInit::Sng,
|
||||
TypeInit::Dbl,
|
||||
TypeInit::Cur,
|
||||
TypeInit::FixedStr(5),
|
||||
],
|
||||
}];
|
||||
let mut i = Isam { udts, ..Default::default() };
|
||||
i.oeffnen(1, &t.pfad("db.isam"), "Alles", "A,B,C,D,E,F", 0).unwrap();
|
||||
let original = Value::Rec(Rc::new(RefCell::new(RecordObj {
|
||||
fields: vec![
|
||||
Value::Int(-7),
|
||||
Value::Lng(123456),
|
||||
Value::Sng(1.5),
|
||||
Value::Dbl(-2.25),
|
||||
Value::Cur(98765),
|
||||
Value::Str(Rc::from("äöü!")),
|
||||
],
|
||||
})));
|
||||
i.einfuegen(1, &original).unwrap();
|
||||
let Value::Rec(gelesen) = i.satz_lesen(1).unwrap() else { panic!("kein Record") };
|
||||
let f = &gelesen.borrow().fields;
|
||||
assert!(matches!(f[0], Value::Int(-7)));
|
||||
assert!(matches!(f[1], Value::Lng(123456)));
|
||||
assert!(matches!(f[2], Value::Sng(v) if v == 1.5));
|
||||
assert!(matches!(f[3], Value::Dbl(v) if v == -2.25));
|
||||
assert!(matches!(f[4], Value::Cur(98765)));
|
||||
// Feste Strings kommen auf ihre Feldbreite aufgefüllt zurück.
|
||||
assert!(matches!(&f[5], Value::Str(s) if &**s == "äöü! "));
|
||||
}
|
||||
|
||||
// ---- Aufgabe 5.1: Indexeinträge stehen in Schlüsselreihenfolge -------------
|
||||
|
||||
#[test]
|
||||
fn indexeintraege_stehen_in_schluesselreihenfolge() {
|
||||
let t = TempDb::neu("indexordnung");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.index_anlegen(1, "NachName", false, &["Name".into()]).unwrap();
|
||||
for (n, name) in [(3, "Cäsar"), (1, "Anton"), (2, "Berta")] {
|
||||
i.einfuegen(1, &satz(n, name)).unwrap();
|
||||
}
|
||||
i.index_setzen(1, "NachName").unwrap();
|
||||
let mut namen = Vec::new();
|
||||
i.bewegen(1, Richtung::Erster).unwrap();
|
||||
while !i.eof(1) {
|
||||
let Value::Rec(r) = i.satz_lesen(1).unwrap() else { panic!() };
|
||||
let Value::Str(s) = r.borrow().fields[1].clone() else { panic!() };
|
||||
namen.push(s.trim_end().to_string());
|
||||
i.bewegen(1, Richtung::Naechster).unwrap();
|
||||
}
|
||||
assert_eq!(namen, vec!["Anton", "Berta", "Cäsar"]);
|
||||
}
|
||||
|
||||
// ---- Aufgabe 6.1: Der Cursor überlebt eine Satzänderung --------------------
|
||||
|
||||
/// D5: Der Cursor ist ein Wert, kein gehaltener Iterator — er zeigt nach
|
||||
/// einer Änderung an einem *anderen* Satz weiterhin auf denselben Satz.
|
||||
#[test]
|
||||
fn cursor_ueberlebt_eine_satzaenderung() {
|
||||
let t = TempDb::neu("cursor");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.index_anlegen(1, "NachName", false, &["Name".into()]).unwrap();
|
||||
for (n, name) in [(1, "Anton"), (2, "Berta"), (3, "Cäsar")] {
|
||||
i.einfuegen(1, &satz(n, name)).unwrap();
|
||||
}
|
||||
i.index_setzen(1, "NachName").unwrap();
|
||||
i.bewegen(1, Richtung::Erster).unwrap();
|
||||
i.bewegen(1, Richtung::Naechster).unwrap(); // steht auf Berta
|
||||
let vorher = i.satznummer(1).unwrap();
|
||||
|
||||
// Über eine zweite Bindung einen anderen Satz einfügen.
|
||||
i.oeffnen(2, &t.pfad("db.isam"), "Kunden", "Nummer,Name", 0).unwrap();
|
||||
i.einfuegen(2, &satz(4, "Anna")).unwrap();
|
||||
|
||||
assert_eq!(i.satznummer(1).unwrap(), vorher, "Cursor darf nicht wandern");
|
||||
let Value::Rec(r) = i.satz_lesen(1).unwrap() else { panic!() };
|
||||
let Value::Str(s) = r.borrow().fields[1].clone() else { panic!() };
|
||||
assert_eq!(s.trim_end(), "Berta");
|
||||
|
||||
// Und er bewegt sich weiter in der neuen Ordnung.
|
||||
i.bewegen(1, Richtung::Naechster).unwrap();
|
||||
let Value::Rec(r) = i.satz_lesen(1).unwrap() else { panic!() };
|
||||
let Value::Str(s) = r.borrow().fields[1].clone() else { panic!() };
|
||||
assert_eq!(s.trim_end(), "Cäsar");
|
||||
}
|
||||
|
||||
// ---- Aufgabe 8.2: Rücknahmeprotokoll ---------------------------------------
|
||||
|
||||
/// Jede Satzoperation innerhalb einer Transaktion erzeugt genau einen
|
||||
/// Protokolleintrag — die Grundlage der Sicherungspunkte (D6).
|
||||
#[test]
|
||||
fn jede_satzoperation_erzeugt_einen_protokolleintrag() {
|
||||
let t = TempDb::neu("protokoll");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.trans_beginn().unwrap();
|
||||
assert_eq!(i.trans.as_ref().unwrap().log.len(), 0);
|
||||
|
||||
i.einfuegen(1, &satz(1, "eins")).unwrap();
|
||||
assert_eq!(i.trans.as_ref().unwrap().log.len(), 1, "INSERT");
|
||||
|
||||
i.aendern(1, &satz(1, "EINS")).unwrap();
|
||||
assert_eq!(i.trans.as_ref().unwrap().log.len(), 2, "UPDATE");
|
||||
|
||||
i.satz_loeschen(1).unwrap();
|
||||
assert_eq!(i.trans.as_ref().unwrap().log.len(), 3, "DELETE");
|
||||
|
||||
i.trans_festschreiben().unwrap();
|
||||
assert!(i.trans.is_none());
|
||||
}
|
||||
|
||||
/// Außerhalb einer Transaktion gibt es nichts zurückzunehmen — das
|
||||
/// Protokoll darf dann nicht wachsen.
|
||||
#[test]
|
||||
fn ohne_transaktion_kein_protokoll() {
|
||||
let t = TempDb::neu("kein_protokoll");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.einfuegen(1, &satz(1, "eins")).unwrap();
|
||||
assert!(i.trans.is_none());
|
||||
}
|
||||
|
||||
// ---- Namensprüfung (Fehler 81) ---------------------------------------------
|
||||
|
||||
#[test]
|
||||
fn ungueltige_namen_werden_abgewiesen() {
|
||||
assert!(name_pruefen("Kunden").is_ok());
|
||||
assert!(name_pruefen("K_1").is_ok());
|
||||
assert_eq!(name_pruefen("").unwrap_err(), NAME_UNGUELTIG);
|
||||
assert_eq!(name_pruefen("1Kunde").unwrap_err(), NAME_UNGUELTIG);
|
||||
assert_eq!(name_pruefen("Kun/den").unwrap_err(), NAME_UNGUELTIG);
|
||||
assert_eq!(name_pruefen(&"x".repeat(32)).unwrap_err(), NAME_UNGUELTIG);
|
||||
}
|
||||
|
||||
// ---- Befunde der Verifikation (2026-09-04) ---------------------------------
|
||||
|
||||
/// `CLOSE` beendet keine laufende Transaktion. Täte es das, schriebe das
|
||||
/// Schließen irgendeiner Dateinummer die Änderungen aller anderen fest und
|
||||
/// ein folgendes `ROLLBACK ALL` liefe ins Leere.
|
||||
#[test]
|
||||
fn close_beendet_keine_transaktion() {
|
||||
let t = TempDb::neu("close_trans");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.oeffnen(2, &t.pfad("db.isam"), "Kunden", "Nummer,Name", 0).unwrap();
|
||||
i.trans_beginn().unwrap();
|
||||
i.einfuegen(1, &satz(1, "eins")).unwrap();
|
||||
|
||||
i.schliessen(2).unwrap();
|
||||
assert!(i.trans.is_some(), "CLOSE darf die Transaktion nicht beenden");
|
||||
|
||||
// Die Rücknahme wirkt danach noch auf die Änderung an #1.
|
||||
i.ruecknahme(ROLLBACK_ALL).unwrap();
|
||||
assert_eq!(i.satzzahl(1).unwrap(), 0);
|
||||
}
|
||||
|
||||
/// Eine nicht festgeschriebene Transaktion verfällt beim Schließen aller
|
||||
/// Dateien — dieselbe Lage wie am Programmende, wo sie fallen gelassen wird.
|
||||
#[test]
|
||||
fn nicht_festgeschriebene_transaktion_verfaellt() {
|
||||
let t = TempDb::neu("verfall");
|
||||
let pfad = t.pfad("db.isam");
|
||||
{
|
||||
let mut i = isam_mit_tabelle(&pfad);
|
||||
i.trans_beginn().unwrap();
|
||||
i.einfuegen(1, &satz(1, "eins")).unwrap();
|
||||
i.alles_schliessen();
|
||||
}
|
||||
let mut i = Isam { udts: test_udts(), ..Default::default() };
|
||||
i.oeffnen(1, &pfad, "Kunden", "Nummer,Name", 0).unwrap();
|
||||
assert_eq!(
|
||||
i.satzzahl(1).unwrap(),
|
||||
0,
|
||||
"eine offene Transaktion darf nicht stillschweigend wirken"
|
||||
);
|
||||
}
|
||||
|
||||
/// Scheitert `CREATEINDEX` an der Eindeutigkeit, bleibt keine halb gefüllte
|
||||
/// Indextabelle zurück — auch nicht innerhalb einer Transaktion, wo der
|
||||
/// Abbruch der Bibliothekstransaktion nicht aufräumen kann.
|
||||
#[test]
|
||||
fn gescheitertes_createindex_hinterlaesst_keinen_index() {
|
||||
let t = TempDb::neu("kein_torso");
|
||||
let mut i = isam_mit_tabelle(&t.pfad("db.isam"));
|
||||
i.einfuegen(1, &satz(1, "gleich")).unwrap();
|
||||
i.einfuegen(1, &satz(2, "gleich")).unwrap();
|
||||
|
||||
i.trans_beginn().unwrap();
|
||||
let e = i.index_anlegen(1, "Eindeutig", true, &["Name".into()]).unwrap_err();
|
||||
assert_eq!(e, DOPPELTER_SCHLUESSEL);
|
||||
i.trans_festschreiben().unwrap();
|
||||
|
||||
assert_eq!(
|
||||
i.index_setzen(1, "Eindeutig").unwrap_err(),
|
||||
INDEX_FEHLT,
|
||||
"der gescheiterte Index darf nicht als Torso zurückbleiben"
|
||||
);
|
||||
}
|
||||
@@ -8,6 +8,7 @@ pub mod builtins; // Dispatch-Tabelle für CALL_BUILTIN (Phase-2-Scheibe)
|
||||
pub mod console; // Druckzustand: Zonen, TAB/SPC, Zahlenausgabe
|
||||
pub mod errors; // Laufzeitfehler-Codes und -Meldungen des Vorbilds
|
||||
pub mod fileio; // OPEN/CLOSE/PRINT#/INPUT#/GET/PUT, sequenziell/random/binär
|
||||
pub mod isam; // ISAM: Tabellen, Indizes, Cursor, Transaktionen (redb)
|
||||
pub mod format; // Zahlendarstellung (PRINT/STR$) und VAL
|
||||
pub mod host;
|
||||
pub mod screen;
|
||||
|
||||
Reference in New Issue
Block a user