1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
# Copyright (C) 2004 Domingo Alcázar Larrea
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the version 2 of the GNU General
# Public License as published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307
package DIME::Message;
$DIME::Message::VERSION = '0.04';
use 5.008;
use strict;
use warnings;
use Data::UUID;
use IO::Scalar;
# Preloaded methods go here.
sub new
{
my $class = shift;
my @payloads;
my $this = {
_PAYLOADS => \@payloads,
};
return bless $this, $class;
}
# Add a payload to a Message
sub add_payload
{
my $self = shift;
my $payload = shift;
my @payloads = @{$self->{_PAYLOADS}};
my $last_payload;
# If there is not payloads, we set it as the begin payload
$payload->mb(1) if(@payloads == 0);
# Set as the end payload
$payload->me(1);
$last_payload = $payloads[@payloads-1];
$last_payload->me(0) if(defined($last_payload));
push(@{$self->{_PAYLOADS}},$payload);
}
# Return array with the records
sub payloads
{
my $self = shift;
return @{$self->{_PAYLOADS}};
}
sub print
{
my $self = shift;
my $out = shift;
my $howmany = $self->payloads();
for(my $i=0;$i<$howmany;$i++)
{
$self->{_PAYLOADS}->[$i]->print($out);
}
}
sub print_data
{
my $self = shift;
my $data;
my $io = IO::Scalar->new(\$data);
$self->print($io);
$io->close();
return \$data;
}
1;
=encoding UTF-8
=head1 NAME
DIME::Message - this class implements a DIME message
=head1 SYNOPSIS
use DIME::Message;
use DIME::Payload;
my $payload = DIME::Payload->new;
$payload->attach(Path => '/mydata/content.txt');
$message->add_payload($payload);
my $ref_dime_message = $message->print_data();
print $$ref_dime_message;
=head1 DESCRIPTION
DIME::Message is a collection of DIME::Payloads. To get a valid Message object, you can generate one adding different DIME::Payloads objects, or use DIME::Parser class to parse an existing DIME message.
=head1 AUTHOR
Domingo Alcazar Larrea, E<lt>dalcazar@cpan.orgE<gt>
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2004 Domingo Alcázar Larrea
This program is free software; you can redistribute it and/or
modify it under the terms of the version 2 of the GNU General
Public License as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307
=cut
|
