Module DRb
In: lib/drb/extserv.rb
lib/drb/drb.rb
lib/drb/eq.rb
lib/drb/extservm.rb
lib/drb/gw.rb
lib/drb/invokemethod.rb
lib/drb/observer.rb
lib/drb/ssl.rb
lib/drb/timeridconv.rb
lib/drb/unix.rb

for ruby-1.8.0

Methods

config   current_server   fetch_server   front   here?   install_acl   install_id_conv   regist_server   remove_server   start_service   stop_service   thread   to_id   to_obj   uri  

Classes and Modules

Module DRb::DRbObservable
Module DRb::DRbProtocol
Module DRb::DRbUndumped
Class DRb::DRbArray
Class DRb::DRbBadScheme
Class DRb::DRbBadURI
Class DRb::DRbConn
Class DRb::DRbConnError
Class DRb::DRbError
Class DRb::DRbIdConv
Class DRb::DRbMessage
Class DRb::DRbObject
Class DRb::DRbRemoteError
Class DRb::DRbSSLSocket
Class DRb::DRbServer
Class DRb::DRbServerNotFound
Class DRb::DRbTCPSocket
Class DRb::DRbUNIXSocket
Class DRb::DRbUnknown
Class DRb::DRbUnknownError
Class DRb::ExtServ
Class DRb::ExtServManager
Class DRb::GW
Class DRb::GWIdConv
Class DRb::TimerIdConv

Attributes

primary_server  [RW]  The primary local dRuby server.

This is the server created by the start_service call.

Public Instance methods

config()

Get the configuration of the current server.

If there is no current server, this returns the default configuration. See current_server and DRbServer::make_config.

[Source]

      # File lib/drb/drb.rb, line 1683
1683:   def config
1684:     current_server.config
1685:   rescue
1686:     DRbServer.make_config
1687:   end
current_server()

Get the ‘current’ server.

In the context of execution taking place within the main thread of a dRuby server (typically, as a result of a remote call on the server or one of its objects), the current server is that server. Otherwise, the current server is the primary server.

If the above rule fails to find a server, a DRbServerNotFound error is raised.

[Source]

      # File lib/drb/drb.rb, line 1647
1647:   def current_server
1648:     drb = Thread.current['DRb'] 
1649:     server = (drb && drb['server']) ? drb['server'] : @primary_server 
1650:     raise DRbServerNotFound unless server
1651:     return server
1652:   end
fetch_server(uri)

[Source]

      # File lib/drb/drb.rb, line 1755
1755:   def fetch_server(uri)
1756:     @server[uri]
1757:   end
front()

Get the front object of the current server.

This raises a DRbServerNotFound error if there is no current server. See current_server.

[Source]

      # File lib/drb/drb.rb, line 1694
1694:   def front
1695:     current_server.front
1696:   end
here?(uri)

Is uri the URI for the current local server?

[Source]

      # File lib/drb/drb.rb, line 1674
1674:   def here?(uri)
1675:     (current_server.uri rescue nil) == uri
1676:   end
install_acl(acl)

Set the default acl.

See DRb::DRbServer.default_acl.

[Source]

      # File lib/drb/drb.rb, line 1736
1736:   def install_acl(acl)
1737:     DRbServer.default_acl(acl)
1738:   end
install_id_conv(idconv)

Set the default id conv object.

See DRbServer#default_id_conv.

[Source]

      # File lib/drb/drb.rb, line 1728
1728:   def install_id_conv(idconv)
1729:     DRbServer.default_id_conv(idconv)
1730:   end
regist_server(server)

[Source]

      # File lib/drb/drb.rb, line 1742
1742:   def regist_server(server)
1743:     @server[server.uri] = server
1744:     Thread.exclusive do
1745:       @primary_server = server unless @primary_server
1746:     end
1747:   end
remove_server(server)

[Source]

      # File lib/drb/drb.rb, line 1750
1750:   def remove_server(server)
1751:     @server.delete(server.uri)
1752:   end
start_service(uri=nil, front=nil, config=nil)

Start a dRuby server locally.

The new dRuby server will become the primary server, even if another server is currently the primary server.

uri is the URI for the server to bind to. If nil, the server will bind to random port on the default local host name and use the default dRuby protocol.

front is the server‘s front object. This may be nil.

config is the configuration for the new server. This may be nil.

See DRbServer::new.

[Source]

      # File lib/drb/drb.rb, line 1626
1626:   def start_service(uri=nil, front=nil, config=nil)
1627:     @primary_server = DRbServer.new(uri, front, config)
1628:   end
stop_service()

Stop the local dRuby server.

This operates on the primary server. If there is no primary server currently running, it is a noop.

[Source]

      # File lib/drb/drb.rb, line 1659
1659:   def stop_service
1660:     @primary_server.stop_service if @primary_server
1661:     @primary_server = nil
1662:   end
thread()

Get the thread of the primary server.

This returns nil if there is no primary server. See primary_server.

[Source]

      # File lib/drb/drb.rb, line 1720
1720:   def thread
1721:     @primary_server ? @primary_server.thread : nil
1722:   end
to_id(obj)

Get a reference id for an object using the current server.

This raises a DRbServerNotFound error if there is no current server. See current_server.

[Source]

      # File lib/drb/drb.rb, line 1711
1711:   def to_id(obj)
1712:     current_server.to_id(obj)
1713:   end
to_obj(ref)

Convert a reference into an object using the current server.

This raises a DRbServerNotFound error if there is no current server. See current_server.

[Source]

      # File lib/drb/drb.rb, line 1703
1703:   def to_obj(ref)
1704:     current_server.to_obj(ref)
1705:   end
uri()

Get the URI defining the local dRuby space.

This is the URI of the current server. See current_server.

[Source]

      # File lib/drb/drb.rb, line 1668
1668:   def uri
1669:     current_server.uri
1670:   end

[Validate]