net.rcarz.jiraclient.Watches Maven / Gradle / Ivy
/**
* jira-client - a simple JIRA REST client
* Copyright (c) 2013 Bob Carroll ([email protected])
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
package net.rcarz.jiraclient;
import java.util.Map;
import net.sf.json.JSON;
import net.sf.json.JSONObject;
/**
* Represents issue watches.
*/
public final class Watches extends Resource {
private String name = null;
private int watchCount = 0;
private boolean isWatching = false;
/**
* Creates watches from a JSON payload.
*
* @param restclient REST client instance
* @param json JSON payload
*/
protected Watches(RestClient restclient, JSONObject json) {
super(restclient);
if (json != null)
deserialise(json);
}
private void deserialise(JSONObject json) {
Map map = json;
self = Field.getString(map.get("self"));
id = Field.getString(map.get("id"));
watchCount = Field.getInteger(map.get("watchCount"));
isWatching = Field.getBoolean(map.get("isWatching"));
}
/**
* Retrieves the given watches record.
*
* @param restclient REST client instance
* @param issue Internal JIRA ID of the issue
*
* @return a watches instance
*
* @throws JiraException when the retrieval fails
*/
public static Watches get(RestClient restclient, String issue)
throws JiraException {
JSON result = null;
try {
result = restclient.get(RESOURCE_URI + "issue/" + issue + "/watches");
} catch (Exception ex) {
throw new JiraException("Failed to retrieve watches for issue " + issue, ex);
}
if (!(result instanceof JSONObject))
throw new JiraException("JSON payload is malformed");
return new Watches(restclient, (JSONObject)result);
}
@Override
public String toString() {
return Integer.toString(getWatchCount());
}
public int getWatchCount() {
return watchCount;
}
public boolean isWatching() {
return isWatching;
}
}