Pan Fan (nightsailer) > AnyMongo-0.03 > AnyMongo::BSON::OID

Download:
AnyMongo-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  1
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

AnyMongo::BSON::OID - A Mongo ObjectId

VERSION ^

version 0.03

SYNOPSIS ^

SYNOPSIS ^

If no _id field is provided when a document is inserted into the database, an _id field will be added with a new MongoDB::OID as its value.

    my $id = $collection->insert({'name' => 'Alice', age => 20});

$id will be a MongoDB::OID that can be used to retreive or update the saved document:

    $collection->update({_id => $id}, {'age' => {'$inc' => 1}});
    # now Alice is 21

To create a copy of an existing OID, you must set the value attribute in the constructor. For example:

    my $id1 = MongoDB::OID->new;
    my $id2 = MongoDB::OID->new(value => $id1->value);

Now $id1 and $id2 will have the same value.

Warning: at the moment, OID generation is not thread safe.

DESCRIPTION ^

SEE ALSO ^

Core documentation on object ids: http://dochub.mongodb.org/core/objectids.

ATTRIBUTES ^

value

The OID value. A random value will be generated if none exists already. It is a 24-character hexidecimal string (12 bytes).

Its string representation is the 24-character string.

METHODS ^

to_string

    my $hex = $oid->to_string;

Gets the value of this OID as a 24-digit hexidecimal string.

get_time

    my $date = DateTime->from_epoch(epoch => $id->get_time);

Each OID contains a 4 bytes timestamp from when it was created. This method extracts the timestamp.

TO_JSON

    my $json = JSON->new;
    $json->allow_blessed;
    $json->convert_blessed;

    $json->encode(MongoDB::OID->new);

Returns a JSON string for this OID. This is compatible with the strict JSON representation used by MongoDB, that is, an OID with the value "012345678901234567890123" will be represented as {"$oid" : "012345678901234567890123"}.

NAME ^

AnyMongo::ObjectId

AUTHOR ^

COPYRIGHT ^

AUTHORS ^

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2010 by Pan Fan(nightsailer).

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: