Project

General

Profile

History

Guide » Developer Guide » Rest api »

Rest api with java » History » Revision 9

Revision 8 (Alex Last, 2011-01-26 09:19) → Revision 9/19 (Alex Last, 2011-01-31 08:51) 

h1. Using the REST API with Java 

 "Redmine Java API library":http://www.taskadapter.com/redmine_java_api is a -commercial- (becomes FREE and open-source in the next few days), third-party Java library that can be used to access the Redmine API. It is released under Apache 2 open-source license. 

 Sample usage: 

 <pre> 
 import java.io.IOException; 
 import java.net.URISyntaxException; 
 import java.util.List; 

 import org.alskor.redmine.AuthenticationException; org.alskor.httputils.AuthenticationException; 
 import org.alskor.redmine.NotFoundException; org.alskor.httputils.NotFoundException; 
 import org.alskor.redmine.RedmineManager; 
 import org.alskor.redmine.beans.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 String 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 IOException, 
            AuthenticationException, NotFoundException, URISyntaxException, RedmineException NotFoundException { 
		 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>