<?php
/*
* Pieni esimerkki PHP5:n uusista olio-ohjelmointiin liittyvistä ominaisuuksista. ( OSA-1 )
* (C) neon@neon-line.net 2003
* julkaistu BSD-lisenssin alla
*
* HUOMAA: kyseinen koodi ei itsessään tee yhtään mitään, vaan on puhtaasti esimerkki.
*
* Luodaan kantaluokka, joka sisältää virheenkäsittelyn ja kaiken muun toiminnallisuuden, paitsi ulkoasun käsittelyn.
* Ulkoasuun liittyvät funktion määritellään abstrakteiksi, joka pakottaa laajennusluokan määrittelemään ne.
* Muut funktiot ovat lopullisia ja suojattuja
*/
abstract class BaseClass {
    /* suojattu muuttuja var */
    protected $var;
    /* suojattu muuttuja var2 */
    protected $var2;
    /* lopullinen julkinen funktio main */
    public final function main() {
        /* virheenkeräys osio alkaa */
        try {
            $this->getSomeInformation();
            foreach($this->var $this->var2) {
                if($this->var2 === false)
                    throw new Exception("uhh.. got false"); /* "heitetään" virhe käsittejälle */
                $this->function1();
                $this->function2();
            }
        }
        /* virheiden käsittely */
        catch(Exception $exeption) {
            /* käsitellään virheet
             * Huomaa, että virheitä ei ole pakko "heittää" throw:in avulla, vaan myös normaalit funktiot kuten
             * fopen() jne. luovat niitä. Tarkoituksena on vain keskittää KAIKKIEN virheiden käsittely yhteen paikkaan
             * ja näin helpottaa ohjelmointia ja koodin luettavuutta.
            */
        }
    }
    /* suojattu lopullinen funktio getsomeinformation */
    protected final function getSomeIntormation() {       
        $this->var = array();
    }
    /* abstraktit eli määrittelemättömät funktiot function1 ja function2 */
    protected abstract function function1();
    protected abstract function function2();
}
/*
* InterfaceClass määrittelee ja jatkaa luokkaa BaseClass.
*/
class InterfaceClass extends BaseClass {
    /* määritellään (ennen) abstraktit funktiot function1() ja function2() */
    protected function function1() {
        echo $this->var2;
    }
    protected function function2() {
        echo $this->var2;
    }
}
/*
* Käytännön sovelluksia yllä olevalle rakenteelle voi olla esimerkiksi uutisointijärjestelmä, jossa tarvitaan XML,HTML sekä PDF
* käyttöliittymä. Kantaluokassa määritellään kaikki toiminnallisuus ja lapsiluokassa määritellään vain ulosantiin liittyvät
* ominaisuudet. 
*/

?>