com.marvelution.jira.plugins.hudson.services.servers.HudsonServer Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jira-hudson-plugin Show documentation
Jira Plugin to integrate Hudson CI
The 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.jira.plugins.hudson.services.servers;

import com.marvelution.jira.plugins.hudson.services.associations.HudsonAssociation;

import net.java.ao.Entity;
import net.java.ao.Implementation;
import net.java.ao.OneToMany;
import net.java.ao.Preload;
import net.java.ao.Searchable;

/**
 * Hudson Server Interface
 * 
 * @author Mark Rekveld
 */
@Preload
@Implementation(HudsonServerEntity.class)
public interface HudsonServer extends Entity {

	/**
	 * Getter for the Server name
	 * 
	 * @return the name of the server
	 */
	@Searchable
	String getName();

	/**
	 * Setter for the Server name
	 * 
	 * @param name the server name
	 */
	void setName(String name);

	/**
	 * Getter for the Server description
	 * 
	 * @return the Server description
	 */
	String getDescription();

	/**
	 * Setter for the Server description
	 * 
	 * @param description the server description
	 */
	void setDescription(String description);

	/**
	 * Getter for the Server Host
	 * 
	 * @return the Server Host
	 */
	String getHost();

	/**
	 * Setter for the Server Host
	 * 
	 * @param host the Server Host
	 */
	void setHost(String host);

	/**
	 * Getter for the Server Public Host
	 * 
	 * @return the Server Public Host
	 */
	String getPublicHost();

	/**
	 * Setter for the Server Public Host
	 * 
	 * @param publicHost the Server Public Host
	 */
	void setPublicHost(String publicHost);

	/**
	 * Getter for the username
	 * 
	 * @return the username
	 */
	String getUsername();

	/**
	 * Setter for the username
	 * 
	 * @param username the username
	 */
	void setUsername(String username);

	/**
	 * Getter for the password
	 * 
	 * @return the password
	 */
	String getPassword();

	/**
	 * Setter for the password
	 * 
	 * @param password the password
	 */
	void setPassword(String password);

	/**
	 * Setter for the defaultServer
	 * 
	 * @param defaultServer true if the server should be default, false otherwise
	 */
	void setDefaultServer(boolean defaultServer);

	/**
	 * Getter for the defaultServer
	 * 
	 * @return true if the given {@link HudsonServer} is the default {@link HudsonServer},
	 *         false otherwise.
	 */
	boolean isDefaultServer();

	/**
	 * Setter for the includeInStreams
	 * 
	 * @param includeInStreams true if the server can be included in the activity streams gadget,
	 * 			false otherwise
	 */
	void setIncludeInStreams(boolean includeInStreams);

	/**
	 * Getter for the includeInStreams
	 * 
	 * @return true if the given {@link HudsonServer} is included in the activity streams gadget,
	 *         false otherwise.
	 */
	boolean isIncludeInStreams();

	/**
	 * Setter for the cacheBuilds
	 * 
	 * @param cacheBuilds true if the builds of the server are cached, false otherwise 
	 * @since 4.5.0
	 */
	void setCacheBuilds(boolean cacheBuilds);

	/**
	 * Getter for the cacheBuilds
	 * 
	 * @return true if the builds of the server are cached, false otherwise
	 * @since 4.5.0
	 */
	boolean isCacheBuilds();

	/**
	 * Getter for all the {@link HudsonAssociation} objects linked to this server
	 * 
	 * @return array of {@link HudsonAssociation} objects
	 */
	@OneToMany
	HudsonAssociation[] getAssociations();

	/**
	 * Setter for the acceptAllCertificates
	 * 
	 * @param acceptAllCertificates true if the SSL certificates should not be checked but just excepted
	 * @since 5.0.2
	 */
	void setAcceptAllCertificates(boolean acceptAllCertificates);

	/**
	 * Getter for the acceptAllCertificates
	 * 
	 * @return true if the SSL certificates should not be checked but just excepted
	 * @since 5.0.2
	 */
	boolean isAcceptAllCertificates();

}