fixed #110 sends a notification to the recipients.

Author: KwangSeob Jeong

README.md

@@ -119,6 +119,7 @@ $iss = new IssueService(new ArrayConfiguration(
 - [Edit worklog in Issue](#edit-worklog-in-issue)
 - [Get Issue worklog](#get-issue-worklog)
 - [Add watcher in Issue](#add-issue-watcher)
+- [Send a notification to the recipients](#issue-notify)
 
 ### IssueLink
 
@@ -940,10 +941,42 @@ try {
     var_dump($wch);
 
 } catch (JiraException $e) {
-    $this->assertTrue(false, 'testSearch Failed : '.$e->getMessage());
+    $this->assertTrue(false, 'add watcher Failed : '.$e->getMessage());
 }
 ```
 
+#### issue notify
+
+```php
+<?php
+require 'vendor/autoload.php';
+
+use JiraRestApi\Issue\IssueService;
+use JiraRestApi\Issue\Notify;
+use JiraRestApi\JiraException;
+
+$issueKey = 'TEST-961';
+
+try {
+    $issueService = new IssueService();
+
+    $noti = new Notify();
+
+    $noti->setSubject('notify test')
+        ->setTextBody('notify test text body')
+        ->setHtmlBody('<h1>notify</h1>test html body')
+        ->sendToAssignee(true)
+        ->sendToWatchers(true)
+        ->sendToUser('lesstif', true)
+        ->sendToGroup('temp-group')
+    ;
+
+    $issueService->notify($issueKey, $noti);
+    
+} catch (JiraException $e) {
+    $this->assertTrue(false, 'Issue notify Failed : '.$e->getMessage());
+}
+```
 #### Create Issue Link
 
 The Link Issue Resource provides functionality to manage issue links.

src/Issue/IssueService.php

@@ -723,6 +723,8 @@ public function getEditMeta($idOrKey, $overrideEditableFlag = false, $overrideSc
     }
 
     /**
+     * Sends a notification (email) to the list or recipients defined in the request.
+     *
      * @param $issueIdOrKey Issue id Or Key
      * @param $notify Notify
      *
@@ -733,15 +735,23 @@ public function getEditMeta($idOrKey, $overrideEditableFlag = false, $overrideSc
      */
     public function notify($issueIdOrKey, $notify)
     {
-        $uri = $this->uri."/$issueIdOrKey/notify";
+        $full_uri = $this->uri."/$issueIdOrKey/notify";
+
+        // set self value
+        foreach ($notify->to['groups'] as &$g) {
+            $g['self'] = $this->getConfiguration()->getJiraHost().'/rest/api/2/group?groupname='.$g['name'];
+        }
+        foreach ($notify->restrict['groups'] as &$g) {
+            $g['self'] = $this->getConfiguration()->getJiraHost().'/rest/api/2/group?groupname='.$g['name'];
+        }
 
-        $data = json_encode($notify);
+        $data = json_encode($notify, JSON_UNESCAPED_SLASHES);
 
-        $this->log->addInfo("notify=$data\n");
+        $this->log->addDebug("notify=$data\n");
 
-        $ret = $this->exec($uri, $data, 'POST');
+        $ret = $this->exec($full_uri, $data, 'POST');
 
-        if ($ret !== 204) {
+        if ($ret !== true) {
             throw new JiraException("notify failed: response code=".$ret);
         }
     }

src/Issue/Notify.php

@@ -18,14 +18,21 @@ class Notify implements \JsonSerializable
     /** @var array|null */
     public $groups;
 
+    /** @var array */
+    public $restrict;
+
     public function __construct()
     {
         $this->to = [];
         $this->to['users'] = [];
-        $this->groups = [];
+        $this->to['groups'] = [];
+
+        $this->restrict = [];
+        $this->restrict['groups'] = [];
+        $this->restrict['permissions'] = [];
 
-        $this->to['reporter'] = false;
-        $this->to['assignee'] = false;
+        $this->to['reporter'] = true;
+        $this->to['assignee'] = true;
         $this->to['watchers'] = true;
         $this->to['voters'] = true;
     }
@@ -82,10 +89,26 @@ public function sendToUser($name, $active)
     public function sendToGroup($groupName)
     {
         $group['name'] = $groupName;
-        // FIXME "self": "http://www.example.com/jira/rest/api/2/group?groupname=notification-group"
-        //$group['self'] = $active;
 
-        array_push($this->groups, $group);
+        array_push($this->to['groups'], $group);
+
+        return $this;
+    }
+
+    public function setRestrictGroup($groupName)
+    {
+        $group['name'] = $groupName;
+
+        array_push($this->restrict['groups'], $group);
+
+        return $this;
+    }
+
+    public function setRestrictPermission($id, $key)
+    {
+        $perm['id'] = $id;
+        $perm['key'] = $key;
+        array_push($this->restrict['permissions'], $perm);
 
         return $this;
     }