Project

General

Profile

History

Guide » Developer Guide » Rest api »

Rest api with java » History » Revision 13

Revision 12 (Chris Maiden, 2012-10-01 18:57) → Revision 13/19 (Terence Mill, 2013-06-06 09:46) 

h1. Using the REST API with Java 

 * "Jredmine":http://maven-site.nuiton.org/jredmine/index.html (implements its own redmine plugin and correspodnsing java client - more other/features than redmine rest api) 
 * "redmine-jconnector":https://code.google.com/p/redmine-jconnector/ (only until redmine 1.4 using REST API) 
 * "Redmine Java API library":https://github.com/taskadapter/redmine-java-api is a FREE third-party Java library that can be used to access the Redmine API. It is released under Apache 2 open-source license. (support until Redmine 2.3 using REST API) 

 Sample usage: 

 <pre> 
 import java.io.IOException; 
 import java.net.URISyntaxException; 
 import java.util.List; 
 import com.taskadapter.redmineapi.RedmineManager; 
 import com.taskadapter.redmineapi.bean.Issue; 

 public class Simple { 
	 private static String redmineHost = "https://www.hostedredmine.com"; 
	 private static String apiAccessKey = "a3221bfcef5750219bd0a2df69519416dba17fc9"; 
	 private static String projectKey = "taskconnector-test"; 
	 private static Integer queryId = null; // any 

	 public static void main(String[] args) { 
		 RedmineManager mgr = new RedmineManager(redmineHost, apiAccessKey); 
		 try { 
			 tryGetIssues(mgr); 
		 } catch (Exception e) { 
			 e.printStackTrace(); 
		 } 
	 } 

	 private static void tryGetIssues(RedmineManager mgr) throws Exception { 
		 List<Issue> issues = mgr.getIssues(projectKey, queryId); 
		 for (Issue issue : issues) { 
			 System.out.println(issue.toString()); 
		 } 
	 } 
 } 
 </pre> 

 Create Issue: 

 <pre> 
	 Issue issueToCreate = new Issue(); 
	 issueToCreate.setSubject("This is the summary line 123"); 
	 Issue newIssue = mgr.createIssue(PROJECT_KEY, issueToCreate); 
 </pre> 

 Get issue by ID: 

 <pre> 
	 Issue issue = mgr.getIssueById(123); 
 </pre>