Converting Queue and Delete Handlers into services, eliminating ::create methods, and updated tests.

* 8.x-3.x:
  Updated ROADMAP.txt
  purged final bits of logger businesses from pull module
  Adds views integration for Mapped Object
  Issue #2860857 by Znak: Class Exception is deprecated
  Converts logger or logger factory services to SF events
  Issue #2859979 by chrisrikli: Entity hook examples for salesforce_example
  - Adds Exception Event Interface - Adds salesforce logger channel - Adds DIC on logger channel to event subscriber - Template for eliminating log messages from core functionality
  Converts logging service to event dispatcher service in pull code
  - Add salesforce_logger module to separate logging concerns - Remove MappedObjectInterface::logger method in favor of dispatching SalesforceExceptionEvent events
  Refactor of Event classes

Conflicts:
	modules/salesforce_encrypt/src/Rest/RestClient.php
	modules/salesforce_encrypt/tests/src/Unit/RestClientTest.php
	modules/salesforce_mapping/src/Entity/MappedObject.php
	modules/salesforce_mapping/src/Form/MappedObjectForm.php
	modules/salesforce_mapping/src/Plugin/SalesforceMappingField/RelatedProperties.php
	modules/salesforce_pull/src/DeleteHandler.php
	modules/salesforce_pull/src/Plugin/QueueWorker/PullBase.php
	modules/salesforce_pull/src/QueueHandler.php
	modules/salesforce_pull/tests/src/Unit/DeleteHandlerTest.php
	modules/salesforce_push/salesforce_push.module
	modules/salesforce_push/src/PushQueue.php
	src/Form/AuthorizeForm.php
	tests/src/Unit/RestClientTest.php
	tests/src/Unit/SalesforceControllerTest.php

Alexander Rhodes authored 8 years ago and Aaron Bauman committed 8 years ago

Adds salesforce_logger module to isolate concerns of error logging. All error, notice, warning events should dispatch the appropriate SalesforceExceptionEvent, which is subscribed by salesforce_logger if enabled.

All known logger calls have been converted to event dispatcher calls which dispatch
Salesforce events that perform the logging.

- Adds salesforce logger channel
- Adds DIC on logger channel to event subscriber
- Template for eliminating log messages from core functionality

PullBase’s logging not converted due to impending sweeping changes in
mads-30 branch to same file.

- Remove MappedObjectInterface::logger method in favor of dispatching SalesforceExceptionEvent events

All references to salesforce_encrypt.client service removed
salesforce_encrypt.client service definition removed
Unused use statements removed from EncryptedRestClientInterface andRestCientInterface
Constructors removed from EncryptedRestClientInterface and RestClientInterface
Salesforce_encrypt\RestClient constructor cleaned up
Adds Json mock to salesforce_encrypt\RestClientTest
Fixes service name error in PullBase
Fixes property visibility settings in RestClient so child salesforce_encrypt\RestClient may
inherit them.

* 8.x-3.x:
  Get rid of PHP Notice, which is throwing exception on testbot
  Adds new "authorize salesforce" permission to SalesforceAdminSettingsTest
  Add support for Encrypt

Conflicts:
	modules/salesforce_mapping/src/Form/MappedObjectForm.php
	src/Form/AuthorizeForm.php
	src/Rest/RestClient.php
	src/Rest/RestClientInterface.php

Normalizes RestClientInterface injection in DeleteHandler and QueueHandler
All unit tests passing

# Conflicts:
#	modules/salesforce_mapping/src/Form/MappedObjectForm.php
#	modules/salesforce_pull/src/DeleteHandler.php
#	modules/salesforce_pull/src/Plugin/QueueWorker/PullBase.php
#	modules/salesforce_pull/src/QueueHandler.php
#	src/Form/AuthorizeForm.php
#	src/Rest/RestClient.php
#	src/Rest/RestClientInterface.php

and SaleforceControllerTest so all units tests pass.

RestClientTest::initClient

Makes linter pass on RestClientTest

Makes linter pass on MappedObject
Adds missing SalesforcePushParamsEvent use statement to MappedObject

Completes intelligent Drupal entity ID upsert code in PullBase

If the SF API cannot be reached while trying to save the entity ID in SF, the queue processing is
halted and the current queue item and remaining queue items are kept to process on a future pass.
A check has been added on PullBase::updateEntity() to send the Entity ID to SF if none exists and
the ID is configured to sync.
Adds PullException to facilitate throwing expected Exception up to Cron to tell Cron to suspend
queue processing but keep current and remaining queue items.

Add check on results return in QueueHandler to avoid error of calling $results->records on non-
existant object.
Updates RestClient::apiCall to throw RestExceptions in all error cases
Updates PullBase to detect RestExceptions from RestClient.

Includes test code in PullBase to force exceptions to test new logic. SuspendQueueException may
not be the proper Queue Exception to throw - it seems to delete/‘release’ the problematic item when
it should be kept so it can be processed fully.

Adds new state value to force an update in PullBase::updateEntity

Adds first pass at making pushing upset IDs to SF optional/configurable. It only pushes if the
mapping has a defined upsert key.

# Conflicts:
#	modules/salesforce_mapping/src/Entity/MappedObject.php
#	modules/salesforce_mapping/src/Form/MappedObjectForm.php
#	modules/salesforce_mapping/src/Plugin/SalesforceMappingField/RelatedProperties.php
#	modules/salesforce_mapping/tests/src/Unit/MappedObjectTest.php
#	modules/salesforce_push/salesforce_push.module
#	modules/salesforce_push/src/PushQueue.php
#	src/Form/AuthorizeForm.php