Adapters, Requests and Data Providers

This article how the classes in \FACTFinder\Core\Server work together to provide the adapters (in \FACTFinder\Adapter) with data from the server.

Adapters

The classes in the Adapter namespace form the main chunk of the library's public interface. All the classes you will use are really just dependencies of the adapters. Each adapter gives you high-level access to one FACT-Finder feature, such as the search itself, the tag cloud, product comparison or suggestions.

Among an adapter's dependencies there is only one for communication with the server: a Core\Server\Request object. Each adapter holds its own Request, which represents parameters and the target of the request and hides the details of the server connection.

Requests

A Request is more than just a data object containing parameters and a request target. It's actually a Facade which hides a Core\Server\ConnectionData object and a Core\Server\DataProvider. It only provides access to the relevant fields in the ConnectionData:

• It gives you read/write access to the parameters and HTTP header fields of the request.
• It gives lets you set the action to be requested on the server (e.g. Search.ff).
• It lets you configure timeouts for the request.
• It gives you access to the server's response.

This interface completely hides the actual execution of the request to the server. All it guarantees is that the server data is available when you call getResponse().

The DataProvider object hidden behind the Request determines how the data is actually obtained (from the server, or otherwise). Details on data providers follow below.

Because, we don't want users to wire up their requests manually, we provide request factories.

Request Factories

For each type of data provider, there is an implementation of Core\Server\RequestFactoryInterface. The factory takes care of wiring up the Request objects for you. For instance, if you want your requests to be performed via cURL's multi-interface (parallel HTTP requests), all you need to do is:

$requestFactory = FF::getInstance('Core\Server\MultiCurlRequestFactory',
                                  $loggerClass,
                                  $configuration,
                                  $requestParameters);

$request = $requestFactory->getRequest();

Of course, you need the last line for each adapter you want to create. Note that the request factory's third parameter is $requestParameters. This should be a Util\Parameters object representing the parameters from the request to the Client, so that requests to the Server can be pre-populated with these. (You can obtain such a Parameters object from Core\Client\RequestParser.)

These two classes, Request and RequestFactory, are the only ones you have to deal with to set up an adapter. The remaining classes are implementation details and therefore mostly of interest to contributors.