Module: UWA/Class/Model

Example

// The following is a brief and contrived example, but it demonstrates defining a model
// with a custom business logic method (adopt method), setting an attribute,
// saving it to the backend, ...

define('MyProject/Model/Person', [
    'UWA/Class/Model',
    'UWA/Class/Debug',
    'UWA/String'
], function (Model, Debug, UWAString) {

    'use strict';

    var Person = Model.extend(Debug, {

        urlRoot: '/person',

        defaults: {
            name: 'Foetus',
            age: 0,
            child: ''
        },

        setup: function () {

            var that = this;
            that.log("Welcome to this world");

            that.addEvent("onChange:name", function (person) {
                that.log(UWAString.format('Changed my name to {0}', person.get("name")));
            });

            that.addEvent('onValidationFailure', function (person, error) {
                person.log(error);
            })
        },

        // Validate data before you set or save it :
        validate: function (attributes) {
            if (attributes.age < 0 && attributes.name !== 'Benjamin Button') {
                return "Only Ben Button can be negative years old!";
            }
        },

        // some business logic on my model :
        adopt: function (newChildsName) {
            this.set({
                child: newChildsName
            });
            this.log(UWAString.format('{0} just adopted {1}', this.get(name), newChildsName));
        }
    });

    return Person;
});

require(['MyProject/Model/Person'], function (Person) {

    var angelina = new Person({
        name: "Jolie",
        age: 38,
        child: 'Shiloh'
    });

    alert(angelina.isNew()); // alerts 'true'

    angelina.adopt('Pax Thien');

    var child = angelina.get("child"); // returns 'Pax Thien'

    // A request PUT /user with a payload containing the attributes
    // will be performed.
    // The backend should persist the data and return a response containing the new `id`
    angelina.save({
        age: 39
    }, {
        wait: true,
        onComplete: function (person, response) {
            person.log('Successfully saved!');
        },
        onFailure: function (person, error) {
            person.log(person.toJSON());
            person.log(error.responseText);
        }
    });

    // Assuming that there is already a person saved in DB
    // with an ID that is '2' :
    var brad = new Person({
        id:2
    });

    alert(brad.isNew()); // alerts 'false'

    // This fetch call will perform a GET /user/1 request
    // The backend should return the id, name and email from the database.
    brad.fetch({
        onComplete: function (brad) {
            brad.log('I have been fetched from IMDB.');
        }
    });

    // Because brad has an ID, a request DELETE /person/2 will be
    // performed :
    brad.destroy({
        onComplete: function (bradZombie) {
            bradZombie.log('I have been removed from IMDB.');
        }
    });
});