net.roboconf.dm.rest.client.delegates.ManagementWsDelegate Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of roboconf-dm-rest-client Show documentation
There is a newer version: 0.9.1
Show newest version
/**
 * Copyright 2014-2016 Linagora, Université Joseph Fourier, Floralis
 *
 * The present code is developed in the scope of the joint LINAGORA -
 * Université Joseph Fourier - Floralis research program and is designated
 * as a "Result" pursuant to the terms and conditions of the LINAGORA
 * - Université Joseph Fourier - Floralis research program. Each copyright
 * holder of Results enumerated here above fully & independently holds complete
 * ownership of the complete Intellectual Property rights applicable to the whole
 * of said Results, and may freely exploit it in any manner which does not infringe
 * the moral rights of the other copyright holders.
 *
 * Licensed 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 net.roboconf.dm.rest.client.delegates;

import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.logging.Logger;

import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response.Status.Family;

import net.roboconf.core.model.beans.Application;
import net.roboconf.core.model.beans.ApplicationTemplate;
import net.roboconf.dm.rest.client.exceptions.ManagementWsException;
import net.roboconf.dm.rest.commons.UrlConstants;

import com.sun.jersey.api.client.ClientResponse;
import com.sun.jersey.api.client.GenericType;
import com.sun.jersey.api.client.WebResource;
import com.sun.jersey.multipart.FormDataMultiPart;
import com.sun.jersey.multipart.file.FileDataBodyPart;

/**
 * @author Vincent Zurczak - Linagora
 */
public class ManagementWsDelegate {

	private final WebResource resource;
	private final Logger logger;


	/**
	 * Constructor.
	 * @param resource a web resource
	 */
	public ManagementWsDelegate( WebResource resource ) {
		this.resource = resource;
		this.logger = Logger.getLogger( getClass().getName());
	}


	// Templates


	/**
	 * Uploads a ZIP file and loads its application template.
	 * @param applicationFile a ZIP archive file
	 * @throws ManagementWsException if a problem occurred with the applications management
	 * @throws IOException if the file was not found or is invalid
	 */
	public void loadApplicationTemplate( File applicationFile ) throws ManagementWsException, IOException {

		if( applicationFile == null
				|| ! applicationFile.exists()
				|| ! applicationFile.isFile())
			throw new IOException( "Expected an existing file as parameter." );

		this.logger.finer( "Loading an application from " + applicationFile.getAbsolutePath() + "..." );

		FormDataMultiPart part = new FormDataMultiPart();
		part.bodyPart( new FileDataBodyPart( "file", applicationFile, MediaType.APPLICATION_OCTET_STREAM_TYPE));

		ClientResponse response = this.resource
				.path( UrlConstants.APPLICATIONS ).path( "templates" )
				.type( MediaType.MULTIPART_FORM_DATA_TYPE )
				.post( ClientResponse.class, part );

		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily()) {
			String value = response.getEntity( String.class );
			this.logger.finer( response.getStatusInfo() + ": " + value );
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), value );
		}

		this.logger.finer( String.valueOf( response.getStatusInfo()));
	}


	/**
	 * Loads an application template from a file which was already uploaded (and unzipped) on the DM's machine.
	 * @param remoteFilePath the file path of a directory containing the application on the DM's machine
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public void loadApplicationTemplate( String remoteFilePath ) throws ManagementWsException {
		this.logger.finer( "Loading an already-uploaded application. " + remoteFilePath );

		WebResource path = this.resource.path( UrlConstants.APPLICATIONS ).path( "templates" ).path( "local" );
		if( remoteFilePath != null )
			path = path.queryParam( "local-file-path", remoteFilePath );

		ClientResponse response = path.type( MediaType.APPLICATION_JSON ).post( ClientResponse.class );
		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily()) {
			String value = response.getEntity( String.class );
			this.logger.finer( response.getStatusInfo() + ": " + value );
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), value );
		}

		this.logger.finer( String.valueOf( response.getStatusInfo()));
	}


	/**
	 * Lists application templates.
	 * @return a non-null list of application templates
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public List listApplicationTemplates() throws ManagementWsException {
		this.logger.finer( "Listing application templates..." );

		List result = this.resource
				.path( UrlConstants.APPLICATIONS ).path( "templates" )
				.accept( MediaType.APPLICATION_JSON )
				.get( new GenericType> () {});

		if( result != null )
			this.logger.finer( result.size() + " application templates were found on the DM." );
		else
			this.logger.finer( "No application template was found on the DM." );

		return result != null ? result : new ArrayList ();
	}


	/**
	 * Deletes an application.
	 * @param templateName the template name
	 * @param templateQualifier the template qualifier
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public void deleteApplicationTemplate( String templateName, String templateQualifier ) throws ManagementWsException {
		this.logger.finer( "Removing application template " + templateName + "..." );

		ClientResponse response = this.resource
				.path( UrlConstants.APPLICATIONS ).path( "templates" )
				.path( templateName ).path( templateQualifier )
				.delete( ClientResponse.class );

		String text = response.getEntity( String.class );
		this.logger.finer( text );
		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily())
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), text );
	}


	// Applications


	/**
	 * Creates an application from a template.
	 * @param applicationName the application name
	 * @param templateName the template's name
	 * @param templateQualifier the template's qualifier
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public void createApplication( String applicationName, String templateName, String templateQualifier )
	throws ManagementWsException {

		this.logger.finer( "Creating application " + applicationName + " from " + templateName + " - " + templateQualifier + "..." );
		ApplicationTemplate tpl = new ApplicationTemplate( templateName ).qualifier( templateQualifier );
		Application app = new Application( applicationName, tpl );

		ClientResponse response = this.resource
				.path( UrlConstants.APPLICATIONS )
				.type( MediaType.APPLICATION_JSON )
				.post( ClientResponse.class, app );

		String text = response.getEntity( String.class );
		this.logger.finer( text );
		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily())
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), text );
	}


	/**
	 * Lists applications.
	 * @return a non-null list of applications
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public List listApplications() throws ManagementWsException {
		this.logger.finer( "Listing applications..." );

		List result = this.resource
				.path( UrlConstants.APPLICATIONS )
				.accept( MediaType.APPLICATION_JSON )
				.get( new GenericType> () {});

		if( result != null )
			this.logger.finer( result.size() + " applications were found on the DM." );
		else
			this.logger.finer( "No application was found on the DM." );

		return result != null ? result : new ArrayList ();
	}


	/**
	 * Shutdowns an application.
	 * @param applicationName the application name
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public void shutdownApplication( String applicationName ) throws ManagementWsException {
		this.logger.finer( "Removing application " + applicationName + "..." );

		ClientResponse response = this.resource
				.path( UrlConstants.APPLICATIONS ).path( applicationName ).path( "shutdown" )
				.post( ClientResponse.class );

		String text = response.getEntity( String.class );
		this.logger.finer( text );
		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily())
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), text );
	}


	/**
	 * Deletes an application.
	 * @param applicationName the application name
	 * @throws ManagementWsException if a problem occurred with the applications management
	 */
	public void deleteApplication( String applicationName ) throws ManagementWsException {
		this.logger.finer( "Removing application " + applicationName + "..." );

		ClientResponse response = this.resource
				.path( UrlConstants.APPLICATIONS ).path( applicationName )
				.delete( ClientResponse.class );

		String text = response.getEntity( String.class );
		this.logger.finer( text );
		if( Family.SUCCESSFUL != response.getStatusInfo().getFamily())
			throw new ManagementWsException( response.getStatusInfo().getStatusCode(), text );
	}
}