com.marvelution.jira.plugins.hudson.services.associations.HudsonAssociationManager Maven / Gradle / Ivy

Go to download
/*
 * 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.jira.plugins.hudson.services.associations;

import java.util.Collection;

import com.atlassian.jira.project.Project;
import com.marvelution.jira.plugins.hudson.services.servers.HudsonServer;

/**
 * Hudson Association Manager Interface
 * 
 * @author Mark Rekveld
 */
public interface HudsonAssociationManager {

	/**
	 * Check if there is a {@link HudsonAssociation} configured with the given Id
	 * 
	 * @param associationId the Id to check
	 * @return true if configured, false otherwise
	 */
	boolean hasAssociation(int associationId);

	/**
	 * Check if any {@link HudsonAssociation}s are configured
	 * 
	 * @return true if there are any, false otherwise
	 */
	boolean hasAssocations();

	/**
	 * Check if there are any {@link HudsonAssociation}s for the given {@link Project}
	 * 
	 * @param project the {@link Project} to check
	 * @return true if there are any associations, false otherwise
	 */
	boolean hasAssociations(Project project);

	/**
	 * Getter for a specific {@link HudsonAssociation} by its Id
	 * 
	 * @param associationId the {@link HudsonAssociation} Id to get
	 * @return the {@link HudsonAssociation}
	 */
	HudsonAssociation getAssociation(int associationId);

	/**
	 * Getter for all the {@link HudsonAssociation} objects in a unmodifiable {@link Collection}
	 * 
	 * @return the unmodifiable {@link Collection}
	 */
	Collection getAssociations();

	/**
	 * Get all the {@link HudsonAssociation} objects for the given {@link Project}
	 * 
	 * @param project the {@link Project} to get all the {@link HudsonAssociation} for
	 * @return the {@link Collection} with all {@link HudsonAssociation} associated with the {@link Project}
	 */
	Collection getAssociations(Project project);

	/**
	 * Add a {@link HudsonAssociation}
	 * 
	 * @param server the {@link HudsonServer}
	 * @param project the JIRA {@link Project}
	 * @param jobname the Hudson job name
	 * @return the new {@link HudsonAssociation}
	 */
	HudsonAssociation addAssociation(HudsonServer server, long projectId, String jobname);

	/**
	 * Add a {@link HudsonAssociation}
	 * 
	 * @param serverId the Hudson ServerId
	 * @param projectId the JIRA Project Id
	 * @param jobname the Hudson job name
	 * @return the new {@link HudsonAssociation}
	 */
	HudsonAssociation addAssociation(int serverId, long projectId, String jobname);

	/**
	 * Copy a {@link HudsonAssociation} to the collection
	 * 
	 * @param association the {@link HudsonAssociation} to copy
	 * @return the new {@link HudsonAssociation}
	 */
	HudsonAssociation addAssociation(HudsonAssociation association);

	/**
	 * Update a {@link HudsonAssociation}
	 * 
	 * @param associationId the Hudson AssociationId
	 * @param server the {@link HudsonServer}
	 * @param project the JIRA {@link Project}
	 * @param jobname the Hudson job name
	 * @return the updated {@link HudsonAssociation}
	 */
	HudsonAssociation updateAssociation(int associationId, HudsonServer server, long projectId, String jobname);

	/**
	 * Update a {@link HudsonAssociation}
	 * 
	 * @param associationId the Hudson AssociationId
	 * @param serverId the Hudson ServerId
	 * @param projectId the JIRA Project Id
	 * @param jobname the Hudson job name
	 * @return the updated {@link HudsonAssociation}
	 */
	HudsonAssociation updateAssociation(int associationId, int serverId, long projectId, String jobname);

	/**
	 * Update a {@link HudsonAssociation}
	 * 
	 * @param association the {@link HudsonAssociation} to update
	 * @return the updated {@link HudsonAssociation}
	 */
	HudsonAssociation updateAssociation(HudsonAssociation association);

	/**
	 * Remove a {@link HudsonAssociation} from the collection by Id
	 * 
	 * @param associationId the {@link HudsonAssociation} Id to remove
	 * @see #removeAssociation(HudsonAssociation)
	 */
	void removeAssociation(int associationId);

	/**
	 * Remove a {@link HudsonAssociation} from the collection
	 * 
	 * @param association the {@link HudsonAssociation} to remove
	 */
	void removeAssociation(HudsonAssociation association);

}