table of contents
Sympa::Request(3Sympa) | sympa 6.2.16 | Sympa::Request(3Sympa) |
NAME¶
Sympa::Request - Requests for operation
SYNOPSYS¶
use Sympa::Request; my $request = Sympa::Request->new($serialized, context => $list); my $request = Sympa::Request->new(context => $list, action => 'last');
DESCRIPTION¶
Sympa::Request inmplements serializable object representing requests by users.
Methods¶
- new ( [ $serialized, ] context => $that, action => $action, key => value, ... ] )
- Constructor. Creates a new Sympa::Request object.
Parameters:
- $serialized
- Serialized request.
- context => object
- Context. Sympa::List object, Robot or '*'.
- action => $action
- Name of requested action.
- key => value, ...
- Metadata and attributes.
Returns:
A new instance of Sympa::Request, or undef, if something went wrong.
- new_from_tuples ( key => value, ... )
- Constructor. OBSOLETED. Creates Sympa::Request object from paired options.
- dup ( )
- Copy constructor. Gets deep copy of instance.
- to_string ( )
- Serializer. Returns serialized data of object.
- cmd_line ( [ canonic => 1 ] )
- Instance method. TBD.
- handler ( )
- Instance method. Name of a subclass of Sympa::Request::Handler to process request.
- get_id ( )
- Instance method. Gets unique identifier of instance.
Context and metadata¶
Context and metadata given to constructor are accessible as hash elements of object. They are given by request spool. See "Context and metadata" in Sympa::Spool::Auth for details.
Attributes¶
These are accessible as hash elements of objects. There are attributes including:
- {custom_attribute}
- Custom attribute connected to requested action.
- {gecos}
- Display name of user sending request.
- {sender}
- E-mail of user who sent the request.
Serialization¶
Sympa::Request object includes number of slots as hash items: metadata, context and attributes. Metadata including context are given by spool: See "Marshaling and unmarshaling metadata" in Sympa::Spool.
Logically, objects are stored into physical spool as serialized form and deserialized when they are fetched from spool. Attributes are encoded in "X-Sympa-*:" pseudo-header fields.
See also "Serialization" in Sympa::Message for example.
SEE ALSO¶
Sympa::Request::Collection, Sympa::Request::Handler, Sympa::Request::Message, Sympa::Spool::Auth.
HISTORY¶
Sympa::Request appeared on Sympa 6.2.10.
2016-11-25 | 6.2.16 |