ZohoClient - Code Metrics - Inspection of "Merge pull request #32 from moufmouf/1.2" - Wabel/zoho-crm-orm - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — 1.2 ( 52818d...320c8c )

by David

created 2018-09-05 08:35 UTC

ZohoClient C

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	508
Duplicated Lines	5.31 %

Coupling/Cohesion

Components	1
Dependencies	6

Importance

Changes

Metric	Value
wmc	55
lcom	1
cbo	6
dl	27
loc	508
rs	6
c	0
b	0
f	0

18 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	8	2
A	convertLead()	0	8	1
A	getFields()	0	6	1
A	deleteRecords()	0	9	1
A	getRecordById()	0	11	2
B	getRecords()	0	25	7
A	getDeletedRecordIds()	0	15	4
A	getRelatedRecords()	0	14	3
B	searchRecords()	0	24	6
A	getUsers()	0	18	6
A	insertRecords()	0	16	4
A	updateRecords()	13	13	3
A	updateRelatedRecords()	14	14	3
A	uploadFile()	0	28	5
A	downloadFile()	0	6	1
A	getModules()	0	4	1
A	call()	0	22	3
A	getRequestURI()	0	9	2

How to fix Duplicated Code Complexity

Duplicated Code

Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.

Common duplication problems, and corresponding solutions are:

If you have the same expression in different places: Extract expression to a method
If you have the same method in different sub-classes: Extract method, and pull up field to the parent class
If you have the same code in unrelated classes: Consider extracting the code to a new class, and injecting that class

Complex Class

Tip: Before tackling complexity, make sure that you eliminate any duplication first. This often can reduce the size of classes significantly.

Complex classes like ZohoClient often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.

Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.

While breaking up the class, it is a good idea to analyze how other classes use ZohoClient, and based on these observations, apply Extract Interface, too.

<?php

namespace Wabel\Zoho\CRM;

use Guzzle\Common\Exception\InvalidArgumentException;
use GuzzleHttp\Client;
use Psr\Http\Message\UriInterface;
use Wabel\Zoho\CRM\Exception\ZohoCRMResponseException;
use Wabel\Zoho\CRM\Request\Response;

/**
 * Client for provide interface with Zoho CRM.
 *
 * TODO : Add comments (a lot)
 */
class ZohoClient
{
    /**
     * .com URL for call request.
     *
     * @var string
     */
    const COM_BASE_URI = 'https://crm.zoho.com/crm/private';

    /**
     * .eu URL for call request.
     *
     * @var string
     */
    const EU_BASE_URI = 'https://crm.zoho.eu/crm/private';

    /**
     * Configurable URL for call request.
     *
     * @var string
     */
    protected $baseUri;

    /**
     * Token used for session of request.
     *
     * @var string
     */
    protected $authtoken;

    /**
     * Instance of the client.
     *
     * @var Client
     */
    protected $zohoRestClient;

    /**
     * Format selected for get request.
     *
     * @var string
     */
    protected $format;

    /**
     * Module selected for get request.
     *
     * @var string
     */
    protected $module;

    /**
     * Construct.
     *
     * @param string $authtoken      Token for connection
     * @param Client $zohoRestClient Guzzl Client for connection [optional]
     * @param string $baseUri        Configurable URL for call request
     */
    public function __construct(string $authtoken, Client $zohoRestClient = null, string $baseUri = self::COM_BASE_URI)
    {
        $this->baseUri = $baseUri;
        $this->authtoken = $authtoken;
        // Only XML format is supported for the time being
        $this->format = 'xml';
        $this->zohoRestClient = $zohoRestClient ?: new Client();
    }

    /**
     * Implements convertLead API method.
     *
     * @param $leadId
     * @param $data
     * @param array $params
     *
     * @return Response The Response object
     *
     * @throws ZohoCRMResponseException
     */
    public function convertLead($leadId, $data, $params = array())
    {
        $module = 'Leads';
        $params['leadId'] = $leadId;
        $params['newFormat'] = 1;

        return $this->call($module, 'convertLead', $params, $data);
    }

    /**
     * Implements getFields API method.
     *
     * @return Response The Response object
     */
    public function getFields($module)
    {
        $params['newFormat'] = 1;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}

        return $this->call($module, 'getFields', array());
    }

    /**
     * Implements deleteRecords API method.
     *
     * @param string $module
     * @param string $id     Id of the record
     *
     * @return Response The Response object
     *
     * @throws ZohoCRMResponseException
     */
    public function deleteRecords($module, $id)
    {
        $params = array(
            'id' => $id,
            'newFormat' => 1,
        );

        return $this->call($module, 'deleteRecords', $params);
    }

    /**
     * Implements getRecordById API method.
     *
     * @param string $module The module to use
     * @param string $id     Id of the record or a list of IDs separated by a semicolon
     *
     * @return Response The Response object
     *
     * @throws ZohoCRMResponseException
     */
    public function getRecordById($module, $id)
    {
        if (strpos($id, ';') === false) {
            $params['id'] = $id;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        } else {
            $params['idlist'] = $id;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        }
        $params['newFormat'] = 1;

        return $this->call($module, 'getRecordById', $params);
    }

    /**
     * Implements getRecords API method.
     *
     * @param $module
     * @param $sortColumnString
     * @param $sortOrderString
     * @param \DateTime $lastModifiedTime
     * @param $selectColumns
     * @param $fromIndex
     * @param $toIndex
     *
     * @return Response The Response object
     *
     * @throws ZohoCRMResponseException
     */
    public function getRecords($module, $sortColumnString = null, $sortOrderString = null, \DateTimeInterface $lastModifiedTime = null, $selectColumns = null, $fromIndex = null, $toIndex = null)
    {
        $params['newFormat'] = 1;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        $params['version'] = 1;
        if ($selectColumns) {
            $params['selectColumns'] = $selectColumns;
        }
        if ($fromIndex) {
            $params['fromIndex'] = $fromIndex;
        }
        if ($toIndex) {
            $params['toIndex'] = $toIndex;
        }
        if ($sortColumnString) {
            $params['sortColumnString'] = $sortColumnString;
        }
        if ($sortOrderString) {
            $params['sortOrderString'] = $sortOrderString;
        }
        if ($lastModifiedTime) {
            $params['lastModifiedTime'] = $lastModifiedTime->format('Y-m-d H:i:s');
        }

        return $this->call($module, 'getRecords', $params);
    }

    /**
     * Implements getDeletedRecordIds API method.

     *
     * @param string             $module
     * @param \DateTimeInterface $lastModifiedTime
     * @param int                $fromIndex
     * @param int                $toIndex
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function getDeletedRecordIds($module, \DateTimeInterface $lastModifiedTime = null, $fromIndex = null, $toIndex = null)
    {
        $params = [];
        if ($fromIndex) {
0   == false // true
0   == null  // true
123 == false // false
123 == null  // false

// It is often better to use strict comparison
0 === false // false
0 === null  // false
            $params['fromIndex'] = $fromIndex;
        }
        if ($toIndex) {
0   == false // true
0   == null  // true
123 == false // false
123 == null  // false

// It is often better to use strict comparison
0 === false // false
0 === null  // false
            $params['toIndex'] = $toIndex;
        }
        if ($lastModifiedTime) {
            $params['lastModifiedTime'] = $lastModifiedTime->format('Y-m-d H:i:s');
        }

        return $this->call($module, 'getDeletedRecordIds', $params);
    }

    /**
     * Implements getRecords API method.
     *
     * @param $module
     * @param $id
     * @param $parentModule
     * @param null $fromIndex
     * @param null $toIndex
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function getRelatedRecords($module, $id, $parentModule, $fromIndex = null, $toIndex = null)
    {
        $params['id'] = $id;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        $params['parentModule'] = $parentModule;
        $params['newFormat'] = 1;
        if ($fromIndex) {
            $params['fromIndex'] = $fromIndex;
        }
        if ($toIndex) {
            $params['toIndex'] = $toIndex;
        }

        return $this->call($module, 'getRelatedRecords', $params);
    }

    /**
     * Implements searchRecords API method.
     *
     * @param string    $module
     * @param string    $searchCondition
     * @param int       $fromIndex
     * @param int       $toIndex
     * @param \DateTime $lastModifiedTime
     * @param null      $selectColumns
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function searchRecords($module, $searchCondition = null, $fromIndex = null, $toIndex = null, $lastModifiedTime = null, $selectColumns = null)
    {
        if ($searchCondition) {
''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
            $params['criteria'] = $searchCondition;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        } else {
            $params['criteria'] = '()';
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        }
        if ($fromIndex) {
0   == false // true
0   == null  // true
123 == false // false
123 == null  // false

// It is often better to use strict comparison
0 === false // false
0 === null  // false
            $params['fromIndex'] = $fromIndex;
        }
        if ($toIndex) {
0   == false // true
0   == null  // true
123 == false // false
123 == null  // false

// It is often better to use strict comparison
0 === false // false
0 === null  // false
            $params['toIndex'] = $toIndex;
        }
        if ($lastModifiedTime) {
            $params['lastModifiedTime'] = $lastModifiedTime->format('Y-m-d H:i:s');
        }
        if ($selectColumns) {
            $params['selectColumns'] = $selectColumns;
        }

        $params['newFormat'] = 1;

        return $this->call($module, 'searchRecords', $params);
    }

    /**
     * Implements getUsers API method.
     *
     * @param string $type The type of users you want retrieve (among AllUsers, ActiveUsers, DeactiveUsers, AdminUsers and ActiveConfirmedAdmins)
     *
     * @return Response The array of Zoho Beans parsed from the response
     *
     * @throws ZohoCRMResponseException
     */
    public function getUsers($type = 'AllUsers')
    {
        switch ($type) {
            case 'AllUsers':
            case 'ActiveUsers':
            case 'DeactiveUsers':
            case 'AdminUsers':
            case 'ActiveConfirmedAdmins':
                $params['type'] = $type;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
                break;
            default :
                $params['type'] = 'AllUsers';
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
                break;
        }
        $params['newFormat'] = 1;

        return $this->call('Users', 'getUsers', $params);
    }

    /**
     * Implements insertRecords API method.
     *
     * @param $module
     * @param \SimpleXMLElement$xmlData
     * @param bool $wfTrigger
     * @param int  $duplicateCheck
     * @param bool $isApproval
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function insertRecords($module, $xmlData, $wfTrigger = null, $duplicateCheck = null, $isApproval = null, $version = 4, $newFormat = 2)
    {
        if ($wfTrigger) {
            $params['wfTrigger'] = 'true';
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        }
        if ($duplicateCheck) {
0   == false // true
0   == null  // true
123 == false // false
123 == null  // false

// It is often better to use strict comparison
0 === false // false
0 === null  // false
            $params['duplicateCheck'] = $duplicateCheck;
function myFunction($a) {
    switch ($a) {
        case 'foo':
            $x = 1;
            break;

        case 'bar':
            $x = 2;
            break;
    }

    // $x is potentially undefined here.
    echo $x;
}
        }
        if ($isApproval) {
            $params['isApproval'] = 'true';
        }
        $params['newFormat'] = $newFormat;
        $params['version'] = $version;

        return $this->call($module, 'insertRecords', $params, ['xmlData' => $xmlData->asXML()]);
    }

    /**
     * Implements updateRecords API method.
     *
     * @param $module
     * @param \SimpleXMLElement $xmlData
     * @param string            $id
     * @param bool              $wfTrigger
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function updateRecords($module, $xmlData, $id = null, $wfTrigger = null, $version = 4, $newFormat = 2)

    {
        $params['newFormat'] = $newFormat;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        $params['version'] = $version;
        if ($wfTrigger) {
            $params['wfTrigger'] = 'true';
        }
        if ($id) {
''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
            $params['id'] = $id;
        }

        return $this->call($module, 'updateRecords', $params, ['xmlData' => $xmlData->asXML()]);
    }

    /**
     * Implements updateRelatedRecords API method.
     *
     * @param $module
     * @param $relatedModule
     * @param \SimpleXMLElement $xmlData
     * @param string            $id
     * @param bool              $wfTrigger
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function updateRelatedRecords($module, $relatedModule, $xmlData, $id = null, $wfTrigger = null, $version = 4, $newFormat = 2)

    {
        $params['newFormat'] = $newFormat;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        $params['version'] = $version;
        $params['relatedModule'] = $relatedModule;
        if ($wfTrigger) {
            $params['wfTrigger'] = 'true';
        }
        if ($id) {
''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
            $params['id'] = $id;
        }

        return $this->call($module, 'updateRelatedRecords', $params, ['xmlData' => $xmlData->asXML()]);
    }

    /**
     * Implements uploadFile API method.
     *
     * @param $module
     * @param $id
     * @param $content
     * @param $filename
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function uploadFile($module, $id, $content, $filename = null)
    {
        $getParams['id'] = $id;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}
        $postParams = [];

        if ($content instanceof UriInterface) {
            $getParams['attachmentUrl'] = $content->__toString();
        } else {
            $innerPostParams = [];
            $innerPostParams['name'] = 'content';
            if ($content instanceof \SplFileInfo) {
                $innerPostParams['filename'] = $filename ?? $content->getBasename();
                $innerPostParams['contents'] = $content->openFile();
            } else if (is_resource($content)) {
                $innerPostParams['filename'] = $filename ?? basename(stream_get_meta_data($content)["uri"]);
                $innerPostParams['contents'] = $content;
            } else {
                if (!$filename) {
                    throw new InvalidArgumentException('filename cannot be empty');
                }
                $innerPostParams['filename'] = $filename;
                $innerPostParams['contents'] = $content;
            }
            $postParams[] = $innerPostParams;
        }

        return $this->call($module, 'uploadFile', ['id' => $id], $postParams);
    }

    /**
     * Implements downloadFile API method.
     *
     * @param $module
     * @param $id
     *
     * @return Response
     *
     * @throws ZohoCRMResponseException
     */
    public function downloadFile($module, $id)
    {
        $params['id'] = $id;
foreach ($collection as $item) {
    $myArray['foo'] = $item->getFoo();

    if ($item->hasBar()) {
        $myArray['bar'] = $item->getBar();
    }

    // do something with $myArray
}

        return $this->call($module, 'downloadFile', $params);
    }

    /**
     * Returns a list of modules from Zoho.
     */
    public function getModules()
    {
        return $this->call('Info', 'getModules', ['type' => 'api']);
    }
    
    /**
     * Make the call using the client.
     *
     * @param string                   $module  The module to use
     * @param string                   $command Command to call
     * @param array                    $params  Options
/**
 * @param array $germany
 * @param array $ireland
 */
function finale($germany, $island) {
    return "2:1";
}
     * @param \SimpleXMLElement|string $data    Data to send [optional]
/**
 * @param array $germany
 * @param array $island
 * @param array $italy
 */
function finale($germany, $island) {
    return "2:1";
}
     * @param array                    $options Options to add for configurations [optional]
/**
 * @param array $germany
 * @param array $island
 * @param array $italy
 */
function finale($germany, $island) {
    return "2:1";
}
     *
     * @return Response
     */
    public function call($module, $command, $getParams = array(), $postParams = array())
    {
        $getParams['authtoken'] = $this->authtoken;
        $getParams['scope'] = 'crmapi';

        $uri = $this->getRequestURI($module, $command);
        if(isset($postParams['xmlData'])){
            $postParams[]=[
                'name' => 'xmlData',
                'contents' => $postParams['xmlData']
            ];
            unset($postParams['xmlData']);
        }

        $response = $this->zohoRestClient->request('POST', $uri, ['query'=>$getParams,'multipart'=> $postParams]);
        $zohoResponse = new Response((string)$response->getBody(), $module, $command);
        if ($zohoResponse->ifSuccess()) {
            return $zohoResponse;
        } else {
            throw new ZohoCRMResponseException($zohoResponse);
        }
    }

    /**
     * Get the current request uri.
     *
     * @param  $module The module to use
     * @param string $command Command for get uri
     *
     * @return string
     */
    protected function getRequestURI($module, $command)
    {
        if (empty($module)) {
            throw new \RuntimeException('Zoho CRM module is not set.');
        }
        $parts = array($this->baseUri, $this->format, $module, $command);

        return implode('/', $parts);
    }
}


1			<?php
2
3			namespace Wabel\Zoho\CRM;
4
5			use Guzzle\Common\Exception\InvalidArgumentException;
6			use GuzzleHttp\Client;
7			use Psr\Http\Message\UriInterface;
8			use Wabel\Zoho\CRM\Exception\ZohoCRMResponseException;
9			use Wabel\Zoho\CRM\Request\Response;
10
11			/**
12			* Client for provide interface with Zoho CRM.
13			*
14			* TODO : Add comments (a lot)
15			*/
16			class ZohoClient
17			{
18			/**
19			* .com URL for call request.
20			*
21			* @var string
22			*/
23			const COM_BASE_URI = 'https://crm.zoho.com/crm/private';
24
25			/**
26			* .eu URL for call request.
27			*
28			* @var string
29			*/
30			const EU_BASE_URI = 'https://crm.zoho.eu/crm/private';
31
32			/**
33			* Configurable URL for call request.
34			*
35			* @var string
36			*/
37			protected $baseUri;
38
39			/**
40			* Token used for session of request.

Wabel / zoho-crm-orm