Changeset 12972 for docs

Timestamp:

06/01/08 15:11:50 (5 years ago)

Author:

ka2u

Message:

Recipe1 completed, but probably I have some mistakes.

Files:

• docs/moose-ja/Moose/Cookbook/Recipe1.ja.pod (modified) (16 diffs)

docs/moose-ja/Moose/Cookbook/Recipe1.ja.pod

@@ -48 +48 @@
 
 すべてのPerl5のクラスのように、Mooseのクラスはpackageを宣言します。
-MooseはC<use Moose>することによりstrictとwarningsを有効にします。
+MooseはC<use Moose>するだけでstrictとwarningsを有効にします。
 そして小さな失敗をせずにすむでしょう。
 
@@ -57 +57 @@
 
 Mooseをロードすることにより、package内でMooseの"environment"を
-ロード可能にします。この意味はいくつかのMoose "Keywords"である
-functionをインポートするということです。
+ロード可能にします。これはいくつかのMoose "keywords"である
+関数をimportするということです。これらは変わったことではなく
+以前からあるexportされた関数です。
 
 Another important thing happens at this stage as well. Moose will 
@@ -71 +72 @@
 その他に重要なことがこのステージではおきます。Mooseは自動的にあなたの
 packageのスーパークラスをL<Moose::Object>にします。
-これをする理由はあなたのクラスがL<Moose::Object>を継承し、役に立つものを
-提供します(コンストラクタなど; 詳しくはL<Moose::Object>を参照)。
+これをする理由はあなたのクラスがL<Moose::Object>を継承し、与えられる利点
+を得られるようにします(コンストラクタなど; 詳しくはL<Moose::Object>を参照)。
 しかしながら、あなたがL<Moose::Object>を継承することを望まなければ
 継承する必要はありません。それでもすべてのMooseの特徴にアクセスできます。
@@ -79 +80 @@
 defines an instance attribute in your class:
 
-さて、keywardsについてです。最初に見つかるC<has>はinstance attributeを
-クラスに定義します。
+さて、keywardsについてです。最初に見つかるC<has>は
+インスタンスアトリビュートをクラスに定義します。
 
   has 'x' => (isa => 'Int', is => 'ro');
@@ -89 +90 @@
 (abbreviated as C<ro>).
 
-これはC<x>というattributeを作成し、attributeに格納されるであろう
-C<Int>(1)type 制約を渡し、読み取り専用のaccessorを生成します。
-(C<ro>と省略される)
+これはC<x>というアトリビュートを作成し、アトリビュートに
+格納されるである値のC<Int>(1)type 制約を渡し、読み取り専用の
+アクセサを生成します(C<ro>と省略される)。
 
 The next C<has> line is very similar, with only one difference:
@@ -102 +103 @@
 the C<y> attribute.
 
-read/write (短縮すると C<rw>) accessorを C<y> attributeに生成します。
+read/write (短縮すると C<rw>) アクセサを C<y> アトリビュートに生成します。
 
 At this point the attributes have been defined, and it is time to 
@@ -109 +110 @@
 the C<clear> method.
 
-このpointのattributeを定義し、methodを定義します。
-Mooseでは、通常のPerl5 OOのようにmethodをサブルーチンとして
+ここまででpointのアトリビュートが定義されました、そしてここでメソッドを
+定義します。Mooseでは、通常のPerl5 OOのようにメソッドをサブルーチンとして
 packageに定義します。では C<clear> メソッドを作ります。
 
@@ -126 +127 @@
 other Perl 5 (non-Moose) classes as well. 
 
-これはとても普通ですが、ひとつだけ付け加えるとインスタンスL<(2)>の
-C<x> slotに直接アクセスしています。これは読み取り専用の値が
+これはとても標準的なことですが、ひとつだけ付け加えるとインスタンスL<(2)>の
+C<x> スロットに直接アクセスしています。これは読み取り専用の値が
 作成されています。このようにMooseオブジェクトは通常の以前からある
-blessされたHASHリファレンスであり、通常から逸脱する
+blessされたHASHリファレンスであり、標準から逸脱する
 ものではありません。そしてこれは他のPerl5(Mooseではない)クラスとの
 互換性がよく保たれるということです。
@@ -173 +174 @@
 a new attribute for B<Point3D> called C<z>.
 
-B<Point3D>クラスに戻ります。次は新しい属性であるC<z>をB<Point3D>に
-作ります。
+B<Point3D>クラスに戻ります。次は新しいアトリビュートであるC<z>を
+B<Point3D>に作ります。
 
   has 'z' => (isa => 'Int');
@@ -183 +184 @@
 broken object encapsulation) that C<z> is a private attribute.
 
-B<Point>のC<x>やC<y>属性のように、この属性はC<Int>型制約を持ちますが
-accessorはなんら自動的に作成されません。この結果C<z>属性は
-privateな属性になります(ちなみにカプセル化は破壊されます)。
+B<Point>のC<x>やC<y>アトリビュートのように、このアトリビュートは
+C<Int>型制約を持ちますがアクセサはなんら自動的に作成されません。
+この結果C<z>アトリビュートはprivateな属性になります
+(ちなみにカプセル化は破壊されます)。
 
 Next comes another Moose feature which we call method "modifiers" 
@@ -192 +194 @@
 
 次のMooseの特徴は"modifiers"と呼ばれるメソッドです。
-(またAOPでは"advice" method)
+(またAOPでは"advice" メソッド)
 ここではC<after>modifierを使っています。このように:
 
@@ -207 +209 @@
 
 このmodifierはB<Point3D>にC<clear>メソッドをインストールします。
-最初にスーパークラスのC<clear>methodを実行します(ここではC<Point::clear>)。
-そしてこのmethodが実行されます(もとのメソッドと同じ引数が渡されます)。
+最初にスーパークラスのC<clear>メソッドを実行します
+(ここではC<Point::clear>)。
+そしてこのメソッドが実行されます(もとのメソッドと同じ引数が渡されます)。
 
 
@@ -227 +230 @@
 and get the same results again. Here is how that would look:
 
-他にもMoose method modifierが使えます。C<override>も同じように結果が
-得られます。どのようにかを示します:
+他にもMooseの method modifierが使えます。C<override>も同じように結果が
+得られます。どのようにやるかを示します:
 
   override 'clear' => sub {
@@ -293 +296 @@
 and the type constraint system in general, see the 
 L<Moose::Util::TypeConstraints> documentation.
+
+Mooseはいくつかのデフォルトのtype制約を提供します。
+C<Int>はそのうちの一つです。組み込みのtype制約と一般的な
+type制約システムについてはL<Moose::Util::TypeConstraints>
+ドキュメントを参照してください。
 
 =item (2)
@@ -305 +313 @@
 L<Moose::Meta::Attribute documentation>).
 
+Mooseはインスタンスの構造をblessされたhash reference以外でも
+サポートしています(例えばglob reference --L<MooseX::GlobRef::Object>を
+参照)。
+もしMooseクラスを交換可能にしたければ、上記のように直接インスタンスに
+アクセスするのは避けたほうが懸命です。Mooseはインスタンスの構造を直接
+公開することなく、アトリビュートを設定したり、取得したりできます。
+しかし、これは高度なトピックです(勇敢な読者はL<MooseX::GlobRef::Object>を
+参照してください)。
+
+
 =back
 
@@ -316 +334 @@
 great explanation of them can be found by following this link.
 
+method modifierの概念はCLOSから持ってきました。
+次のリンクから、すばらしい説明が読めます。
+
 L<http://www.gigamonkeys.com/book/object-reorientation-generic-functions.html>