won.protocol.service

Interface MatcherFacingAtomCommunicationService

All Known Subinterfaces:

MatcherProtocolAtomService, MatcherProtocolAtomServiceClientSide

public interface MatcherFacingAtomCommunicationService

Interface defining methods for atom communication. TODO [REFACTORING]: delete this and move methods to node interface

Method Summary

Modifier and Type	Method and Description
void	hint(java.net.URI atomURI, java.net.URI otherAtom, double score, java.net.URI originator, org.apache.jena.rdf.model.Model content, WonMessage wonMessage) Notifies the atom of a matching otherAtom with the specified match score.

Method Detail

hint

void hint(java.net.URI atomURI,
          java.net.URI otherAtom,
          double score,
          java.net.URI originator,
          org.apache.jena.rdf.model.Model content,
          WonMessage wonMessage)
   throws java.lang.Exception

Notifies the atom of a matching otherAtom with the specified match score. Originator identifies the entity making the call. Normally, originator is a matching service. Expects <> won:socket [SOCKET] in the RDF content, will choose a socket supported by the atom if none is present.

Parameters:

atomURI - the URI of the atom

otherAtom - URI of the other atom (may be on the local atomserver)

score - match score between 0.0 (bad) and 1.0 (good). Implementations treat lower values as 0.0 and higher values as 1.0.

originator - an URI identifying the calling entity

content - (optional) an optional RDF graph containing more detailed information about the hint. The null releative URI ('<>') inside that graph, as well as the base URI of the graph will be attached to the resource identifying the match event.

Throws:

NoSuchAtomException - if atomURI is not a known atom URI

IllegalMessageForAtomStateException - if the atom is not active

java.lang.Exception