Merge branch 'feature/issue-link' into develop

Author: lesstif

README.md

@@ -115,6 +115,11 @@ $iss = new IssueService(new ArrayConfiguration(
 - [Get Issue worklog](#get-issue-worklog)
 - [Add watcher in Issue](#add-issue-watcher)
 
+### IssueLink
+
+* [Create Issue Link](#create-issue-link)
+* [Get Issue LinkType](#get-issue-linktype)
+
 ### User
 - [Get User Info](#get-user-info)
 
@@ -845,7 +850,58 @@ try {
 } catch (JiraException $e) {
     $this->assertTrue(false, 'testSearch Failed : '.$e->getMessage());
 }
+```
+
+#### Create Issue Link
+
+The Link Issue Resource provides functionality to manage issue links.
+
+```php
+<?php
+require 'vendor/autoload.php';
+
+use JiraRestApi\IssueLink\IssueLink;
+use JiraRestApi\IssueLink\IssueLinkService;
+use JiraRestApi\JiraException;
+
+try {
+    $il = new IssueLink();
+
+    $il->setInwardIssue('TEST-258')
+        ->setOutwardIssue('TEST-249')
+        ->setLinkTypeName('Relates' )
+        ->setComment('Linked related issue via REST API.');
+            
+    $ils = new IssueLinkService();
+
+    $ret = $ils->addIssueLink($il);
+
+} catch (JiraException $e) {
+	print("Error Occured! " . $e->getMessage());
+}
+```
+
+#### Get Issue LinkType
+
+Rest resource to retrieve a list of issue link types.
+
+```php
+<?php
+require 'vendor/autoload.php';
 
+use JiraRestApi\IssueLink\IssueLink;
+use JiraRestApi\IssueLink\IssueLinkService;
+use JiraRestApi\JiraException;
+
+try {
+    $ils = new IssueLinkService();
+
+    $ret = $ils->getIssueLinkTypes();
+    
+    var_dump($ret);
+} catch (JiraException $e) {
+	print("Error Occured! " . $e->getMessage());
+}
 ```
 
 #### Get User Info

src/IssueLink/IssueLink.php

@@ -0,0 +1,79 @@
+<?php
+
+namespace JiraRestApi\IssueLink;
+
+use JiraRestApi\ClassSerialize;
+use JiraRestApi\Issue\Comment;
+
+class IssueLink implements \JsonSerializable
+{
+    use ClassSerialize;
+
+    public function jsonSerialize()
+    {
+        $vars = array_filter(get_object_vars($this));
+
+        return $vars;
+    }
+
+    /**
+     * @param $typeName issue type string(ex:  'Duplicate')
+     * @return $this
+     */
+    public function setLinkTypeName($typeName)
+    {
+        $this->type['name'] = $typeName;
+
+        return $this;
+    }
+
+    /**
+     * @param $issueKey inward issue key or id
+     * @return $this
+     */
+    public function setInwardIssue($issueKey)
+    {
+        $this->inwardIssue['key'] = $issueKey;
+
+        return $this;
+    }
+
+    /**
+     * @param $issueKey out ward issue key or id
+     * @return $this
+     */
+    public function setOutwardIssue($issueKey)
+    {
+        $this->outwardIssue['key'] = $issueKey;
+
+        return $this;
+    }
+
+    /**
+     * @param $comment string or \JiraRestApi\Issue\Comment instance
+     * @return $this
+     */
+    public function setComment($comment)
+    {
+        if (is_string($comment)) {
+            $this->comment = new Comment();
+            $this->comment->setBody($comment);
+        } else if($comment instanceof Comment ) {
+            $this->comment = $comment;
+        }
+
+        return $this;
+    }
+
+    /** @var array */
+    public $type;
+
+    /** @var  \JiraRestApi\Issue\Issue */
+    public $inwardIssue;
+
+    /** @var  \JiraRestApi\Issue\Issue */
+    public $outwardIssue;
+
+    /** @var \JiraRestApi\Issue\Comment */
+    public $comment;
+}

src/IssueLink/IssueLinkService.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace JiraRestApi\IssueLink;
+
+use JiraRestApi\JiraException;
+
+class IssueLinkService extends \JiraRestApi\JiraClient
+{
+    private $uri = '';
+
+    public function addIssueLink($issueLink)
+    {
+        $this->log->addInfo("addIssueLink=\n");
+
+        $data = json_encode($issueLink);
+
+        $this->log->addDebug("Create IssueLink=\n".$data);
+
+        $url = $this->uri . "/issueLink";
+        $type = 'POST';
+
+        $ret = $this->exec($url, $data, $type);
+    }
+
+    public function getIssueLinkTypes()
+    {
+        $this->log->addInfo("getIssueLinkTYpes=\n");
+
+        $url = $this->uri . "/issueLinkType";
+
+        $ret = $this->exec($url);
+
+        $data = json_encode(json_decode($ret)->issueLinkTypes);
+
+        $linkTypes = $this->json_mapper->mapArray(
+            json_decode($data, false), new \ArrayObject(), '\JiraRestApi\IssueLink\IssueLinkType'
+        );
+
+        return $linkTypes;
+    }
+}

src/IssueLink/IssueLinkType.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace JiraRestApi\IssueLink;
+
+use JiraRestApi\ClassSerialize;
+
+/**
+ * Class IssueLinkType
+ * @package JiraRestApi\Issue
+ * @see https://docs.atlassian.com/jira/REST/server/#api/2/issueLinkType-createIssueLinkType
+ */
+class IssueLinkType implements \JsonSerializable
+{
+    use ClassSerialize;
+
+    public function jsonSerialize()
+    {
+        $vars = array_filter(get_object_vars($this));
+
+        return $vars;
+    }
+
+    /** @var integer */
+    public $id;
+
+    /** @var string */
+    public $name;
+
+    /** @var  string */
+    public $inward;
+
+    /** @var string */
+    public $outward;
+
+    /** @var  string */
+    public $self;
+}

src/JiraClient.php

@@ -191,8 +191,11 @@ public function exec($context, $post_data = null, $custom_request = null)
             $body = curl_error($ch);
             curl_close($ch);
 
-            //The server successfully processed the request, but is not returning any content.
-            if ($this->http_response == 204) {
+            /*
+             * 201: The request has been fulfilled, resulting in the creation of a new resource.
+             * 204: The server successfully processed the request, but is not returning any content.
+             */
+            if ($this->http_response === 204 || $this->http_response === 201) {
                 return true;
             }