noda 0.0.10 → 0.0.11

data/Rakefile

@@ -45,6 +45,7 @@ task :default => :test
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.options << '-c UTF8'
 
   rdoc.rdoc_dir = 'rdoc'
   rdoc.title = "noda #{version}"

data/VERSION

@@ -1 +1 @@
-0.0.10
+0.0.11

data/lib/noda/job_monitor.rb

@@ -1,5 +1,8 @@
 
 module Noda
+#=�T�v
+# �W���u��Ԃ��Ď�����WEB�T�[�o�[�ł��B
+# DRB�ɐڑ����āC�L���[�c���C���L�n�b�V���e�[�u���A�L���[�̒��g�����邱�Ƃ��o���܂��D
 
 class JobMonitor
   require 'webrick'

data/lib/noda/job_worker.rb

@@ -1,11 +1,23 @@
 module Noda
 
+# ジョブワーカー
+# 
+# ジョブを待ち受けるスレッドです。
+# Taskを取りだして実行します．
+#   ip=127.0.0.1
+#   w=Noda::JobWorker.new("#{ip}", "10001")
+#   t = DRb.start_service("druby://#{ip}:10101",w)
+#   w.start
+# 
+#
 
 class JobWorker
   attr_reader :thread
   attr_accessor :max_retry_connect , :wait_time_to_retry
-  def initialize( job_server_addr="localhost",job_server_port="10001" )
-    @server_uri  = "druby://#{job_server_addr}:#{job_server_port}"
+  # * server_addr ジョブサーバーアドレス、またはホスト名
+  # * server_port ジョブサーバーポート
+  def initialize( server_addr="localhost",server_port="10001",q="" )
+    @server_uri  = "druby://#{server_addr}:#{server_port}/?#{q}"
     @max_retry_connect  = 30
     @wait_time_to_retry =  2
     require "socket" 
@@ -13,6 +25,7 @@ class JobWorker
     self.connect
     self
   end
+  # 内部的に使います。ジョブサーバーへ接続
   def connect_job_server
     error_conter = 0
     begin 
@@ -26,6 +39,11 @@ class JobWorker
       retry
     end
   end
+  # 担当ジョブからタスクを実行します．
+  # 
+  # タスクは do_task(hash)実装が必須
+  # タスクのクラス定義はrequire必須．（start前にrequire)
+  # タスクのクラス定義はサーバー側から自動ロード(eval)します．
   def handle_task()
     # @logger.info("self.class@#{@local_addr}#{self.object_id}"){"i try to pop a task."} 
     task = @job.input.pop
@@ -36,10 +54,14 @@ class JobWorker
     result = task.do_task(@job.hash_table)
     @job.output.push result
   end
+  # クラス定義をEvalする。クラス定義はサーバーから取り出す．
+  # ワーカー側にクラス定義を動的に渡すときに使います．
+  # *name クラス名
   def load_class(name)
     s = @job.task_class(name)
     Noda.module_eval(s)
   end
+  # ワーカーのメインスレッドを起動します．start で使います．
   def init_thread
     @table = @job.hash_table
     @thread= Thread.new{
@@ -49,16 +71,29 @@ class JobWorker
         }
     }
   end
+
+  # サーバーに接続します
+  # 
   def connect
     self.connect_job_server
   end
+
+  # 処理を開始します．
+  # 
+  # threadを返します． worker を起動しっぱなしにするなら thread.joinしてください
   def start
     self.init_thread
     @thread.join
   end
+
+  # ワーカースレッドの状態を取り出します．
+  # 
+  # マルチスレッドでブロックされてるとsleep になります
   def status
     @thread.status if @thread
   end
+
+  # スレッド停止します．このインスタンスは死にません．start で再起動します．
   def stop
     @thread.kill
   end

data/lib/noda/rqueue.rb

@@ -2,6 +2,10 @@
 
 module Noda
 require 'monitor'
+# �W���u�̃L���[����
+# �L���[�̓X���b�h�Z�[�t�ɏ����Ă���
+#
+#
 class RQueue
   include DRb::DRbUndumped 
   attr_reader :name

data/noda.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{noda}
-  s.version = "0.0.10"
+  s.version = "0.0.11"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["takuya"]

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: noda
 version: !ruby/object:Gem::Version 
-  hash: 11
+  hash: 9
   prerelease: 
   segments: 
   - 0
   - 0
-  - 10
-  version: 0.0.10
+  - 11
+  version: 0.0.11
 platform: ruby
 authors: 
 - takuya