Kmom04: Databasdrivna modeller

Scaffolding innebär att automatiskt generera kod för att snabbt bygga en webbapplikation. Det handlar om att specificera det som skall göras, till exempel via konfigurationsfiler, och sedan generera kod för kontroller, modeller, vyer, formulär och databastabeller.

Att automatiskt generera kod i ramverket har fördelen att det går snabbt att skapa koden, men nackdelen är att den inte blir exakt som man vill och kan behöva modifieras. I detta kursmomentet skall vi titta på de förutsättningar som bör finnas i ramverket för att vi skall kunna automatgenerera kod. Vi tittar på olika databaslager, modeller som är förberedda för CRUD-hantering och effektiv formulärhantering.

Vi försöker belysa frågor om vilka grunder, i form av klasser för formulärhantering, databasfrågor och modeller, som kan hjälpa oss att skriva enkla kodkonstruktioner som leder till snabbare resultat, och bättre kod, i ramverket.

Följande är exempel på kod som vi skall använda för att underlättar kodskrivandet.

Skapa SQL-frågorna via metodanrop med paketet mos/cdatabase.

$sql = "
CREATE TABLE mos_test
(
    id integer primary key not null,
    age integer,
    text varchar(20)
)
;";
$db->execute($sql);
 
$db->createTable(
    'test',
    [
        'id'    => ['integer', 'auto_increment', 'primary key', 'not null'],
        'age'   => ['integer'],
        'text'  => ['varchar(20)'],
    ]
);
 
$db->execute();

Skapa HTML formulär via arrayer med paketet mos/cform.

$form = $form->create([], [
    'name' => [
      'type'        => 'text',
      'label'       => 'Name of contact person:',
      'required'    => true,
      'validation'  => ['not_empty'],
    ],
    'email' => [
      'type'        => 'text',
      'required'    => true,
      'validation'  => ['not_empty', 'email_adress'],
    ],
    'phone' => [
      'type'        => 'text',
      'required'    => true,
      'validation'  => ['not_empty', 'numeric'],
    ],
    'submit' => [
        'type'      => 'submit',
        'callback'  => function($form) {
            $form->AddOutput("<p><i>DoSubmit(): Form was submitted. Do stuff (save to database) and return true (success) or false (failed processing form)</i></p>");
            $form->AddOutput("<p><b>Name: " . $form->Value('name') . "</b></p>");
            $form->AddOutput("<p><b>Email: " . $form->Value('email') . "</b></p>");
            $form->AddOutput("<p><b>Phone: " . $form->Value('phone') . "</b></p>");
            $form->saveInSession = true;
            return true;
        }
    ],
]);

(Detta är instruktionen för kursmomentet och omfattar det som skall göras inom ramen för kursmomentet. Momentet omfattar cirka 20 studietimmar inklusive läsning, arbete med övningar och uppgifter, felsökning, problemlösning, redovisning och eftertanke. Läs igenom hela kursmomentet innan du börjar jobba. Om möjligt – planera och prioritera var du vill lägga tiden.)

#Läsanvisningar

(ca: 4-6 studietimmar)

#Artiklar

Börja med att läsa om ramverket Phalcon och dess hantering av databas och modeller.

1. Läs igenom följande kapitel i manualen om Phalcon. Det visar hur Phalcon har separerat sina lager mellan databasen och modellerna.
   • Phalcon och Database Abstraction Layer.
   • Phalcon och Phalcon Query Language (PHQL).
   • Phalcon och Working with Models.

Fortsätt nu att läsa om formulärhantering i ramverk.

1. Läs om Formulärhantering i Phalcon.

2. Läs översiktligt om PHP Form Builder Class, en fristående PHP-klass för att skapa formulär. Studera de formulärexempel som finns på sidan.

Avsluta med att läsa om Phalcons developer tools och se hur man kan skapa stubbar till klasser via kommandoraden.

1. Phalcon och Phalcon Developer Tools för att göra scaffolding och generera kod via kommandoraden.

#Kurslitteratur

Läs följande:

1. PHP Objects, Patterns, Practice
   • Ch7 What Are Design Patterns? Why Use Them?
   • Ch9 Generating Objects
   • Ch13 Database Patterns

#Lektionsmaterial

Föreläsningsmaterial för campus kommer i april 2014.

#Lästips

Om du hinner och har ambitionen, eller lägg detta på din måste-bekanta-mig-med-lista.

1. Läs mer om databashantering och dess begrepp. Kärt barn har många namn och varianter, läs snabbt och översiktligt igenom följande databasrelaterade begrepp på Wikipedia.

   • Scaffolding
   • Active Record Pattern
   • Object-relational mapping
   • Data mapper pattern
   • Data access layer
   • Data access object

2. Läs översiktligt om formulär- och databashantering för ramverket Yii i “The Definitive Guide To Yii”. Läs följande delar.

   • Model-View-Controller (MVC)
   • Model
   • Working with Form (läs hela kapitlet)
   • Working with Database (läs hela kapitlet)

3. Läs om databashantering i ramverket Symfony med Doctrine.

4. Läs om Doctrine i guiden “Getting Started with Doctrine”.

5. Läs om “Säker hantering av formulär”.

#Övningar & Uppgifter

(ca: 12-16 studietimmar)

#Övningar

Övningarna förbereder dig för uppgifterna.

1. Ladda hem och testa CForm tillsammans med ditt Anax MVC. Gör en route för varje testprogram och bekanta dig med hur det fungerar. Här har du en potentiell tidssparare av stora mått.

   Som en komplement kan du även läsa igenom artikeln “CForm, en PHP-klass för att skapa, presentera och validera HTML-formulär”. Det är en artikel som skrevs till en tidigare version av CForm. Men den är fortfarande relevant och innehåller matnyttig information.

2. Jobba igenom övningen “Använd CForm tillsammans med Anax MVC” som visar du olika sätt att integrera CForm med Anax MVC.

3. Ladda hem och testa CDatabase tillsammans med ditt Anax MVC. Skapa lite egna testprogram, börja att bygga SQL-kod för dina kommentarer som snart skall flyttas till databasen.

4. Jobba igenom övningen “Skapa basklasser för databasdrivna modeller i Anax MVC”. Skapa din egen återanvändbara basklass för databasdrivna modeller.

#Uppgifter

Utför och redovisa följande uppgifter.

1. Gör uppgiften “En databasdriven basmodell och hantering av användare”.

2. Gör uppgiftern “Skapa och hantera kommentarer i databasen”

#Extra

1. Scaffolding är spännande, kan du göra en kommandoradsklient med PHP som genererar nya klasser för kontroller och modeller? Kika hur de gjorde i ramverket Phalcon.

#Resultat & Redovisning

(ca: 1-2 studietimmar)

1. Skriv redovisningstext på din me-sida. Skriv ett stycke (minst 15 meningar) om kursmomentet. Reflektera över svårigheter, problem, lösningar, erfarenheter, lärdomar, resultatet, etc.

2. Se till att följande frågor besvaras i texten:

   • Vad tycker du om formulärhantering som visas i kursmomentet?
   • Vad tycker du om databashanteringen som visas, föredrar du kanske traditionell SQL?
   • Gjorde du några vägval, eller extra saker, när du utvecklade basklassen för modeller?
   • Beskriv vilka vägval du gjorde och hur du valde att implementera kommentarer i databasen.
   • Gjorde du extrauppgiften? Beskriv i så fall hur du tänkte och vilket resultat du fick.

3. Kopiera texten och lämna in den på redovisningen ITs tillsammans med en länk till din me-sida. Läraren kommer snabbt kolla igenom dem. Betyg är G (godkänd) eller komplettera (komplettera -> gör om -> gör bättre). Betyget baseras på din redovisningstext samt att din me-sida fungerar.

4. Ta ytterligare en kopia av redovisningstexten och gör ett inlägg i kursforumet. Visa upp vad du gjort och berätta att du är klar. Länka till din me-sida.

Klart! Läs gärna dina med-studenters inlämningar och ställ dina frågor i forumet. Se till att du får dina frågor besvarade.

#Revision history