@return true if the Source is exhausted
FIXME This probably won’t work properly
Finds and returns the first node that matches the supplied xpath.
The context element
The xpath to search for. If not supplied or nil, returns the first node matching ‘*’.
If supplied, a Hash which defines a namespace mapping.
If supplied, a Hash which maps $variables in the query to values. This can be used to avoid XPath injection attacks or to automatically handle escaping string values.
XPath.first( node )
XPath.first( doc, "//b"} )
XPath.first( node, "a/x:b", { "x"=>"http://doofus" } )
XPath.first( node, '/book/publisher/text()=$publisher', {}, {"publisher"=>"O'Reilly"})
Performs a depth-first (document order) XPath search, and returns the first match. This is the fastest, lightest way to return a single result.
FIXME: This method is incomplete!
Registers for notifications of event ev on the proxied TupleSpace. See TupleSpace#notify
Creates a singleton RingFinger and looks for a RingServer. Returns the created RingFinger.
Returns the first advertised TupleSpace.
Called by TupleSpace to notify this NotifyTemplateEntry of a new event.
Retrieves a notification. Raises RequestExpiredError when this NotifyTemplateEntry expires.
Registers for notifications of event. Returns a NotifyTemplateEntry. See NotifyTemplateEntry for examples of how to listen for notifications.
event can be:
A tuple was added
A tuple was taken or moved
A tuple was lost after being overwritten or expiring
The TupleSpace will also notify you of the ‘close’ event when the NotifyTemplateEntry has expired.