PHP: オブジェクトの集約/合成関数 - Manual
PHP  
downloads | documentation | faq | getting help | mailing lists | | php.net sites | links | my php.net 
search for in the  
<odbc_tablesaggregate_info>
view the version of this page
Last updated: Tue, 21 Dec 2004

LXXIX. オブジェクトの集約/合成関数

警告

このモジュールは、 実験的なものです。これは、これらの関数の動作、関 数名は、このドキュメントに書かれて事項と同様に告知なく将来的なPHPのリ リースで変更される可能性があります。注意を喚起するとともに、このモジュー ルは使用者のリスクで使用して下さい。

導入

オブジェクト指向プログラミングでは、簡単なクラス(またはインスタン ス)を組み合わせてより複雑なクラスを作成するということが一般に行わ れます。これは、複雑なオブジェクトやオブジェクト階層を構築するた めの柔軟な方法であり、多重継承と同等のことを動的に行う機能を有し ます。 クラス(またはオブジェクト)を合成するには、合成される要素の間の関 係により関連(Association)集約(Aggregation)の2種類の方法があります。

関連は、独立に構築され、外部から 可視の部分を合成したものです。クラスまたはオブジェクトを関連づけ る際、各クラスは、関連するクラスへのリファレンスを保持します。 複数のクラスを静的に関連づける際、クラスは他のクラスのインスタン スへのリファレンスを含みます。例えば、

例 1. クラスの関連付け

class DateTime {
  
   function DateTime() {
       // 空のコンストラクタ
   }

   function now() {
       return date("Y-m-d H:i:s");
   }
}

class Report {
   var $_dt = new DateTime();
   // その他のプロパティ ...

   function Report() {
       // 初期化コード ...
   }

   function generateReport() {
       $dateTime = $_dt->now();
       // その他のコード ...
   }

   // その他のメソッド ...
}

$rep = new Report();
コンストラクタ(または他のメソッド)にリファレンスを渡すことにより 実行時に複数のインスタンスを関連づけることも可能です。 これにより、複数のオブジェクト間の関連を動的に変更することが可能 です。この例を示すために上の例を変更してみます。

例 2. オブジェクトの関連

class DateTime {
   // 上の例と同じ
}

class DateTimePlus {
   var $_format;
  
   function DateTimePlus($format="Y-m-d H:i:s") {
       $this->_format = $format
   }

   function now() {
       return date($this->_format);
   }
}

class Report {
   var $_dt;    // DateTimeへのリファレンスをここに保持
   // その他のプロパティ ...

   function Report() {
       // 初期化を行う
   }

   function setDateTime(&$dt) {
       $this->_dt =& $dt;
   }

   function generateReport() {
       $dateTime = $_dt->now();
       // その他のコード ...
   }

   // その他のメソッド ...
}

$rep = new Report();
$dt = new DateTime();
$dtp = new DateTimePlus("l, F j, Y (h:i:s a, T)");

// Web表示用に簡単な日付を付けたレポートを生成する
$rep->setDateTime(&$dt);
echo $rep->generateReport();

// その他のコード ...

// かっこの良いレポートを生成する
$rep->setDateTime(&$dtp);
$output = $rep->generateReport();
// データベースに$outputを保存
// ... 等 ...

一方、集約では、合成されたパーツのカプセル化 (隠蔽)が行われます。(静的な)内部クラス(PHPはまだ内部クラスをサポー トしていません)を使用することにより、クラスを集約することができま す。この場合、このクラスを含むクラスを通じる場合以外、集約された クラスの定義にはアクセスできません。複数のインスタンスの集約(オブ ジェクト集約)は、あるオブジェクトの内部にサブオブジェクトを動的に 作成することを意味し、この過程でこのオブジェクトのプロパティとメ ソッドを拡張します。

オブジェクトの集約は、(例えば、分子は原子を集約したものであるといっ た)包含関係を表す際の自然な方法であり、サブクラスを複数の親クラス およびそのインターフェイスに永続的にバインドすることなく、 多重継承と等価な機能を得るために使用できます。 実際、オブジェクトの集約はより柔軟に使用することができ、集約され るオブジェクトで継承するメソッドまたはプロパティを選択することが できます。

3つのクラスを定義し、各々に別々のストレージメソッドを実装します。

例 3. storage_classes.inc

<?php
class FileStorage {
   var
$data;

   function
FileStorage($data) {
      
$this->data = $data;
   }
   function
write($name) {
      
$fp = fopen(name, "w");
      
fwrite($fp, $this->data);
      
fclose($data);
   }
}

class
WDDXStorage {
   var
$data;
   var
$version = "1.0";
   var
$_id; // "private"変数

  
function WDDXStorage($data) {
      
$this->data = $data;
      
$this->_id = $this->_genID();
   }

   function
store() {
       if (
$this->_id) {
          
$pid = wddx_packet_start($this->_id);
          
wddx_add_vars($pid, "this->data");
          
$packet = wddx_packet_end($pid);
       } else {
          
$packet = wddx_serialize_value($this->data);
       }
      
$dbh = dba_open("varstore", "w", "gdbm");
      
dba_insert(md5(uniqid("",true)), $packet, $dbh);
      
dba_close($dbh);
   }

  
// privateメソッド
  
function _genID() {
       return
md5(uniqid(rand(),true));
   }
}

class
DBStorage {
   var
$data;
   var
$dbtype = "mysql";

   function
DBStorage($data) {
      
$this->data = $data;
   }

   function
save() {
      
$dbh = mysql_connect();
      
mysql_select_db("storage", $dbh);
      
$serdata = serialize($this->data);
      
mysql_query("insert into vars ('$serdata',now())", $dbh);
      
mysql_close($dbh);
   }
}

?>

We then instantiate a couple of objects from the defined classes, and perform some aggregations and deaggregations, printing some object information along the way:

例 4. test_aggregation.php

<?php
include "storageclasses.inc";

// some utilty functions

function p_arr($arr) {
   foreach(
$arr as $k=>$v)
      
$out[] = "\t$k => $v";
   return
implode("\n", $out);
}

function
object_info($obj) {
  
$out[] = "Class: ".get_class($obj);
   foreach(
get_object_vars($obj) as $var=>$val)
       if (
is_array($val))
          
$out[] = "property: $var (array)\n".p_arr($val);
       else
          
$out[] = "property: $var = $val";
   foreach(
get_class_methods($obj) as $method)
      
$out[] = "method: $method";
   return
implode("\n", $out);
}


$data = array(M_PI, "kludge != cruft");

// we create some basic objects
$fs = new FileStorage($data);
$ws = new WDDXStorage($data);

// print information on the objects
echo "\$fs object\n";
echo
object_info($fs)."\n";
echo
"\n\$ws object\n";
echo
object_info($ws)."\n";

// do some aggregation

echo "\nLet's aggregate \$fs to the WDDXStorage class\n";
aggregate($fs, "WDDXStorage");
echo
"\$fs object\n";
echo
object_info($fs)."\n";

echo
"\nNow let us aggregate it to the DBStorage class\n";
aggregate($fs, "DBStorage");
echo
"\$fs object\n";
echo
object_info($fs)."\n";

echo
"\nAnd finally deaggregate WDDXStorage\n";
deaggregate($fs, "WDDXStorage");
echo
"\$fs object\n";
echo
object_info($fs)."\n";

?>

We will now consider the output to understand some of the side-effects and limitation of object aggregation in PHP. First, the newly created $fs and $ws objects give the expected output (according to their respective class declaration). Note that for the purposes of object aggregation, private elements of a class/object begin with an underscore character ("_"), even though there is not real distinction between public and private class/object elements in PHP.

$fs object
Class: filestorage
property: data (array)
    0 => 3.1415926535898
    1 => kludge != cruft
method: filestorage
method: write

$ws object
Class: wddxstorage
property: data (array)
    0 => 3.1415926535898
    1 => kludge != cruft
property: version = 1.0
property: _id = ID::9bb2b640764d4370eb04808af8b076a5
method: wddxstorage
method: store
method: _genid

We then aggregate $fs with the WDDXStorage class, and print out the object information. We can see now that even though nominally the $fs object is still of FileStorage, it now has the property $version, and the method store(), both defined in WDDXStorage. One important thing to note is that it has not aggregated the private elements defined in the class, which are present in the $ws object. Also absent is the constructor from WDDXStorage, which will not be logical to aggegate.

Let's aggregate $fs to the WDDXStorage class
$fs object
Class: filestorage
property: data (array)
    0 => 3.1415926535898
    1 => kludge != cruft
property: version = 1.0
method: filestorage
method: write
method: store

The proccess of aggregation is cummulative, so when we aggregate $fs with the class DBStorage, generating an object that can use the storage methods of all the defined classes.

Now let us aggregate it to the DBStorage class
$fs object
Class: filestorage
property: data (array)
    0 => 3.1415926535898
    1 => kludge != cruft
property: version = 1.0
property: dbtype = mysql
method: filestorage
method: write
method: store
method: save

Finally, the same way we aggregated properties and methods dynamically, we can also deaggregate them from the object. So, if we deaggregate the class WDDXStorage from $fs, we will obtain:

And deaggregate the WDDXStorage methods and properties
$fs object
Class: filestorage
property: data (array)
    0 => 3.1415926535898
    1 => kludge != cruft
property: dbtype = mysql
method: filestorage
method: write
method: save

One point that we have not mentioned above, is that the process of aggregation will not override existing properties or methods in the objects. For example, the class FileStorage defines a $data property, and the class WDDXStorage also defines a similar property which will not override the one in the object acquired during instantiation from the class FileStorage.

目次
aggregate_info --  Returns an associative array of the methods and properties from each class that has been aggregated to the object
aggregate_methods_by_list --  Selective dynamic class methods aggregation to an object
aggregate_methods_by_regexp --  Selective class methods aggregation to an object using a regular expression
aggregate_methods --  Dynamic class and object aggregation of methods
aggregate_properties_by_list --  Selective dynamic class properties aggregation to an object
aggregate_properties_by_regexp --  Selective class properties aggregation to an object using a regular expression
aggregate_properties --  Dynamic aggregation of class properties to an object
aggregate --  メソッドおよびプロパティの動的なクラス/オブジェクト集約を行う
aggregation_info -- Alias of aggregate_info()
deaggregate --  Removes the aggregated methods and properties from an object


add a note add a note User Contributed Notes
オブジェクトの集約/合成関数
Jeb.
17-Jan-2003 10:18
It is worth noting that class association does not work, even in PHP 4.3.0 - this ability is experimental. I'm assuming it was added in for the sake of forwards-compatibilty. Use object association instead for now.

Until it is implemented, you will receieve a parse error when attempting to use it.

Related bug report:

Just to prevent people posting about "why it doesn't work??", etc etc etc.
Greg Beaver firstname at chiaraquartet dot net
04-Jan-2003 11:54
If you need to serialize an object for sessions or other purposes, and want to save aggregation state, extend it from a base class such as this one, and use $this->agg/$this->unagg instead of aggregate/deaggregate

<?php
class base
{
   var
$_aggregates = array();
  
   function
agg($agg)
   {
      
aggregate($this,$agg);
      
$this->_aggregates[$agg] = 1;
   }
  
   function
unagg($agg = false)
   {
       if (
$agg)
       {
            
deaggregate($this,$agg);
             unset(
$this->_aggregates[$agg]);
       } else
       {
            
deaggregate($this);
          
$this->_aggregates = array();
       }
   }
}
?>

<odbc_tablesaggregate_info>
 Last updated: Tue, 21 Dec 2004
show source | credits | sitemap | contact | advertising | mirror sites 
Copyright © 2001-2005 The PHP Group
All rights reserved.
This unofficial mirror is operated at: /
Last updated: Mon Mar 14 08:13:06 2005 Local time zone must be set--see zic manual page