NAME

Egg::Model::DBIC - DBIx::Class for Egg Model.

SYNOPSIS

  __PACKAGE__->egg_startup(
    ...
    .....
  
    MODEL=> [
      [ DBIC => { schema_names => [qw/ MySchema /] } } ],
     ],
  
    );

  # The object of MyApp::Model::DBIC::MySchema is acquired.
  my $model= $e->model('MySchema');
  
  # If the transaction is effective.
  $model->storage->txn_begin;
  
  # The object of MyApp::Model::DBIC::MySchema::Moniker is acquired.
  my $db = $model->resultset('Moniker');
     or
  my $db = $e->model('myscema:moniker');
  
  $db->search( ... );
  
  $model->storage->txn_commit;
    or
  $model->storage->txn_rollback;

DESCRIPTION

It is MODEL to use DBIx::Class.

Appropriate Schema is generated by using the helper for use.

  % perl myapp_helper.pl Model:DBIC MySchema -d dbi:Pg:dbname=dbname -u user -p passwd

/path/to/MyApp/lib/MyApp/Model/DBIC/MySchema is generated with this.

* Please refer to the document of "Egg::Helper::Model::DBIC " for details for helper's use.

And, the setting of following MODEL is added.

  MODEL => [ [ DBIC => {} ] ],

All modules under the control of/path/to/MyApp/lib/MyApp are read by this as Schema. * Specification becomes empty HASH.

If the module such as Schema for the test that doesn't want to be read exists together, the name of Schema is specified.

  MODEL=> [
    [ DBIC => { schema_names => [qw/ MySchema /] } ],
   ],

Schema can be acquired for the small letter specification.

  my $schema = $e->model('myschema');

When the source is acquired, it specifies it by the small letter without fail.

  my $source = $e->mode('myschema:source');

When the object is acquired, it only has to operate it DBIx::Class originally.

Please refer to the document of DBIx::Class for details.

CREATE SCHEMA SOURCE

Please note the following respect when you make the Schema file by oneself.

• The Schema module succeeds to Egg::Model::DBIC::Schema.

  a necessary method for Schema to operate on Egg such as 'config' is added.

    package MyApp::MySchema;
    use strict;
    use warnings;
    ## use base 'DBIx::Class::Schema';
    
    use base qw/Egg::Model::DBIC::Schema/;
    
    __PACKAGE__->config(
      dsn      => 'dbi:Pg:dbname=mydata',
      user     => 'user',
      password => 'passwd',
      );
    
    ...
    .....

SEE ALSO

DBIx::Class, DBIx::Class::Schema, Egg::Model::DBIC::Schema, Egg::Model::DBIC::Moniker, Egg::Helper::Model::DBIC, Egg::Release,

AUTHOR

Masatoshi Mizuno, <lushe@cpan.org>

COPYRIGHT

Copyright (C) 2007 by Bee Flag, Corp. <http://egg.bomcity.com/>, All Rights Reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

cpanm Egg::Model::DBIC

perl -MCPAN -e shell
install Egg::Model::DBIC