won.protocol.service

Interface MatcherFacingNeedCommunicationService

All Known Subinterfaces:

MatcherProtocolNeedService, MatcherProtocolNeedServiceClientSide

public interface MatcherFacingNeedCommunicationService

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

Method Summary

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

Method Detail

hint

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

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

Parameters:

needURI - the URI of the need

otherNeed - URI of the other need (may be on the local needserver)

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:

NoSuchNeedException - if needURI is not a known need URI

IllegalMessageForNeedStateException - if the need is not active

java.lang.Exception