Takes an hash which keys will be attached to the instance, $this. You can also use "install_in_package()" to create setters/getters or simply let the methods been redispatched automaticly.

Parameters

"parameters:Hash"

Returns

"WebService::GData"

Example:

    my $object = new WebService::GData(firstname=>'doe',lastname=>'john',age=>'123');

    $object->{firstname};#doe
    $object->firstname;#doe
    $object->firstname('billy');
    $object->firstname;#billy

This method is called by the constructor "new()". This function receives the parameters set in "new()" and assign the key/values pairs to the instance. You should overwrite it and add your own logic if necessary.

Default implementation:

    sub __init {
        my ($this,%params) = @_;
        while(my ($prop,$val)=each %params){
            $this->{$prop}=$val;
        }
    }

Overload the stringification quotes and return the object. You should overwrite it to create a specific output (Dump the object, display a readable representation...).

Overload the comparison "==" by checking that boch objects are hosted in the same memory slot.

This method catches all calls to undefined methods to which no parameters are passed. If you call $instance->unknown_method, the "__get" method will return $instance->{unknown_method} by default. The "__get" method gets the instance and the name of the function has parameters.

Below is the default implementation:

sub __get { my ($this,$func) = @_; return $this->{$func}; }

This method catches all calls to undefined methods to which parameters are passed. If you call $instance->unknown_method($val,$val2), the "__set" method will set the parameters to $instance->{unknown_method} by default. When several parameters are passed, they are saved as an array reference. The "__set" method gets the instance,the name of the function and the parameters as its own arguments.

Below is the default implementation:

sub __set { my ($this,$func,@args) = @_; $this->{$func}= @args == 1 ? $args[0] : \@args; return $this; }

Install in the package the methods/subs specified. Mostly use to avoid writting boiler plate getter/setter methods and a bit more efficient than AUTOLOAD methods as they are installed directly into the package so it will not climb up a function chain call.

Parameters

"subnames:ArrayRef" - Should list the name of the methods you want to install in the package.

"callback:Sub" - The callback will receive the name of the function. This callback should itself send back a function.

"package_name:Scalar" (optional) - Add functions at distance by specifying an other module.

Returns

"void"

Example:

    package Basic::User;
    use WebService::GData;
    use base 'WebService::GData';
    
    #install simple setters; it could also be setter/getters
        
    WebService::GData::install_in_package([qw(firstname lastname age gender)],sub {
            my $func = shift;#firstname then lastname then age...
            return sub {
                my $this = shift;
                return $this->{$func};
            }
    });

    1;

    #in user code:

    my $user = new Basic::User(firstname=>'doe',lastname=>'john',age=>100,gender=>'need_confirmation');

    $user->age;#100
    $user->firstname;#doe

Create a method that is private to the package. Calling a private function from outside of the package will throw an error.

You can import the private method:

    use WebService::GData 'private';

Parameters

"function_name_with_sub:Hash" - Accept an hash which key is the function name and value a sub.

Returns

"void"

Throws

"error:RefHash" - an hash containing the code: 'forbidden_access' and the content:'private method called outside of its package'.

Example:

    package Basic::User;
    use WebService::GData 'private';
    use base 'WebService::GData';
    
    private my_secret_method => sub {
                
    };  #note the comma

    1;

    #in user code:
        
    my $user = new Basic::User();

    $user->my_secret_method();#throw an error
        
    eval {
        $user->my_secret_method();
    };
    if(my $error = $@){
        #$error->{code};
        #$error->{content};
    }

Overwrite a method so that it does nothing... Some namespaces inherit from functionalities that are not required. The functions will still be available but will just return the instance.

Parameters

"functions:ArrayRef" - array reference containing the functions to disable

"package:Scalar*" - (optional) By default it uses the package in which it is called but you can specify a package.

Returns

"void"

Example:

    package Basic::User;
    use WebService::GData;
    use base 'WebService::GData::Feed';
    
    WebService::GData::disable([qw(etag title)]);

    1;

    #in user code:
        
    my $user = new Basic::User();

    $user->etag("ddd")->title("dddd");#does nothing at all