Merge pull request #60 from mkrivickiy/develop

implement addWatcher method

Author: lesstif

README.md

@@ -113,6 +113,7 @@ $iss = new IssueService(new ArrayConfiguration(
 - [Add worklog in Issue](#add-worklog-in-issue)
 - [Edit worklog in Issue](#edit-worklog-in-issue)
 - [Get Issue worklog](#get-issue-worklog)
+- [Add watcher in Issue](#add-issue-watcher)
 
 ### User
 - [Get User Info](#get-user-info)
@@ -819,6 +820,34 @@ try {
 
 ```
 
+#### Add watcher in Issue 
+
+```php
+<?php
+require 'vendor/autoload.php';
+
+use JiraRestApi\Issue\IssueService;
+use JiraRestApi\Issue\Watcher;
+use JiraRestApi\JiraException;
+
+$issueKey = 'TEST-961';
+
+try {
+    $issueService = new IssueService();
+    
+    // get issue's all worklog
+    $watcher = new Watcher('lesstif');
+    var_dump($watcher);
+    
+    $wch = $issueService->addWatcher($issueKey, $watcher);
+    var_dump($wch);
+    
+} catch (JiraException $e) {
+    $this->assertTrue(false, 'testSearch Failed : '.$e->getMessage());
+}
+
+```
+
 #### Get User Info
 
 Returns a user.

src/Issue/IssueService.php

@@ -545,4 +545,27 @@ public function getCustomFields($priorityId)
 
         return $prio;
     }
+
+    /**
+    * add watcher to issue.
+    *
+    * @param mixed  $issueIdOrKey
+    * @param object $watcher
+    * @param int $worklogId
+    *
+    * @return bool
+    */
+    public function addWatcher($issueIdOrKey, $watcher)
+    {
+        $this->log->addInfo("addWatcher=\n");
+
+        $data = json_encode($watcher);
+        $url = $this->uri . "/$issueIdOrKey/watchers";
+        $type = 'POST';
+
+        $this->exec($url, $data, $type);
+
+        return $this->http_response == 204 ? true : false;
+    }
+
 }

src/Issue/Watcher.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace JiraRestApi\Issue;
+
+use JiraRestApi\ClassSerialize;
+use JiraRestApi\JiraException;
+
+/**
+ * Class Watcher.
+ */
+class Watcher implements \JsonSerializable
+{
+    use ClassSerialize;
+
+    /** @var  string  */
+    public $name;
+
+    public function __construct($name)
+    {
+        $this->name = $name;
+    }
+
+    /**
+     * Function to serialize obj vars.
+     *
+     * @return array
+     */
+    public function jsonSerialize()
+    {
+        return $this->name;
+    }
+
+}

tests/WatcherLogTest.php

@@ -0,0 +1,26 @@
+<?php
+
+use JiraRestApi\Dumper;
+use JiraRestApi\Issue\IssueService;
+use JiraRestApi\Issue\Watcher;
+use JiraRestApi\JiraException;
+
+class WatcherLogTest extends PHPUnit_Framework_TestCase
+{
+    public $issueKey = 'TEST-165';
+
+    public function testAddWatcherLog()
+    {
+        try {
+            $issueService = new IssueService();
+
+            $watcher = new Watcher('lesstif');
+            // add issue watcher
+            $ret = $issueService->addWatcher($this->issueKey, $watcher);
+
+            Dumper::dump($ret);
+        } catch (JiraException $e) {
+            $this->assertTrue(false, 'testAddWatcherLog Failed : '.$e->getMessage());
+        }
+    }
+}