69 lines
1.6 KiB
Perl
69 lines
1.6 KiB
Perl
package WebGUI::Id;
|
|
|
|
|
|
=head1 LEGAL
|
|
|
|
-------------------------------------------------------------------
|
|
WebGUI is Copyright 2001-2005 Plain Black Corporation.
|
|
-------------------------------------------------------------------
|
|
Please read the legal notices (docs/legal.txt) and the license
|
|
(docs/license.txt) that came with this distribution before using
|
|
this software.
|
|
-------------------------------------------------------------------
|
|
http://www.plainblack.com info@plainblack.com
|
|
-------------------------------------------------------------------
|
|
|
|
=cut
|
|
|
|
use Digest::MD5;
|
|
use strict;
|
|
use Time::HiRes qw( gettimeofday usleep );
|
|
use WebGUI::Session;
|
|
|
|
BEGIN {
|
|
srand;
|
|
}
|
|
|
|
|
|
=head1 NAME
|
|
|
|
Package WebGUI::Id
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This package generates global unique ids, sometimes called GUIDs. A global unique ID is guaranteed to be unique everywhere and at everytime.
|
|
|
|
B<NOTE:> There is no such thing as perfectly unique ID's, but the chances of a duplicate ID are so minute that they are effectively unique.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use WebGUI::Id;
|
|
|
|
my $id = WebGUI::Id::generate();
|
|
|
|
=head1 FUNCTIONS
|
|
|
|
These subroutines are available from this package:
|
|
|
|
=cut
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 generate
|
|
|
|
This function generates a global unique id.
|
|
|
|
=cut
|
|
|
|
sub generate {
|
|
my($s,$us)=gettimeofday();
|
|
my($v)=sprintf("%09d%06d%10d%06d%255s",rand(999999999),$us,$s,$$,$WebGUI::Session::session{config}{defaultSiteName});
|
|
my $id = Digest::MD5::md5_base64($v);
|
|
$id =~ s/\+/_/g;
|
|
$id =~ s/\//-/g;
|
|
return $id;
|
|
}
|
|
|
|
1;
|
|
|
|
|