X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=78d66973a95e2dc3905d3a2d7e501ee3c02f49bf;hb=0755d3d10f1d3ad5203ca477b915b04b4e5b1d00;hp=3a7f64afe55a1f353baaf5e26985c5be33a7fb16;hpb=cbf59b953cb1192aef400bf60dbc22ae78b80f1d;p=dbsrgits%2FDBIx-Class-UUIDColumns.git diff --git a/README b/README index 3a7f64a..78d6697 100644 --- a/README +++ b/README @@ -2,9 +2,12 @@ NAME DBIx::Class::UUIDColumns - Implicit uuid columns SYNOPSIS - package Artist; - __PACKAGE__->load_components(qw/UUIDColumns Core DB/); - __PACKAGE__->uuid_columns( 'artist_id' ); + In your DBIx::Class table class: + + __PACKAGE__->load_components(qw/UUIDColumns ... Core/); + __PACKAGE__->uuid_columns('artist_id'); + + Note: The component needs to be loaded *before* Core. DESCRIPTION This DBIx::Class component resembles the behaviour of Class::DBI::UUID, @@ -29,28 +32,33 @@ DESCRIPTION __PACKAGE__->uuid_class('::Data::UUID'); __PACKAGE__->uuid_class('MyUUIDGenerator'); - Note that the component needs to be loaded before Core. - METHODS - uuid_columns(@columns) - Takes a list of columns to be filled with uuids during insert. + get_uuid + Returns a uuid string from the current uuid_maker. + + insert + Inserts a new uuid string into each column in "uuid_columns". - __PACKAGE__->uuid_columns('id'); + uuid_columns + Gets/sets the list of columns to be filled with uuids during insert. - uuid_class($classname) + __PACKAGE__->uuid_columns('artist_id'); + + uuid_class Takes the name of a UUIDMaker subclass to be used for uuid value generation. This can be a fully qualified class name, or a shortcut name starting with :: that matches one of the available - DBIx::Class::UUIDMaker subclasses: + DBIx::Class::UUIDColumns::UUIDMaker subclasses: __PACKAGE__->uuid_class('CustomUUIDGenerator'); # loads CustomeUUIDGenerator - __PACKAGE->uuid_class('::Data::UUID'); + __PACKAGE__->uuid_class('::Data::UUID'); # loads DBIx::Class::UUIDMaker::Data::UUID; - Note that "uuid_class" chacks to see that the specified class isa - DBIx::Class::UUIDMaker subbclass and throws and exception if it isn't. + Note that "uuid_class" checks to see that the specified class isa + DBIx::Class::UUIDColumns::UUIDMaker subclass and throws and exception if + it isn't. uuid_maker Returns the current UUIDMaker instance for the given module. @@ -58,10 +66,13 @@ METHODS my $uuid = __PACKAGE__->uuid_maker->as_string; SEE ALSO - DBIx::Class::UUIDMaker + DBIx::Class::UUIDColumns::UUIDMaker + +AUTHOR + Chia-liang Kao -AUTHORS - Chia-liang Kao Chris Laco +CONTRIBUTERS + Chris Laco LICENSE You may distribute this code under the same terms as Perl itself.