ruby-list

あおきです。

  In Mail "[ruby-list:12017] Re: What's DelegateClass ?"
    じぶん wrote:

> > |ですね，これは使いでがあるので何かドキュメントがあったほうが
> > |よいかも．
> > 
> > テクニカルライター募集中．^^;;;

> 応募(?)してもいいでしょうか。

とりあえず書いてみました。
-------------------------------------------------------------------
あおきみねろう＠一橋大学
  mail to: aamine@dp.u-netsurf.ne.jp
  website: http://www1.u-netsurf.ne.jp/~brew/mine/

====================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY text="#000000" bgcolor="#FFFFFF">

<HR>

<dl>
<dt><H1><a name="Delegator">Delegator</a></H1>
<dd> 
<P>
クラス階層とは関係なく、他のオブジェクトのインターフェイス・
実装を利用する(以下、delegate)ための抽象クラスです。
Delegatorクラスはオブジェクト単位のdelegateを行うためのクラス
なので、クラス単位でdelegateをするときには、DelegateClass
メソッドを使ってください。

ちなみに、このクラスには下位互換性のためにDelegaterという別名
があります。
</P>

<dt> <h2>スーパークラス:</h2>
<dd> 
<dl>
<dt><A HREF="Object.html"><code>Object</code></A>
</dl>
<dt> <h2>クラスメソッド:</h2>
<dd> 
<DL COMPACT>

<DT>
<A NAME="Delegator.new"><CODE>new([<VAR>obj</VAR>])</CODE></A>
<DD>
<p>
引数<code>obj</code>にはdelegateしたいオブジェクトを渡します。
下位クラスで<code>initialize</code>を再定義するときは必ず
<code>super</code>を呼びだす必要があります。
</p>
<p>
また、メソッドhash、eql?はdelegateされないので、Delegator
の下位クラスのインスタンスをHashのキーに使うときは、この
ふたつのメソッドを再定義してください。具体的には、
<blockquote><pre>
obj.eql? Delegator.new( obj )
obj.hash == Delegator.new( obj ).hash
</pre></blockquote>
の両方が成立する必要があります。
</p>
</DL>

<dt> <h2>メソッド:</h2>
<dd> 
<DL COMPACT>

<DT>
<a name="__getobj__">__getobj__</a>
<DD>
<p>
下位クラスでは目的にあわせてこのメソッドを再定義しなければ
いけません。このメソッドが再定義されないままだと、そのクラス
のメソッドが呼ばれたときに例外NotImplementErrorが発生します。
</p>

</DL>

<dt>用例:
<dd>
<blockquote><pre>
#!/usr/local/bin/ruby
require 'delegate'

class SimpleDelegator &#60 Delegator

  # SimpleDelegatorの定義そのまま。
  # 他に例が思いつかないところが苦しい

  def __getobj__
    @obj
  end

  def __setobj__( obj )
    @obj = obj
  end

  def initialize( obj )
    super
    __setobj__( obj )
  end
end

dele = SimpleDelegator.new( STDOUT )
dele.write 'this is from delegated STDOUT'  # STDOUTに出力される
</pre></blockquote>
</dl>
<HR>

<dl>
<dt><H1><a name="SimpleDelegator">SimpleDelegator</a></H1>
<dd> 
<P>
SimpleDeletatorクラスは、クラス作成時または__setobj__であたえた
オブジェクトのdelegateを行うクラスです。
</P>

<dt> <h2>スーパークラス:</h2>
<dd> 
<dl>
<dt> <A HREF="#Delegator"><code>Delegator</code></A>
</dl>
<dt> <h2>クラスメソッド:</h2>
<dd> 
<DL COMPACT>

<DT>
<A NAME="SimpleDelegator.new"><CODE>new([<VAR>obj</VAR>])</CODE></A>
<DD>
<p>
引数objにはその実装を利用したいオブジェクトを渡します。
</p>
</DL>

<dt> <h2>メソッド:</h2>
<dd> 
<DL COMPACT>

  __getobj__


<DT>
<a name="__getobj__">__getobj__</a>
<DD>
<p>
このクラスでは単にインスタンス変数に格納されているオブジェクトを
渡すだけです。
</p>

<DT>
<a name="__setobj__"><code>__setobj__(<var>obj</var>)</code></a>
<DD>
<p>
delegateを行うオブジェクトをobjに変更します。
</p>

</DL>

<dt>用例:
<dd>
<blockquote><pre>
#!/usr/local/bin/ruby
require 'delegate'
require 'socket'

class SMTPsocket &#60 SimpleDelegator

  def initialize( host = 'localhost', port = 25 )
    # 組みこみクラスでインスタンス変数が使える。
    # 現状で一番有効な利用法という話もある。
    @sock = TCPsocket.open( host, port )

    # 忘れてはいけない
    super( @sock )
  end

  # 定義をいろいろ書く…
end

</pre><blockquote>
</dl>

<HR>

<dl>
<dt><code>DelegateClass(<var>dele_class</var>)</code>
<dd> 
<P>
第一引数に与えられたクラスのクラスメソッド・メソッドを
ほぼ全て持った名無しクラスを新しく作ってそれを返します。
またそのクラスでは、必ずinitializeでdele_classのインス
タンスをsuperに渡さなければいけません。
</P>

<dt>用例
<dd>
<blockquote><pre>
#!/usr/local/bin/ruby
require 'delegate'

class NilArray &#60 DelegateClass( Array )
  def initialize
    super( [] )

    # Arrayは組みこみクラスなので今のところインスタンス
    # 変数は使えないが、Delegateされたクラスなら
    # インスタンス変数が使える
    @a = 1
  end

  def []( idx )
    # 常にnilをかえすように変更してみる
    return nil
  end
end

obj = NilArray.new( 3 )
p obj.type                         # Array
obj.push 1
p obj[ 0 ]                         # nil (ちゃんと変更されている)
p obj                              # [ 1 ]
p obj.pop                          # 1
</pre>
</blockquote>

</dl>
<HR>

</BODY>
</HTML>
===================================================================

Thread

Prev Next

In This Thread

Prev Next

[#11848] calculation on matrices — nagai@...

[#11849] About install to $HOME — HQss_YasuiS/hq_ss@...

[#11851] Ruby/Python 0.2 — Masaki Fukushima <fukusima@...>

[#11853] Re: About install to $HOME — HQss_YasuiS/hq_ss@...

[#11866] Re: About install to $HOME — HQss_YasuiS/hq_ss@...

[#11868] Re: parsedate for HTTP style — Tadayoshi Funaba <tadf@...>

[#11870] Re: About install to $HOME — HQss_YasuiS/hq_ss@...

[#11871] Re: calculation on matrices — nagai@...

[#11874] Re: About install to $HOME — HQss_YasuiS/hq_ss@...

[#11875] Re: [BUG] 3e9.to_i => floating exception — gotoken@... (GOTO Kentaro)

[#11876] Re: [BUG] 3e9.to_i => floating exception — SHUDO Kazuyuki <shudoh@...>

[#11904] to_i,to_s の素朴な疑問 — HQss_YasuiS/hq_ss@...

[#11907] fraction class — ttate@...

[#11922] Re: to_i,to_s の素朴な疑問 — HQss_YasuiS/hq_ss@...

[#11925] Re: to_i,to_s の素朴な疑問 — HQss_YasuiS/hq_ss@...

[#11930] Forward: Re: to_i,to_s の素朴な疑問 — matz@... (Yukihiro Matsumoto)

[#11937] ruby の確認事項 — HQss_YasuiS/hq_ss@...

[#11944] Re: to_i,to_s の素朴な疑問 — Inaba Hiroto <inaba@...>

[#11957] can't make exts on FreeBSD 3.0 — kjana@... (YANAGAWA Kazuhisa)

[#11960] document|implemnt bu on Array#[x..y] — kjana@... (YANAGAWA Kazuhisa)

[#11973] press and PostgreSQL guide — Noritsugu Nakamura <nnakamur@...>

[#11976] ruby-gtk-0.16 — "D.Kanda" <MAP2303@...>

[#11989] calendar/date2 — Tadayoshi Funaba <tadf@...>

[#11990] [patch] sample/cal.rb — Tadayoshi Funaba <tadf@...>

[#11991] Re: Jed (Re: MailModule ver 0.2) — "豊福" <toyofuku@...>

[#11993] Re: to_i,to_s の素朴な疑問 — HQss_YasuiS/hq_ss@...

[#11999] pack/unpack — Shugo Maeda <shugo@...>

[#12000] how to make class? — "Kikutani, Makoto" <kikutani@...>

[#12024] [patch] marshal.c — Shugo Maeda <shugo@...>

[#12036] Re: to_i,to_s の素朴な疑問 — HQss_YasuiS/hq_ss@...

[#12046] Re: document|implemnt bu on Array#[x..y] — Inaba Hiroto <inaba@...>

[#12053] puts "\n" — "Takehiko Ueki" <takehiko@...>

[#12062] module in module — thitoshi@... (TAKAHASHI Hitoshi)

[#12063] Re: puts "\n" — "Takehiko Ueki" <takehiko@...>

[#12071] Re: document|implemnt bu on Array#[x..y] — Inaba Hiroto <inaba@...>

[#12072] Re: document|implemnt bu on Array#[x..y] — Inaba Hiroto <inaba@...>

[#12083] [Q] POPclient — Shugo Maeda <shugo@...>

[#12090] !=~ — "Kikutani, Makoto" <kikutani@...>

[#12105] ruby 1.2.3 released — matz@... (Yukihiro Matsumoto)

[#12117] INET client — "Kikutani, Makoto" <kikutani@...>

[#12118] ruby-termios-module — akira yamada / やまだあきら <akira@...>

[#12125] ruby on SunWorld Online — Takaaki Higuchi - Technology Marketing <Takaaki.Higuchi@...>

[#12143] Iterator with proc object — cercine@... (Takashi Ikeda)

[#12163] Number with unit — Jun Adachi <adachi@...>

[#12183] ruby-mode + font-lock-mode — SONODA Yoshihide (園田 吉英) <ysonoda@...>

[#12188] Re: Meeting2000 リリースします — 松尾尚典 <matsuo_hisanori@...21.odn.ne.jp>

[#12191] auto updater — SHUDO Kazuyuki <shudoh@...>

[#12192] Errata of RAA — kjana@... (YANAGAWA Kazuhisa)

[#12196] Ruby on UNIX MAGAZINE — Yasuhiro Fukuma <yasuf@...>

[#12200] subscribe — Akaishi <akaishi@...>

[#12201] rskkserv — Toru Hoshina <hoshina@...>

[#12216] SGmail doesn't download — moochan <moochan@...>

[#12217] It wants to install mon_ruby — moochan <moochan@...>

[#12225] disable CTL-c — "Kikutani, Makoto" <kikutani@...>

[#12248] tempfile — Kikutani Makoto <kikutani@...>

[#12260] slanglib-0.11 — Kikutani Makoto <kikutani@...>

[#12282] httptunnel — Noritsugu Nakamura <nnakamur@...>

[#12301] Meeting2000-0_92 — Toshiki Komai <komai@...4u.or.jp>

[#12302] [BUG] Segmentation fault — polygon <polygon@...>

[#12308] (閑話) 「 XML 開発者の日」にて Ruby 紹介ありですね。 — Atsuko Yoshida <atsuko@...>

[#12309] [REQ] rlex.rb — keiju@... (Keiju ISHITSUKA)

[#12315] RE: (閑話) 「 XML 開発者の日」にて Ruby 紹介ありですね。 — 助田 雅紀 <masaki.suketa@...>

[#12318] join — たむら けんいち <tamura-r@...>

[#12354] Re: [BUG] Segmentation fault — "Kozuka Masahiro" <kozuka@...>

[#12357] my PID — "Kikutani, Makoto" <kikutani@...>

[#12366] \1 がうまく行かない — Sinichiro Dezawa <dezawa@...>

[#12372] Re: my PID — 助田 雅紀 <masaki.suketa@...>

[#12374] Re: my PID — 助田 雅紀 <masaki.suketa@...>

[#12377] DESTDIR — Hitoshi Tomotsugu <hitoshi@...>

[#12398] 文字の正規 (?) 化 — m_seki@...

[#12401] mine-0.0.4 — Takahiro Maebashi <maebashi@...>

[#12412] Perllib for ruby — Yoshinori Toki <toki@...>

[#12414] naming rule — Akaishi <akaishi@...>

[#12423] a?b:c — "Kikutani, Makoto" <kikutani@...>

[#12427] Book of Ohmusya — moochan <moochan@...>

[#12428] 他の言語での特異メソッド /singleton method の呼び方 — Takashi Nakai <nakai@...1.sys.to.casio.co.jp>

[#12449] Re: Meeting2000-0_92b1 — "NAKAMURA, Hiroshi" <nakahiro@...>

[#12454] Re: It wants to install mon_ruby — Yasuhiro Fukuma <yasuf@...>

[#12457] making ruby on Digital Unix — Yuji Shigehiro <sigehiro@...>

[#12460] Re: HTTP/1.1 client & server — Satoru Takabayashi <ccsatoru@...>

[#12183] ruby-mode + font-lock-mode — SONODA Yoshihide (園田吉英) <ysonoda@...>

[#12315] RE: (閑話) 「 XML 開発者の日」にて Ruby 紹介ありですね。 — 助田　雅紀 <masaki.suketa@...>

[#12318] join — たむら　けんいち <tamura-r@...>

[#12372] Re: my PID — 助田　雅紀 <masaki.suketa@...>

[#12374] Re: my PID — 助田　雅紀 <masaki.suketa@...>