Japanized Perl Resources Project[凍結]

[perldocjp-cvs 1259] CVS update: docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual

ktats****@users***** ktats****@users*****
2011年 4月 29日 (金) 02:02:32 JST

• 前の記事 [perldocjp-cvs 1258] CVS update: meta/modules
• 次の記事 [perldocjp-cvs 1260] CVS update: docs/modules/libwww-perl-5.813
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]

Index: docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual/Component.pod
diff -u docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual/Component.pod:1.1 docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual/Component.pod:1.2
--- docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual/Component.pod:1.1	Fri Apr 29 01:44:57 2011
+++ docs/modules/DBIx-Class-0.08127/lib/DBIx/Class/Manual/Component.pod	Fri Apr 29 02:02:31 2011
@@ -1,50 +1,98 @@
+=encoding utf8
 
 =head1 NAME
 
-DBIx::Class::Manual::Component - Developing DBIx::Class Components
+DBIx::Class::Manual::Component - DBIx::Class コンポーネントを開発する
 
-=head1 WHAT IS A COMPONENT
+=head1 コンポーネントとは何か
+
+=begin original
 
 A component is a module that can be added in to your DBIx::Class
 classes to provide extra functionality. A good example is the PK::Auto
 component which automatically retrieves primary keys that the database
 itself creates, after the insert has happened.
 
-=head1 USING
+=end original
+
+DBIx::Classのクラスに付加的な機能を提供するために追加するモジュールのことです。
+好例としては、PK::Autoコンポーネントがあります。PK::Autoは、insertの後に、
+データベース自身が、作ったプライマリキーを取り出します。
+
+=head1 使い方
+
+=begin original
 
 Components are loaded using the load_components() method within your
 DBIx::Class classes.
 
+=end original
+
+コンポーネントは、自分のDBIx::Class クラスの中に、 load_components() 
+メソッドを使って、ロードします。
+
   package My::Thing;
   use base qw( DBIx::Class::Core );
   __PACKAGE__->load_components(qw/InflateColumn::DateTime TimeStamp/);
 
+=begin original
+
 Generally you do not want to specify the full package name
 of a component, instead take off the DBIx::Class:: part of
 it and just include the rest.  If you do want to load a
 component outside of the normal namespace you can do so
 by prepending the component name with a +.
 
+=end original
+
+たいてい、コンポーネントの完全なパッケージ名を指定したくはないでしょうから、
+その代わりに、DBIx::Class:: の部分を外して、残りの部分だけを含めます。
+通常の名前空間以外のコンポーネントをロードしたいなら、
+コンポーネント名の前に + を付けてください。
+
   __PACKAGE__->load_components(qw/ +My::Component /);
 
+=begin original
+
 Once a component is loaded all of it's methods, or otherwise,
 that it provides will be available in your class.
 
+=end original
+
+コンポーネントがロードされると、全てのコンポーネントが提供する
+メソッドが自分のクラスで有効になります。
+
+=begin original
+
 The order in which is you load the components may be very
 important, depending on the component. If you are not sure,
 then read the docs for the components you are using and see
 if they mention anything about the order in which you should
 load them.
 
-=head1 CREATING COMPONENTS
+=end original
+
+コンポーネントをロードする順番は非常に重要です。コンポーネントに依存します。
+よくわからなければ、使っているコンポーネントのドキュメントを読み、
+ロードすべき順番について何か書かれているかを見てください。
+
+=head1 コンポーネントを作る
+
+=begin original
 
 Making your own component is very easy.
 
+=end original
+
+自分自身のコンポーネントを作るのはとても簡単です。
+
   package DBIx::Class::MyComp;
   use base qw(DBIx::Class);
   # Create methods, accessors, load other components, etc.
   1;
 
+=begin original
+
 When a component is loaded it is included in the calling
 class' inheritance chain using L<Class::C3>.  As well as
 providing custom utility methods, a component may also
@@ -52,6 +100,16 @@
 L<DBIx::Class::Row> and others.  For example, you
 could override the insert and delete methods.
 
+=end original
+
+コンポーネントがロードされると、呼び出しているクラスの、
+L<Class::C3>を使った、継承チェーンに含まれます。
+カスタムユーティリティメソッドを提供するのと同様に、
+コンポーネントが、他のコアコンポーネントで提供されている
+メソッドを上書きするかもしれません。L<DBIx::Class::Row>や
+その他のコンポーネントのように。
+例えば、insert と delete メソッドをオーバーライドできます。
+
   sub insert {
     my $self = shift;
     # Do stuff with $self, like set default values.
@@ -64,6 +122,8 @@
     return $self->next::method( @_ );
   }
 
+=begin original
+
 Now, the order that a component is loaded is very important.  Components
 that are loaded first are the first ones in the inheritance stack.  So, if
 you override insert() but the DBIx::Class::Row component is loaded first
@@ -71,65 +131,200 @@
 will be called first.  If you are unsure as to why a given method is not
 being called try printing out the Class::C3 inheritance stack.
 
+=end original
+
+こうなると、コンポーネントをロードする順番はとても重要です。
+最初にロードされるコンポーネントは、継承スタックの最初のものです。そのため、
+insert() をオーバーライドしたとして、DBIx::Class::Rowコンポーネントが最初に
+ロードされると、自分のinsert()は、決して呼ばれません。DBIx::Class::Row insert()
+が最初に呼ばれてしまいます。あたえたメソッドが呼ばれないかよくわからなければ、
+Class::C3 の継承スタックを出力してみてください。
+
   print join ', ' => Class::C3::calculateMRO('YourClass::Name');
 
+=begin original
+
 Check out the L<Class::C3> docs for more information about inheritance.
 
-=head1 EXISTING COMPONENTS
+=end original
+
+継承についてより詳しくは、L<Class::C3>のドキュメントをチェックしてください。
 
-=head2 Extra
+=head1 存在するコンポーネント
+
+=head2 付加的なもの
+
+=begin original
 
 These components provide extra functionality beyond
 basic functionality that you can't live without.
 
+=end original
+
+下記のコンポーネントは基本的な機能を越えた、
+これ無しでは生きていけないような、付加的な機能を提供します。
+
+=begin original
+
 L<DBIx::Class::CDBICompat> - Class::DBI Compatibility layer.
 
+=end original
+
+L<DBIx::Class::CDBICompat> - Class::DBI 互換レイヤ。
+
+=begin original
+
 L<DBIx::Class::FormTools> - Build forms with multiple interconnected objects.
 
+=end original
+
+L<DBIx::Class::FormTools> - 複数の関連するオブジェクトでフォームを作る。
+
+=begin original
+
 L<DBIx::Class::HTMLWidget> - Like FromForm but with DBIx::Class and HTML::Widget.
 
+=end original
+
+L<DBIx::Class::HTMLWidget> - FromFormと似ていますが、DBIx::Class とHTML::Widget。
+
+=begin original
+
 L<DBIx::Class::Ordered> - Modify the position of objects in an ordered list.
 
+=end original
+
+L<DBIx::Class::Ordered> - 整列されたリスト内のオブジェクトの位置を修正する。
+
+=begin original
+
 L<DBIx::Class::PK::Auto> - Retrieve automatically created primary keys upon insert.
 
+=end original
+
+L<DBIx::Class::PK::Auto> - insert で、自動的に作られたプライマリキーを取得する。
+
+=begin original
+
 L<DBIx::Class::QueriesTime> - Display the amount of time it takes to run queries.
 
+=end original
+
+L<DBIx::Class::QueriesTime> - クエリを実行するのにかかった時間を表示する。
+
+=begin original
+
 L<DBIx::Class::RandomStringColumns> - Declare virtual columns that return random strings.
 
+=end original
+
+L<DBIx::Class::RandomStringColumns> - ランダムな文字列を返す仮想カラムを宣言する。 
+
 L<DBIx::Class::UUIDColumns> - Implicit UUID columns.
 
+=begin original
+
 L<DBIx::Class::WebForm> - CRUD methods.
 
-=head2 Experimental
+=end original
+
+L<DBIx::Class::WebForm> - CRUD メソッド。
+
+=head2 実験的
 
 These components are under development, their interfaces may
 change, they may not work, etc.  So, use them if you want, but
 be warned.
 
+下記のコンポーネントは開発中です。インターフェースは代わるかもしれませんし、
+動かなかったりするかもしれません。お望みなら使ってください、
+ただし、注意してください。
+
+=begin original
+
 L<DBIx::Class::Validation> - Validate all data before submitting to your database.
 
-=head2 Core
+=end original
+
+L<DBIx::Class::Validation> - データベースに入れる前に全てのデータが正しいか確認する。
+
+=head2 コア
+
+=begin original
 
 These are the components that all, or nearly all, people will use
 without even knowing it.  These components provide most of
 DBIx::Class' functionality.
 
+=end original
+
+下記のコンポーネントは全ての、ほとんど全ての、人がそれを知らなくても使うでしょう。
+下記のコンポーネントはDBIx::Classの機能のほとんどを提供します。
+
+=begin original
+
 L<DBIx::Class::Core> - Loads various components that "most people" would want.
 
+=end original
+
+L<DBIx::Class::Core> - "ほとんどの人"が欲しい様々なコンポーネントをロードします。
+
+=begin original
+
 L<DBIx::Class::AccessorGroup> - Lets you build groups of accessors.
 
+=end original
+
+L<DBIx::Class::AccessorGroup> - アクセサのグルーを作ります。
+
+=begin original
+
 L<DBIx::Class::DB> - Non-recommended classdata schema component.
 
+=end original
+
+L<DBIx::Class::DB> - 非推奨のクラスデータスキーマコンポーネント。
+
+=begin original
+
 L<DBIx::Class::InflateColumn> - Automatically create objects from column data.
 
+=end original
+
+L<DBIx::Class::InflateColumn> - カラムデータから自動的にオブジェクトを作る。
+
+=begin original
+
 L<DBIx::Class::PK> - This class contains methods for handling primary keys and methods depending on them.
 
+=end original
+
+L<DBIx::Class::PK> - このクラスはプライマリキーを扱うメソッドとそれに依存するメソッドを含みます。
+
+=begin original
+
 L<DBIx::Class::Relationship> - Inter-table relationships.
 
+=end original
+
+L<DBIx::Class::Relationship> - テーブル間のリレーションシップ。
+
+=begin original
+
 L<DBIx::Class::ResultSourceProxy::Table> - Provides a classdata table object and method proxies.
 
+=end original
+
+L<DBIx::Class::ResultSourceProxy::Table> - クラスデータテーブルオブジェクトとメソッドプロキシを提供します。
+
+=begin original
+
 L<DBIx::Class::Row> - Basic row methods.
 
+=end original
+
+L<DBIx::Class::Row> - 基本的な列のメソッド。
+
 =head1 SEE ALSO
 
 L<DBIx::Class::Manual::Cookbook>
@@ -137,3 +332,18 @@
 =head1 AUTHOR
 
 Aran Clary Deltac <bluef****@cpan*****>
+
+
+=head1 翻訳について
+
+翻訳者：加藤敦 (ktat.****@gmail*****)
+
+Perlドキュメント日本語訳 Project にて、
+Perlモジュール、ドキュメントの翻訳を行っております。
+
+ http://perldocjp.sourceforge.jp/
+ http://sourceforge.jp/projects/perldocjp/
+ http://www.freeml.com/perldocjp/
+ http://www.perldoc.jp
+
+=cut

• 前の記事 [perldocjp-cvs 1258] CVS update: meta/modules
• 次の記事 [perldocjp-cvs 1260] CVS update: docs/modules/libwww-perl-5.813
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]