addDefaultServant()

virtual void Ice::ObjectAdapter::addDefaultServant ( ObjectPtr servant, std::string category )

pure virtual

Adds a default servant to handle requests for a specific category.

When an object adapter dispatches an incoming request, it tries to find a servant for the identity and facet carried by the request in the following order:

• The object adapter tries to find a servant for the identity and facet in the Active Servant Map.
• If this fails, the object adapter tries to find a default servant for the category component of the identity.
• If this fails, the object adapter tries to find a default servant for the empty category, regardless of the category contained in the identity.
• If this fails, the object adapter tries to find a servant locator for the category component of the identity. If there is no such servant locator, the object adapter tries to find a servant locator for the empty category.
  • If a servant locator is found, the object adapter tries to find a servant using this servant locator.
• If all the previous steps fail, the object adapter gives up and the caller receives an ObjectNotExistException or a FacetNotExistException.

  Parameters

  servant	The default servant to add.
  category	The category for which the default servant is registered. The empty category means it handles all categories.