X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FManual%2FGlossary.pod;h=4feb8e1770fcdabba84e4f7e0a7f04dc76e83512;hb=ee6e8c79bfa5b113aa94c850405b37b677410ef8;hp=2cd6db3a1f7234d9d8255333530da4090221bb3a;hpb=8273e845426f0187b4ad6c4a1b42286fa09a648f;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/Manual/Glossary.pod b/lib/DBIx/Class/Manual/Glossary.pod index 2cd6db3..4feb8e1 100644 --- a/lib/DBIx/Class/Manual/Glossary.pod +++ b/lib/DBIx/Class/Manual/Glossary.pod @@ -73,12 +73,14 @@ At least one L class is needed per database. =head2 Result class A Result class defines both a source of data (usually one per table), -and the methods that will be available in the L objects created -using that source. +and the methods that will be available in the L objects +created using that source. One Result class is needed per data source (table, view, query) used in your application, they should inherit from L. +See also: L + =head2 ResultSource ResultSource objects represent the source of your data, these are @@ -101,23 +103,43 @@ See also: L =head2 Record -See Row. +See Result. =head2 Row -Row objects contain your actual data. They are returned from ResultSet objects. +See Result. + +=head2 Result + +Result objects contain your actual data. They are returned from +ResultSet objects. These are sometimes (incorrectly) called +row objects, including older versions of the DBIC documentation. + +See also: L =head2 Object -See Row. +See Result. =head2 join +See Join. + =head2 prefetch +Similiar to a join, except the related result objects are fetched and +cached for future use, instead of used directly from the ResultSet. This +allows you to jump to different relationships within a Result without +worrying about generating a ton of extra SELECT statements. =head1 SQL TERMS +=head2 CRUD + +Create, Read, Update, Delete. A general concept of something that can +do all four operations (INSERT, SELECT, UPDATE, DELETE), usually at a +row-level. + =head2 Join This is an SQL keyword, it is used to link multiple tables in one SQL @@ -135,4 +157,12 @@ can be found in L. =head2 Related data In SQL, related data actually refers to data that are normalised into -the same table. (Yes. DBIC does mis-use this term). +the same table. (Yes. DBIC does mis-use this term.) + +=head1 AUTHOR AND CONTRIBUTORS + +See L and L in DBIx::Class + +=head1 LICENSE + +You may distribute this code under the same terms as Perl itself.