com.marvelution.hudson.plugins.jirareporter.JIRASite Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of hudson-jirareporter-plugin Show documentation
This plugin features JIRA Reporter publisher.
There is a newer version: 5.0.4
Show newest version
/*
 * Licensed to Marvelution under one or more contributor license 
 * agreements.  See the NOTICE file distributed with this work 
 * for additional information regarding copyright ownership.
 * Marvelution licenses this file to you under the Apache License,
 * Version 2.0 (the "License"); you may not use this file except
 * in compliance with the License.
 * You may obtain a copy of the License at
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

package com.marvelution.hudson.plugins.jirareporter;

import hudson.model.AbstractBuild;

import java.net.MalformedURLException;
import java.net.URL;
import java.util.Map;
import java.util.regex.Pattern;

import javax.xml.rpc.ServiceException;

import org.apache.commons.lang.StringUtils;
import org.kohsuke.stapler.DataBoundConstructor;

import com.atlassian.jira.rpc.soap.client.JiraSoapService;
import com.atlassian.jira.rpc.soap.client.JiraSoapServiceService;
import com.atlassian.jira.rpc.soap.client.JiraSoapServiceServiceLocator;
import com.atlassian.jira.rpc.soap.client.RemoteAuthenticationException;
import com.atlassian.jira.rpc.soap.client.RemoteException;
import com.marvelution.hudson.plugins.apiv2.utils.JiraKeyUtils;

/**
 * JIRA Site object used by the Notifier
 * 
 * @author Mark Rekveld
 */
public class JIRASite {

	/**
	 * The Endpoint where the JIRA SOAP service can be found
	 */
	public static final String SERVICE_ENDPOINT = "rpc/soap/jirasoapservice-v2";

	/**
	 * The Endpoint where the JIRA SOAP service WSDL can be found
	 */
	public static final String SERVICE_ENDPOINT_WSDL = SERVICE_ENDPOINT + "?wsdl";

	public final String name;
	public final URL url;
	public final String username;
	public final String password;
	public final String closeAction;
	public final boolean supportsWikiStyle;
	public final boolean checkIssueExistence;

	transient volatile Map priorities;

	/**
	 * Constructor
	 * 
	 * @param name the JIRA Site name
	 * @param url the JIRA Site {@link URL}
	 * @param username the username to use for Authentication with the JIRA Site
	 * @param password the password for the given username
	 * @param supportsWikiStyle flag is Wiki style texts are supported
	 * @param closeAction the name of the Close action, defaults to Close
	 * @param checkIssueExistence flag to check if an Issue exists before annotating it in the Changelog
	 */
	@DataBoundConstructor
	public JIRASite(String name, URL url, String username, String password, boolean supportsWikiStyle,
			String closeAction, boolean checkIssueExistence) {
		this.name = name;
		if (!url.toExternalForm().endsWith("/"))
		try {
			url = new URL(url.toExternalForm() + "/");
		} catch (MalformedURLException e) {
			// Ignore this, cannot happen any way
		}
		this.url = url;
		this.username = username;
		this.password = password;
		this.supportsWikiStyle = supportsWikiStyle;
		this.closeAction = closeAction;
		this.checkIssueExistence = checkIssueExistence;
	}

	/**
	 * Get the {@link JIRAClient} for this {@link JIRASite}
	 * 
	 * @return the {@link JIRAClient}
	 * @throws RemoteAuthenticationException
	 * @throws RemoteException
	 * @throws java.rmi.RemoteException
	 * @throws MalformedURLException
	 * @throws ServiceException
	 */
	public JIRAClient createClient() throws RemoteAuthenticationException, RemoteException, java.rmi.RemoteException,
			MalformedURLException, ServiceException {
		if (StringUtils.isBlank(username) || StringUtils.isBlank(password)) {
			return null;
		}
		JiraSoapServiceService jiraSoapServiceLocator = new JiraSoapServiceServiceLocator();
		JiraSoapService service = jiraSoapServiceLocator.getJirasoapserviceV2(new URL(url, SERVICE_ENDPOINT));
		return new JIRAClient(service, service.login(username, password), this);
	}

	/**
	 * Getter for the {@link #closeAction}
	 * 
	 * @return the {@link #closeAction}
	 */
	public String getCloseActionName() {
		if (StringUtils.isBlank(closeAction)) {
			return "Close Issue";
		} else {
			return closeAction;
		}
	}

	/**
	 * The {@link Pattern} used to find JIRA Issue keys
	 * 
	 * @return the Issue key {@link Pattern}
	 */
	public Pattern getIssuePattern() {
		// TODO Support a custom pattern
		return JiraKeyUtils.DEFAULT_JIRA_ISSUE_KEY_PATTERN;
	}

	/**
	 * Static helper method to get a {@link JIRASite} by its name
	 * 
	 * @param name the name of the {@link JIRASite} to get
	 * @return the {@link JIRASite}, may be null if no {@link JIRASite} with the given name can be found
	 */
	public static JIRASite getSite(String name) {
		for (JIRASite site : JIRABuildResultReportNotifier.DESCRIPTOR.getSites()) {
			if (site.name.equals(name)) {
				return site;
			}
		}
		return null;
	}

	/**
	 * Static helper method to get a {@link JIRASite} by the configuration of a Build and this Project
	 * 
	 * @param build the {@link AbstractBuild} to get the {@link JIRASite} for
	 * @return the {@link JIRASite}, may be null if the proejct is not configured with
	 * 			{@link JIRABuildResultReportNotifier}
	 */
	public static JIRASite getSite(AbstractBuild build) {
		JIRABuildResultReportNotifier notifier = build.getProject().getPublishersList()
			.get(JIRABuildResultReportNotifier.class);
		if (notifier == null) {
			return null;
		} else {
			return notifier.getSite();
		}
	}

	/**
	 * Check if the given Build has a {@link JIRASite} configured
	 * 
	 * @param build the {@link AbstractBuild} to check
	 * @return true is a {@link JIRASite} is configured, false otherwise
	 */
	public static boolean hasSite(AbstractBuild build) {
		return getSite(build) != null;
	}
	
}