dbix::class::helper::resultset::autoremovecolumns(3pm) [debian man page]

DBIx::Class::Helper::ResultSet::AutoRemoveColumns(3pm)	User Contributed Perl Documentation DBIx::Class::Helper::ResultSet::AutoRemoveColumns(3pm)

NAME

       DBIx::Class::Helper::ResultSet::AutoRemoveColumns - Automatically remove columns from a ResultSet

VERSION

       version 2.013002

SYNOPSIS

	package MySchema::Result::Bar;

	use strict;
	use warnings;

	use parent 'DBIx::Class::Core';

	__PACKAGE__->table('KittenRobot');
	__PACKAGE__->add_columns(
	   id => {
	      data_type 	=> 'integer',
	      is_auto_increment => 1,
	   },
	   kitten => {
	      data_type 	=> 'integer',
	   },
	   robot => {
	      data_type 	=> 'text',
	      is_nullable	=> 1,
	   },
	   your_mom => {
	      data_type 	=> 'blob',
	      is_nullable	=> 1,
	      remove_column	=> 0,
	   },
	);

	1;

	package MySchema::ResultSet::Bar;

	use strict;
	use warnings;

	use parent 'DBIx::Class::ResultSet';

	__PACKAGE__->load_components('Helper::ResultSet::AutoRemoveColumns');

DESCRIPTION

       This component automatically removes "heavy-weight" columns.  To be specific, columns of type "text", "ntext", "blob", "clob", or "bytea".
       You may use the "remove_column" key in the column info to specify directly whether or not to remove the column automatically. See "NOTE" in
       DBIx::Class::Helper::ResultSet for a nice way to apply it to your entire schema.

METHODS

   _should_column_fetch
	$self->_should_column_fetch('kitten')

       returns true if a column should be fetched or not.  This fetches a column if it is not of type "text", "ntext", "blob", "clob", or "bytea"
       or the "remove_column" is set to true.  If you only wanted to explicitly state which columns to remove you might override this method like
       this:

	sub _should_column_fetch {
	   my ( $self, $column ) = @_;

	   my $info = $self->column_info($column);

	   return !defined $info->{remove_column} || $info->{remove_column};
	}

   fetchable_columns
       simply returns a list of columns that are fetchable.

AUTHOR

       Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Arthur Axel "fREW" Schmidt.

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

perl v5.14.2							    2012-06-18		    DBIx::Class::Helper::ResultSet::AutoRemoveColumns(3pm)

DBIx::Class::Helper::Row::ToJSON(3pm)			User Contributed Perl Documentation		     DBIx::Class::Helper::Row::ToJSON(3pm)

NAME

       DBIx::Class::Helper::Row::ToJSON - Remove the boilerplate from your TO_JSON functions

VERSION

       version 2.013002

SYNOPSIS

	package MyApp::Schema::Result::KittenRobot;

	use base 'DBIx::Class::Core';

	__PACKAGE__->load_components(qw{Helper::Row::ToJSON});

	__PACKAGE__->table('KittenRobot');
	__PACKAGE__->add_columns(
	   id => {
	      data_type 	=> 'integer',
	      is_auto_increment => 1,
	   },
	   kitten => {
	      data_type 	=> 'integer',
	   },
	   robot => {
	      data_type 	=> 'text',
	      is_nullable	=> 1,
	   },
	   your_mom => {
	      data_type 	=> 'blob',
	      is_nullable	=> 1,
	      is_serializable	=> 1,
	   },
	);

	1;

       This helper adds a JSON method like the following:

	sub TO_JSON {
	   return {
	      id       => $self->id,
	      kitten   => $self->kitten,
	      # robot  => $self->robot,    # <-- doesn't serialize text columns
	      your_mom => $self->your_mom, # <-- normally wouldn't but explicitly
					   #	 asked for in the column spec above
	   }
	}

METHODS

   _is_column_serializable
	$self->_is_column_serializable('kitten')

       returns true if a column should be serializable or not.	Currently this marks everything as serializable unless "is_serializable" is set to
       false, or "data_type" is a "blob", "text", or "ntext" columns.  If you wanted to only have explicit serialization you might override this
       method to look like this:

	sub _is_column_serializable {
	   my ( $self, $column ) = @_;

	   my $info = $self->column_info($column);

	   return defined $info->{is_serializable} && $info->{is_serializable};
	}

   serializable_columns
	$self->serializable_columns

       simply returns a list of columns that TO_JSON should serialize.

   TO_JSON
	$self->TO_JSON

       returns a hashref representing your object.  Override this method to add data to the returned hashref:

	sub TO_JSON {
	   my $self = shift;

	   return {
	      customer_name => $self->customer->name,
	      %{ $self->next::method },
	   }
	}

AUTHOR

       Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Arthur Axel "fREW" Schmidt.

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

perl v5.14.2							    2012-06-18				     DBIx::Class::Helper::Row::ToJSON(3pm)