Mozilla/mozilla/webtools/PLIF/PLIF/Service/UserField.pm

# -*- Mode: perl; tab-width: 4; indent-tabs-mode: nil; -*-
#
# This file is MPL/GPL dual-licensed under the following terms:
# 
# The contents of this file are subject to the Mozilla Public License
# Version 1.1 (the "License"); you may not use this file except in
# compliance with the License. You may obtain a copy of the License at
# http://www.mozilla.org/MPL/
#
# Software distributed under the License is distributed on an "AS IS"
# basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
# the License for the specific language governing rights and
# limitations under the License.
#
# The Original Code is PLIF 1.0.
# The Initial Developer of the Original Code is Ian Hickson.
#
# Alternatively, the contents of this file may be used under the terms
# of the GNU General Public License Version 2 or later (the "GPL"), in
# which case the provisions of the GPL are applicable instead of those
# above. If you wish to allow use of your version of this file only
# under the terms of the GPL and not to allow others to use your
# version of this file under the MPL, indicate your decision by
# deleting the provisions above and replace them with the notice and
# other provisions required by the GPL. If you do not delete the
# provisions above, a recipient may use your version of this file
# under either the MPL or the GPL.

package PLIF::Service::UserField;
use strict;
use vars qw(@ISA);
use PLIF::Service;
@ISA = qw(PLIF::Service);
1;

# This class implements a service instance -- you should never call
# getService() to obtain a copy of this class or its descendants.

sub provides {
    my $class = shift;
    my($service) = @_;
    return ($service eq 'user.field' or
            $service eq 'user.field.'.$class->type or
            $class->SUPER::provides($service));
}

# the 'data' field of field descriptions means different things
# depending on the category. For 'contact' category user fields, it
# represents a string that is prefixed to the data of the user field
# to obtain the username that should be used for this user field.

# the 'mode' field of field descriptions is one of the following:
#  0: enabled
#  1: disabled (but shown) -- XXX do we need this?
#  2: hidden
# XXX need a way to make this extensible

sub init {
    my $self = shift;
    my($app, $user, $fieldID, $fieldCategory, $fieldName, $fieldTypeData, $fieldMode, $fieldData) = @_;
    $self->SUPER::init($app);
    # do not hold on to $user!
    $self->app($app);
    $self->userID($user->userID); # only change this if it started as undef
    $self->fieldID($fieldID); # change this at your peril
    $self->category($fieldCategory); # change this at your peril
    $self->name($fieldName); # change this at your peril
    $self->typeData($fieldTypeData); # change this at your peril
    $self->mode($fieldMode); # change this at your peril
    $self->{'data'} = $fieldData; # read this via $field->data and write via $field->data($foo)
    # don't forget to update the 'hash' function if you add more member variables here
    $self->{'_DATAFIELD'} = 'data';
    $self->{'_DELETE'} = 0;
    $self->{'_DIRTY'} = 0;
}

sub type {
    my $self = shift;
    $self->notImplemented();
}

sub validate {
    # should be passed candidate $data
    return 1;
}

# deletes this field from the database
sub remove {
    my $self = shift;
    $self->{'_DELETE'} = 1;
    $self->{'_DIRTY'} = 1;
}

sub data {
    my $self = shift;
    if (@_) {
        my($value) = @_;
        if (defined($value)) {
            $self->assert($self->validate($value), 0, 'tried to set data to invalid value'); # XXX might want to provide more debugging data
            $self->{'data'} = $value;
            $self->{'_DIRTY'} = 1;
        } else {
            $self->remove();
        }
    } else {
        return $self->{$self->{'_DATAFIELD'}};
    }
}

sub hash {
    my $self = shift;
    return $self->data;
}

# Methods specifically for 'contact' category fields

# contact fields have usernames made of the field type data part
# followed by the field data itself
sub username {
    my $self = shift;
    $self->assert($self->category eq 'contact', 0, 'Tried to get the username from the non-contact field \''.($self->fieldID).'\'');
    return $self->typeData.$self->data;
}

sub address {
    my $self = shift;
    $self->assert($self->category eq 'contact', 0, 'Tried to get the address of the non-contact field \''.($self->fieldID).'\'');
    return $self->data;
}

sub prepareChange {
    my $self = shift;
    my($newData) = @_;
    $self->assert($self->validate($newData), 0, 'tried to prepare change to invalid value'); # XXX might want to provide more debugging data
    $self->newData($newData);
}

# sets a flag so that calls to ->data and ->address will return the
# value as stored in the database
sub returnOldData {
    my $self = shift;
    my($newData) = @_;
    $self->{'_DATAFIELD'} = 'data';
}

# sets a flag so that calls to ->data and ->address will return the
# value set by prepareChange() rather than the actual value of the
# field (as stored in the database)
sub returnNewData {
    my $self = shift;
    my($newData) = @_;
    $self->{'_DATAFIELD'} = 'newData';
}


# Internal Routines

sub DESTROY {
    my $self = shift;
    if ($self->{'_DIRTY'}) {
        $self->write();
    }
    $self->SUPER::DESTROY(@_);
}

sub write {
    my $self = shift;
    if ($self->{'_DELETE'}) {
        $self->app->getService('dataSource.user')->removeUserField($self->app, $self->userID, $self->fieldID);
    } else {
        $self->app->getService('dataSource.user')->setUserField($self->app, $self->userID, $self->fieldID, $self->data);
    }
}