ItemsImporterInterface.php

<?php

namespace Drupal\aggregator;


/**
 * Provides an interface defining an aggregator items importer.
 */
interface ItemsImporterInterface {
    
    /**
     * Updates the feed items by triggering the import process.
     *
     * This process can be slow and lengthy because it relies on network
     * operations. Calling it on performance critical paths should be avoided.
     *
     * @param \Drupal\aggregator\FeedInterface $feed
     *   The feed which items should be refreshed.
     *
     * @return bool
     *   TRUE if there is new content for the feed FALSE otherwise.
     */
    public function refresh(FeedInterface $feed);
    
    /**
     * Deletes all imported items from a feed.
     *
     * @param \Drupal\aggregator\FeedInterface $feed
     *   The feed that associated items should be deleted from.
     */
    public function delete(FeedInterface $feed);

}