rbitter 0.1.2-java → 0.2.0-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 157a4cd2b13330fa06547688fc8cce5d22c30670
-  data.tar.gz: d12d38c95d8fd84047cb6b3ee2805dde1d0cd7af
+  metadata.gz: 5c9c0ff087a6aacd028509c314aaefcbbf58dd36
+  data.tar.gz: 920cd1f50bf68313d4c53bc63ce702d94eec3e44
 SHA512:
-  metadata.gz: fbd300e20e5fdf8e711c3fdb38552d144552f7e84898a3274363de2267e9643dca13ddf888c1b8163b384c67de959839f00acc08db27568cdb962a280ffbf559
-  data.tar.gz: 2095fe34daf61fa83bfaa6fd1d276a24bf0e917591adbb0ea78c08788a8428fb4fa00200222236cadf3793b72beca9c5b00a05e63d27c1b25f94ad8e6d1d6d8b
+  metadata.gz: 234b2fddc686b01706d92146da6230d0c45f323bf0dd75447522f71f5543e21bc6afe2bf4ad98865d1524802e54aef9e7671d15abc2ea5b4f5198054dc0f9af2
+  data.tar.gz: 7d11d501b9f3fcb2b5f78a76d4c3c1f197e0562aca9e59cdcfdbd0c54f16bed0c6c673c6b4d96af0c7abb6dd09b9eb9ea64ee596bd359738912a10eb86fef3c4

data/.gitignore

@@ -17,5 +17,6 @@ mkmf.log
 *.gem
 *.json
 *.sqlite
+*.png
 .rbitter
 .rbitter/*

data/README.md

@@ -30,6 +30,11 @@ Put your customized config.json to one of below locations.
 1. ./config.json (current folder)
 2. ./.rbitter/config.json (current folder)
 
+### XMLRPC handlers ###
+To get XMLRPC handlers, visit [Rbitter XMLRPC](https://github.com/nidev/rbitter-rpchandles).
+
+You can find the document to write your own XMLRPC handler.
+
 ## Set up and run ##
 With config.json,
 
@@ -42,9 +47,6 @@ With config.json,
 ```bash
 $ rbitter serve
 ```
-## XMLRPC API ##
-
-See XMLRPC.md
 
 ## TODO ##
 * Streaming Client

data/lib/rbitter/arcserver.rb

@@ -15,10 +15,16 @@ module Rbitter
     LOG_NORMAL = 0
     LOG_INIT = 1
     LOG_HALT = 2
+    LOG_ERROR = 4
 
     def initialize(xmlrpcd_class = Rbitter::RPCServer)
       @xmlrpcd_class = xmlrpcd_class
+      @dt = DLThread.new(
+        Rbitter['media_downloader']['download_dir'],
+        Rbitter['media_downloader']['large_image'])
+    end
 
+    def arsupport_init
       ARSupport.connect_database
 
       if not ARSupport.prepared?
@@ -31,10 +37,10 @@ module Rbitter
       end
 
       ARSupport.update_database_scheme
+    end
 
-      @dt = DLThread.new(
-        Rbitter['media_downloader']['download_dir'],
-        Rbitter['media_downloader']['large_image'])
+    def arsupport_halt
+      ARSupport.disconnect_database
     end
 
     def xmlrpcd_start
@@ -72,21 +78,38 @@ module Rbitter
         :fav_count => 0})
     end
 
-    def write_init_marker
+    def mark_init
       mark(LOG_INIT, "Archiving service started")
     end
 
-    def write_halt_marker
+    def mark_halt
       mark(LOG_HALT, "Archiving service halted")
     end
 
+    def mark_error(exception_string, err_msg)
+      mark(LOG_ERROR, "Errored (#{exception_string}, #{err_msg}")
+    end
+
+    def resurrect_loop?
+      if Rbitter.env['twitter']['connection']['reconnect']
+        puts "[rbitter] Try to reconnect..."
+        sleep Rbitter.env['twitter']['connection']['timeout_secs']
+        true
+      else
+        puts "[rbitter] Give up!"
+        false
+      end
+    end
+
     def main_loop(streaming_adapter = Rbitter::StreamClient)
       xmlrpcd_start if Rbitter['xmlrpc']['enable']
 
+      arsupport_init
+
       begin
-        write_init_marker
+        mark_init
 
-        streaming_adapter.new(Rbitter['twitter'].dup).run { |a|
+        streaming_adapter.new(Rbitter['twitter']).run { |a|
           @dt << a['media_urls']
 
           record = Record.find_or_initialize_by(tweetid: a['tweetid'])
@@ -106,25 +129,37 @@ module Rbitter
       rescue Interrupt => e
         puts ""
         puts "Interrupted..."
+        mark_error(e.to_s, "(exit) SIGINT - interrupted by user")
       rescue Twitter::Error::Unauthorized => e
         warn "Twitter access unauthorized:"
         warn "  Possible solutions"
         warn "  1. Configure Twitter token on config.json"
         warn "  2. Check system time (Time is important on authentication)"
         warn "  3. Check Twitter account status"
-      rescue Twitter::Error::ServerError, Resolv::ResolvError => e
-        puts "Service unavailable now. Retry in 5 second..."
-        sleep 5
-        retry
+      rescue Twitter::Error::ServerError => e
+        puts "Service unavailable now. Retry in 5 seconds..."
+        mark_error(e.to_s, "(retry) Twitter server unavailable / Timeout")
+
+        retry if resurrect_loop?
+      rescue Resolv::ResolvError, Errno::ECONNABORTED,
+        Errno::ECONNREFUSED, Errno::ECONNRESET => e
+        puts "Network problem. Retry in 5 seconds..."
+        mark_error(e.to_s, "(retry) Network problem")
+
+        retry if resurrect_loop?
       rescue Twitter::Error => e
         warn "Twitter Error: #{e.inspect}"
-        warn "Main loop of ArcServer halted."
+        warn "Rbitter halts due to Twitter::Error"
+        mark_error(e.to_s, "(exit) Twitter Error")
       ensure
         xmlrpcd_stop if Rbitter['xmlrpc']['enable']
         @dt.job_cleanup
 
-        write_halt_marker
+        mark_halt
       end
+
+      arsupport_halt
     end
+
   end
 end

data/lib/rbitter/default/config_json.rb

@@ -5,7 +5,11 @@ module Rbitter
     "consumer_key": "",
     "consumer_secret": "",
     "access_token": "",
-    "access_token_secret": ""
+    "access_token_secret": "",
+    "connection": {
+      "reconnect": true,
+      "timeout_secs": 5
+    }
   },
   "activerecord": "sqlite3",
   "sqlite3": {

data/lib/rbitter/env.rb

@@ -1,11 +1,13 @@
 # encoding: utf-8
 
 require "json"
+require "rbitter/default/config_json"
 
 module Rbitter
   @@env = Hash.new
 
   class ConfigFileError < StandardError; end
+  class MissingFieldError < StandardError; end
 
   def self.[](k)
     @@env[k]
@@ -20,9 +22,60 @@ module Rbitter
     @@env.clear
   end
 
-  def env_validate?
-    # TODO: Add validator
-    true
+  def env_listfields hash
+    path_stack = ['']
+    generated = []
+
+    until path_stack.empty?
+      path = path_stack.pop
+
+      if path == ''
+        o = hash
+      else
+        nodes = path.strip.split('->')
+        o = hash
+        until nodes.empty?
+          o = o[nodes.shift]
+        end
+      end
+
+      o.each_key { |k|
+        if o[k].is_a?(Hash)
+          path_stack << "#{k}" if path.empty?
+          path_stack << path + "->#{k}" unless path.empty?
+        else
+          generated << "#{k}" if path.empty?
+          generated << path + "->#{k}" unless path.empty?
+        end
+      }
+    end
+
+    generated
+  end
+
+  def env_valid?
+    defaults = env_listfields(JSON.parse(DEFAULT_CONFIG_JSON))
+    currents = env_listfields(@@env)
+    not_errored = true
+
+    # Cross checking (2 phases)
+    # In current exists, default does not: redundant configuration
+    # Level: warning since it is not utilized at all.
+    currents.each { |conf|
+      unless defaults.include?(conf)
+        warn "[config.json] Unused config: #{conf}. You can safely remove it."
+      end
+    }
+
+    # In default exists, current does not: missing configuration
+    # Level: error and program should stop. (return false for this)
+    defaults.each { |conf|
+      unless currents.include?(conf)
+        warn "[config.json] Config not found: #{conf}. Invalid configuration!"
+        not_errored = false
+      end
+    }
+    not_errored
   end
 
   def config_initialize json_path=nil
@@ -34,7 +87,7 @@ module Rbitter
           @@env = JSON.parse(file.read)
         }
 
-        return @@env if env_validate?
+        return @@env if env_valid?
         fail StandardError, "Invalid configuration"
       rescue => e
         fail ConfigFileError, "Load Failure (#{json_path}): #{e.to_s}"
@@ -52,11 +105,12 @@ module Rbitter
       open(location, 'r') { |file|
         @@env = JSON.parse(file.read)
       }
-      break if env_validate?
+      break unless @@env.empty?
     end
 
-    if @@env.empty?
-      fail ConfigFileError, "Can not load any configuration in [#{locations.join(', ')}]"
-    end
+    fail ConfigFileError, "No config.json on #{locations.join(' or ')}" if @@env.empty?
+    fail ConfigFileError, "Configuration outdated. Please see above messages to update it" if not env_valid?
+
+    puts "[config.json] Loaded configuration is valid. good to go!"
   end
 end

data/lib/rbitter/override/gems/rubysl-socket/socket.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+require 'socket'
+
+class Socket
+  def self.ip_address_list
+    fail NotImplementedError
+  end
+end

data/lib/rbitter/override.rb

@@ -0,0 +1,47 @@
+=begin
+This module gives special workarounds for some issues.
+
+Problems are bypassed by monkey-patching.
+
+As soon as a problem is resolved, patch should be removed.
+
+**** Known issues ****
+
+1. gem/twitter
+Location : override/gem/twitter/connection.rb
+Maintain : until below issue is fixed
+Reference: https://github.com/sferik/twitter/pull/669
+
+Gem 'twitter' does not handle streaming timeout. By applying this,
+reading timeout works and Rbitter can handle timeouts.
+
+2. gem/rubysl-socket
+Location : override/gem/rubysl-socket/socket.rb
+Maintain : until ip_address_list is implemented
+Reference: https://github.com/rubysl/rubysl-socket/pull/9
+
+With ipv6 environment, Resolv#use_ipv6? (in rubysl-resolv gem) checks 
+Socket.ip_address_list. This is not implemented at all with rubysl-socket-2.0.1.
+NoMethodError exception is raised instead of NotImplementedError.
+
+By applying this, Socket.ip_address_list is implemented and the method throws
+NotImplementedError exception.
+
+=end
+
+def gem_twitter_patcher
+  require 'rbitter/override/gems/twitter/connection'
+end
+
+if Twitter::Version.const_defined?(:MAJOR)
+  b5_version = Twitter::Version::MAJOR * 10000
+  + Twitter::Version::MINOR * 100 + Twitter::Version::PATCH
+  gem_twitter_patcher if b5_version <= 51400
+else
+  b6_version = Twitter::Version.to_a
+  if b6_version[0] <= 6 and b6_version[1] <= 0 and b6_version[2] <= 0
+    gem_twitter_patcher
+  end
+end
+
+require 'rbitter/override/gems/rubysl-socket/socket' if RUBY_ENGINE == 'rbx'

data/lib/rbitter/records.rb

@@ -63,6 +63,12 @@ module ARSupport
     end
   end
 
+  def disconnect_database
+    if ActiveRecord::Base.connected?
+      ActiveRecord::Base.connection.close
+    end
+  end
+
   def update_database_scheme
     current_version = ActiveRecord::Migrator.current_version
     if current_version < SCHEME_VERSION

data/lib/rbitter/version.rb

@@ -1,6 +1,6 @@
 module Rbitter
   PRODUCT_NAME = "Rbitter"
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 
   def major
     VERSION.match(/^([0-9]+)\./)[1]

data/lib/rbitter.rb

@@ -6,6 +6,7 @@ require "rbitter/arcserver"
 require "rbitter/env"
 require "rbitter/console"
 require "rbitter/xmlrpc"
+require "rbitter/override"
 
 module Rbitter
   BOOTSTRAP_ARGS = ['configure', 'console', 'help', 'logs', 'serve']
@@ -26,29 +27,6 @@ module Rbitter
     puts "`- logs     : Show Rbitter internal logs"
   end
 
-  def self.prebootstrap
-    # Due to stalled socket problem, If unpatched twitter gem is installed.
-    # Twitter::Streaming::Connection will be monkey-patched.
-    patch_required = false
-
-    if Twitter::Version.const_defined?(:MAJOR)
-      b5_version = Twitter::Version::MAJOR * 10000
-      + Twitter::Version::MINOR * 100 + Twitter::Version::PATCH
-      if b5_version <= 51400
-        warn "[rbitter] Monkey-patching Twitter::Streaming::Connection"
-        warn "[rbitter] Please upgrade twitter gem to apply streaming read timeout"
-        patch_required = true
-      end
-    else
-      b6_version = Twitter::Version.to_a
-      if b6_version[0] <= 6 and b6_version[1] <= 0 and b6_version[2] <= 0
-        patch_required = true
-      end
-    end
-
-    require "rbitter/libtwitter_connection_override" if patch_required
-  end
-
   def self.bootstrap_configs
     require "rbitter/default/config_json"
 
@@ -61,8 +39,6 @@ module Rbitter
     return nil if args.length < 1
     
     if args[0] == "serve"
-      prebootstrap
-
       Rbitter.config_initialize
       
       archive_server = Rbitter::ArcServer.new

data/spec/rbitter/env_spec.rb

@@ -53,10 +53,24 @@ describe Rbitter do
     end
   end
 
-  context 'when env_validator validates loaded configuration' do
-    # TODO: Perform test with spec/config/default.json
-    # TODO: Adding configuration validator on env.rb
-  end
+  context "when 'env_valid?' validates loaded configuration" do
+    before(:all) do
+      Rbitter.bootstrap(['configure'])
+      expect(File.file?('config.json')).to be(true)
+    end
+
+    it 'gets \'false\' for empty configuration' do
+      Rbitter.env_reset
+      expect(Rbitter.env_valid?).to be(false)
+    end
 
-  # TODO: Perform test with spec/config/default.json
+    it "gets \'true\' with default and another default" do
+      Rbitter.config_initialize
+      expect(Rbitter.env_valid?).to be(true)
+    end
+
+    after(:all) do
+      File.delete('config.json')
+    end
+  end
 end

data/spec/rbitter/{libtwitter_connection_override_spec.rb → override/gems/twitter/connection_spec.rb}

@@ -1,5 +1,5 @@
 # encoding: utf-8
-require "rbitter/libtwitter_connection_override"
+require "rbitter/override/gems/twitter/connection"
 
 describe Rbitter do
   it 'overrides twitter gem' do

data/spec/rbitter_spec.rb

@@ -22,10 +22,6 @@ describe Rbitter do
       Rbitter.bootstrap(['configure'])
     end
 
-    it 'executes prebootstrap properly' do
-      Rbitter.prebootstrap
-    end
-
     it 'bootstraps nothing when empty ARGV is given'  do
       Rbitter.bootstrap([])
     end

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: rbitter
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: java
 authors:
 - Nidev Plontra
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2015-05-17 00:00:00.000000000 Z
+date: 2015-06-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.14'
   name: twitter
@@ -21,13 +21,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.14'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.7'
   name: json
@@ -35,13 +35,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
   name: ripl
@@ -49,13 +49,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '4.0'
   name: activerecord
@@ -63,13 +63,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '4.0'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   name: activerecord-jdbc-adapter
@@ -77,13 +77,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.8'
   name: jdbc-sqlite3
@@ -91,13 +91,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.8'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.1'
   name: jdbc-mysql
@@ -105,13 +105,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '5.1'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   name: activerecord-jdbcsqlite3-adapter
@@ -119,13 +119,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   name: activerecord-jdbcmysql-adapter
@@ -133,13 +133,13 @@ dependencies:
   type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
   name: bundler
@@ -147,13 +147,13 @@ dependencies:
   type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
   name: rake
@@ -161,7 +161,7 @@ dependencies:
   type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
 description: Rbitter archives all tweets appeared on user streaming using ActiveRecord. XMLRPC is used to serve archived tweets and useful features
@@ -172,14 +172,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
+- .gitignore
+- .rspec
+- .travis.yml
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
-- XMLRPC.md
 - bin/rbitter
 - lib/rbitter.rb
 - lib/rbitter/arcserver.rb
@@ -187,7 +186,9 @@ files:
 - lib/rbitter/default/config_json.rb
 - lib/rbitter/dlthread.rb
 - lib/rbitter/env.rb
-- lib/rbitter/libtwitter_connection_override.rb
+- lib/rbitter/override.rb
+- lib/rbitter/override/gems/rubysl-socket/socket.rb
+- lib/rbitter/override/gems/twitter/connection.rb
 - lib/rbitter/records.rb
 - lib/rbitter/records_migrate/.keep
 - lib/rbitter/records_migrate/20150327_add_index.rb
@@ -207,7 +208,8 @@ files:
 - spec/rbitter/default/config_json_spec.rb
 - spec/rbitter/dlthread_spec.rb
 - spec/rbitter/env_spec.rb
-- spec/rbitter/libtwitter_connection_override_spec.rb
+- spec/rbitter/override/gems/rubysl-socket/socket_spec.rb
+- spec/rbitter/override/gems/twitter/connection_spec.rb
 - spec/rbitter/records_spec.rb
 - spec/rbitter/streaming_spec.rb
 - spec/rbitter/version_spec.rb
@@ -229,17 +231,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project:
-rubygems_version: 2.4.5
+rubygems_version: 2.4.6
 signing_key:
 specification_version: 4
 summary: Rbitter is a Twitter client specialized in archiving
@@ -251,7 +253,8 @@ test_files:
 - spec/rbitter/default/config_json_spec.rb
 - spec/rbitter/dlthread_spec.rb
 - spec/rbitter/env_spec.rb
-- spec/rbitter/libtwitter_connection_override_spec.rb
+- spec/rbitter/override/gems/rubysl-socket/socket_spec.rb
+- spec/rbitter/override/gems/twitter/connection_spec.rb
 - spec/rbitter/records_spec.rb
 - spec/rbitter/streaming_spec.rb
 - spec/rbitter/version_spec.rb

data/XMLRPC.md

@@ -1,19 +0,0 @@
-# What is RPC handle ? #
-## Commands ##
-### Authentication ###
-### Revoke Authentication Token ###
-### Echo ###
-### Last Active ###
-### Retriever ###
-### Statistic ###
-# How to write own RPC handle? #
-RPC handle is a Ruby class. Writing a method in Ruby class, that's it. Names of methods are treated as XMLRPC command.
-
-When you write a new class for your own RPC handle, you must inherit either Auth or NoAuth class from rpc/base.rb.
-
-* class Auth < Object: Methods in a Ruby class inheriting Auth requires *auth_key* to access.
-* class NoAuth < Object: Methods in a Ruby class inheriting NoAuth doesn't require *auth_key* and these XMLRPC commands can be called by anonymous user.
-
-Filename should start with 'rh_'. It's prefix to be autoloaded by xmlrpc.rb.
-
-Refer rpc/rh_echo.rb as an example.