Cortiveo i GEngine - prirucnik

↑ Nazad

GEngine nije „splet legacy koda" nego koherentna arhitektura sastavljena od poznatih obrazaca. Imena su po Fowlerovoj knjizi Patterns of Enterprise Application Architecture (PoEAA) i po Design Patterns (GoF).

Tabela: obrazac → gde je u kodu → čemu služi

Pattern	Gde u GEngine-u	Šta rešava
Metadata Mapping	`GColumnHeader`, `GColumnString/Integer/...`, `GMySqlDatabase.dbtCreate`	opis kolone na jednom mestu → DDL, SQL, ekran, štampa, izvoz
Table Module	`DbtObject`, `GDataSource2d` — jedna instanca pokriva celu tabelu	ponašanje tabele na jednom mestu, bez objekta po redu
Record Set	redovi u memoriji + `GColumnHeader` opisi; `getRow(i).getInt("Kolona")`	tabelarni podaci nezavisni od izvora (baza ili `.txt`)
Layer Supertype	`GDataSourceLevel00 → 05 → 10 → 20 → 30 → 40 → 50`	svaki nivo dodaje jednu odgovornost
Bridge / Driver	`GDataDriverMySql`, `GDataDriverMemory`, `GDataDriverNull`; `GEngineAccess`, `GEngineExcel`	isti podaci preko drugog skladišta
Command + Chain of Responsibility	`callback(GCbMessage)` sa `TRIGGERALWAYS`, `SETACTION`, `EDITACTION` i `pMessage.consume()`	jedna ulazna točka za sve događaje, umesto stotine hook metoda
Composite	`GContainer`, `GContainerTable`, `GCell`, `GRecordPanel`	ekran je drvo elemenata, generisano iz kolona
Template Method	`loadData()`, `createData()`, `recreateData()` koje potomci dopunjuju	skelet postupka u osnovnoj klasi

Kako izgleda `callback` (Command)

@Override
public GCbMessage callback(GCbMessage pMessage)
{
    switch (pMessage.getId()) {
        case TRIGGERALWAYS:                       // pre svakog snimanja
            set(ID.getName(), getString(PACKAGE.getName()).trim() + "." + getString(TABLE.getName()).trim());
            break;
        case SETACTION:                           // koje akcije ekran nudi
            getActionGroup().getActionGroup(GActionGroup.OPCIJE).add(null, mActionCreate, mActionEdit);
            return pMessage;
        case EDITACTION:                          // korisnik je pokrenuo akciju
            if (lCommand.equalsIgnoreCase("TableCreate")) {
                pMessage.consume();               // komanda je pojedena, ne ide dalje
                ...
            }
    }
}

consume() je ono što ovo čini Chain of Responsibility: ko obradi komandu, zaustavi je.

Benefiti (zašto se uopšte piše ovako)

Jedna definicija — sve posledice. Dodaš kolonu u jedan Java fajl: tabela, grid, forma, validacija, izvoz, štampa i meni se povuku sami. Za mali tim koji drži stotine formi — ogromna ušteda.
Tipizirano. Kolone su objekti; greška se vidi u kompajliranju, ne u produkciji.
Šema ide sa kodom (getInfo().setVersion(1,1,15)) i rekreira se kod klijenta.
Zamenljivo skladište. Sav SQL nastaje na jednom mestu → port na PostgreSQL/MSSQL je posao jedne klase, ne cele aplikacije.

Cena (i šta se od toga može popraviti)

Cena	Zašto	Šta se može
amplifikacija poziva	svaka ćelija ide kroz metapodatke	keširanje kolona po tabeli; meriti Cortiveo tracerom
dubina nasleđivanja (7)	ponašanje je razbacano po nivoima	ne diraj kičmu; koristi `cortiveo trace` da vidiš ko stvarno radi
nema migracije šeme	`dbtCreate` = `DROP` + `CREATE`	dodati `dbtAlter` koji poredi klasu i `information_schema`
tok kroz `callback`	ne vidi se statički	runtime trag je izvor istine

Reference za učenje

Linkovi su iz mog znanja, nisu provereni klikom u ovoj sesiji — ako neki ne radi, traži naslov.

Tekst — obrasci koje ova aplikacija koristi

Fowler, PoEAA katalog — https://martinfowler.com/eaaCatalog/ — kratke definicije svih obrazaca iz tabele gore. Počni od:
Metadata Mapping — https://martinfowler.com/eaaCatalog/metadataMapping.html
Table Module — https://martinfowler.com/eaaCatalog/tableModule.html
Record Set — https://martinfowler.com/eaaCatalog/recordSet.html
Layer Supertype — https://martinfowler.com/eaaCatalog/layerSupertype.html
Refactoring Guru — https://refactoring.guru/design-patterns/catalog — GoF obrasci sa dijagramima i primerima u Javi (Bridge, Composite, Command, Template Method).
Yoder & Johnson: „The Adaptive Object-Model Architectural Style" — naučni rad o arhitekturi gde metapodaci opisuju poslovna pravila; to je tačno GEngine. Traži po naslovu (PDF je javan).
Fowler: „Data Dictionary" / „Domain-Specific Languages" — kontekst zašto 4GL alati ovako rade.

Video

Christopher Okhravi (YouTube) — serija „Design Patterns"; najbolji besplatni uvod u GoF obrasce, svaki u 15-25 minuta. Za nas: Bridge, Composite, Command, Template Method.
Martin Fowler: „Software Architecture Guide" predavanja — https://martinfowler.com/architecture/ — kratki tekstovi + snimci; dobro za „zašto arhitektura, a ne samo kod".
Java Swing — ako treba osvežiti: Oracle Swing tutorial, https://docs.oracle.com/javase/tutorial/uiswing/

Alati koje koristimo

JDI (Java Debug Interface) — https://docs.oracle.com/javase/8/docs/jdk/api/jpda/jdi/ — API kojim Cortiveo tracer gleda tuđi JVM. Ključno: MethodEntryRequest (skupo, po pozivu) vs BreakpointRequest (besplatno dok se ne pogodi).
AspectJ — na .208 u src stoji CallTree.aj, tvoj ranij pokušaj istog posla; AspectJ menja bytecode pri kompajliranju, JDI ne menja ništa. https://eclipse.dev/aspectj/
Apache POI — za xlsx umesto xls: https://poi.apache.org/components/spreadsheet/ — HSSFWorkbook (stari .xls) → XSSFWorkbook / SXSSFWorkbook (novi .xlsx, streaming).
MySQL → PostgreSQL razlike — kad dođemo do porta: tipovi (char(n), serial), citiranje identifikatora (backtick vs dvostruki navodnici), SHOW KEYS → information_schema.

Izvor: 03-patterns-i-reference.md