com.openshift.client.IApplication Maven / Gradle / Ivy
The newest version!
/*******************************************************************************
* Copyright (c) 2011 Red Hat, Inc.
* Distributed under license by Red Hat, Inc. All rights reserved.
* This program is made available under the terms of the
* Eclipse Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Red Hat, Inc. - initial API and implementation
******************************************************************************/
package com.openshift.client;
import java.util.Collection;
import java.util.Date;
import java.util.List;
import java.util.concurrent.Future;
import com.jcraft.jsch.JSchException;
import com.jcraft.jsch.Session;
import com.openshift.client.cartridge.IEmbeddableCartridge;
import com.openshift.client.cartridge.IEmbeddedCartridge;
import com.openshift.client.cartridge.IStandaloneCartridge;
/**
* @author André Dietisheim
*/
public interface IApplication extends IOpenShiftResource {
/**
* Returns the name of this application.
*
* @return
*/
public String getName();
/**
* Returns the uuid of this application.
*
* @return the uuid of this application.
*/
public String getUUID();
/**
* Returns the uri at which the git repository of this application may be
* reached at.
*
* @return the uri of the git repo of this application.
*/
public String getGitUrl();
/**
* Returns the git url that the application will get its initial code and configuration from.
*
* @return the initial git url
*/
public String getInitialGitUrl();
/**
* Returns the url at which this application may be reached at.
*
* @return the url of this application.
*/
public String getApplicationUrl();
/**
* Returns true if scaling is enabled on this application (only set at
* creation time).
*
* @return true if scaling is enabled on this application (only set at
* creation time).
*/
public ApplicationScale getApplicationScale();
/**
* Returns true if scaling is enabled on this application (only set at
* creation time).
*
* @return true if scaling is enabled on this application (only set at
* creation time).
*/
public IGearProfile getGearProfile();
/**
* Returns the cartridge (application type) that this app is running on.
*
* @return the cartridge of this application
*
*/
public IStandaloneCartridge getCartridge();
/**
* Adds the given embeddable cartridge to this application.
*
* @param cartridge
* @throws OpenShiftException
*/
public IEmbeddedCartridge addEmbeddableCartridge(IEmbeddableCartridge cartridge) throws OpenShiftException;
/**
* Adds all given embedded cartridges from this app, given their names.
*
* @param embeddedCartridges
* @throws OpenShiftException
*
* @see #addEmbeddableCartridge(IEmbeddedCartridge)
* @see #removeEmbeddedCartridge(IEmbeddedCartridge)
*/
public List addEmbeddableCartridges(Collection cartridge)
throws OpenShiftException;
/**
* Returns all embedded cartridges.
*
* @return all embedded cartridges.
* @throws OpenShiftException
*
* @see IEmbeddedCartridge
* @see #addEmbeddableCartridge(IEmbeddedCartridge)
* @see #removeEmbeddedCartridge(IEmbeddedCartridge)
*/
public List getEmbeddedCartridges() throws OpenShiftException;
/**
* Returns true if this application has an embedded cartridge.
* Returns false otherwise.
*
* @param the
* name of the cartridge to look for
* @return true if there's an embedded cartridge with the given name
* @throws OpenShiftException
*
* @see IEmbeddedCartridge
* @see #addEmbeddableCartridge(IEmbeddedCartridge)
* @see #removeEmbeddedCartridge(IEmbeddedCartridge)
*/
public boolean hasEmbeddedCartridge(IEmbeddableCartridge cartridge) throws OpenShiftException;
/**
* Returns true if this application has an embedded cartridge.
* Returns false otherwise.
*
* @param the
* name of the cartridge to look for
* @return true if there's an embedded cartridge with the given name
* @throws OpenShiftException
*
* @see IEmbeddedCartridge
* @see #addEmbeddableCartridge(IEmbeddedCartridge)
* @see #removeEmbeddedCartridge(IEmbeddedCartridge)
*/
public boolean hasEmbeddedCartridge(String cartridgeName) throws OpenShiftException;
/**
* Returns the embedded cartridge given its name. Returns null
* if none was found.
*
* @param cartridgeName
* @return the embedded cartridge with the given name
* @throws OpenShiftException
*/
public IEmbeddedCartridge getEmbeddedCartridge(String cartridgeName)
throws OpenShiftException;
/**
* Returns the embedded cartridge in this application. Returns null if none was
* found.
*
* @param cartridge
* @return the embedded cartridge
* @throws OpenShiftException
*/
public IEmbeddedCartridge getEmbeddedCartridge(IEmbeddableCartridge cartridge)
throws OpenShiftException;
/**
* Removes the given embedded cartridge that is equal to the given
* embeddable cartridge. Does nothing if the cartridge is not present in
* this application.
*
* @param cartridge
* the cartridge that shall be removed
* @throws OpenShiftException
*/
public void removeEmbeddedCartridge(IEmbeddableCartridge cartridge) throws OpenShiftException;
/**
* Removes the given embedded cartridges in this application that are equal to the
* given IEmbeddableCartridge. Does nothing if the cartridge is not present
* in this application.
*
* @param cartridges the cartridges that shall get removed
* @throws OpenShiftException
*/
public void removeEmbeddedCartridges(Collection cartridges) throws OpenShiftException;
/**
* Returns the gear groups for this application
* @return
* @throws OpenShiftException
*/
public Collection getGearGroups() throws OpenShiftException;
/**
* Returns the timestamp at which this app was created.
*
* @return the creation time
*
* @throws OpenShiftException
*/
public Date getCreationTime();
/**
* Destroys this application (and removes it from the list of available
* applications)
*
* @throws OpenShiftException
*
* @see IUser#getApplications()
*/
public void destroy() throws OpenShiftException;
/**
* Starts this application. Has no effect if this app is already running.
*
* @throws OpenShiftException
*/
public void start() throws OpenShiftException;
/**
* Restarts this application.
*
* @throws OpenShiftException
*/
public void restart() throws OpenShiftException;
/**
* Stops this application.
*
* @throws OpenShiftException
*/
public void stop() throws OpenShiftException;
/**
* Stops this application
*
* @param force
* : true to force stop, false otherwise
*
* @throws OpenShiftException
*/
public void stop(boolean force) throws OpenShiftException;
/**
* Waits for this application to become accessible on its public url.
*
* @param timeout
* @return
* @throws OpenShiftException
*
* @see IApplication#getApplicationUrl()
*/
public boolean waitForAccessible(long timeout) throws OpenShiftException;
/**
* Returns a Future that the caller can use to wait for the application to
* become accessible on its public url.
*
* @param timeout
* @return
* @throws OpenShiftException
*
* @see IApplication#getApplicationUrl()
* @see IApplication#waitForAccessible(long)
* @see IOpenShiftConnection#getExecutorService()
* @see Future
*/
public Future waitForAccessibleAsync(final long timeout) throws OpenShiftException;
/**
* Get the domain of the application.
*
* @return the domain
*/
public IDomain getDomain();
/**
* Scale down application
*
* @throws OpenShiftException
*/
public void scaleDown() throws OpenShiftException;
/**
* Scale up application
*
* @throws OpenShiftException
*/
public void scaleUp() throws OpenShiftException;
/**
* Add application alias
*
* @throws OpenShiftException
*/
public void addAlias(String string) throws OpenShiftException;
/**
* Retrieve all application aliases
*
* @return application aliases in an unmodifiable collection
*/
public List getAliases();
public boolean hasAlias(String name);
/**
* Remove application alias
*
* @throws OpenShiftException
*/
public void removeAlias(String alias) throws OpenShiftException;
/**
* Refresh the application but reloading its content from OpenShift. At the
* same time, this operation automatically set the embedded cartridges back
* to an 'unloaded' state.
*
* @throws OpenShiftException
*/
public void refresh() throws OpenShiftException;
/**
* Sets the SSH session that this application will use to connect to
* OpenShift to perform some operations. This SSH session must be
* initialized out of the library, since the user's SSH settings may depend
* on the runtime environment (Eclipse, etc.).
*
* @param session
* the SSH session
*/
public void setSSHSession(Session session);
/**
* Returns the SSH session that this application uses to connect to
* OpenShift.
*
* @return the SSH session that this application uses to connect to
* OpenShift.
*/
public Session getSSHSession();
/**
* Returns true if the application was already provided with an SSH session,
* and this session is still valid (connected).
*
* @return true if the application was already provided with an SSH session,
* and this session is still valid (connected).
*/
public boolean hasSSHSession();
/**
* Returns true if the port-forwarding has been started, false otherwise.
*
* @return true if the port-forwarding has been started, false otherwise.
* @throws OpenShiftSSHOperationException
*/
public boolean isPortFowardingStarted() throws OpenShiftSSHOperationException;
/**
* Returns the list of forwardable ports on OpenShift for this application.
*
* @return the list of forwardable ports on OpenShift for this application.
* @throws OpenShiftSSHOperationException
*/
public List getForwardablePorts() throws OpenShiftSSHOperationException;
/**
* @ * Starts the port-forwarding for all ports.
*
* @return the list of forwardable ports on OpenShift for this application.
* @throws JSchException
*/
public List startPortForwarding() throws OpenShiftSSHOperationException;
/**
* Stop the port-forwarding for all ports.
*
* @return the list of forwardable ports on OpenShift for this application.
* @throws OpenShiftSSHOperationException
*/
public List stopPortForwarding() throws OpenShiftSSHOperationException;
/**
* Refreshes the list of port-forwarding. Started ones are kept as-is.
*
* @return the list of forwardable ports on OpenShift for this application.
* @throws OpenShiftSSHOperationException
*/
public List refreshForwardablePorts() throws OpenShiftSSHOperationException;
/**
* Retrieves the list of environment properties.
*
* @return the list of environment properties.
* @throws OpenShiftSSHOperationException
*/
public List getEnvironmentProperties() throws OpenShiftSSHOperationException;
} © 2015 - 2025 Weber Informatics LLC | Privacy Policy