Java tutorial
/* * LinShare is an open source filesharing software, part of the LinPKI software * suite, developed by Linagora. * * Copyright (C) 2015 LINAGORA * * This program is free software: you can redistribute it and/or modify it under * the terms of the GNU Affero General Public License as published by the Free * Software Foundation, either version 3 of the License, or (at your option) any * later version, provided you comply with the Additional Terms applicable for * LinShare software by Linagora pursuant to Section 7 of the GNU Affero General * Public License, subsections (b), (c), and (e), pursuant to which you must * notably (i) retain the display of the LinShare? trademark/logo at the top * of the interface window, the display of the You are using the Open Source * and free version of LinShare, powered by Linagora 20092015. Contribute to * Linshare R&D by subscribing to an Enterprise offer!? infobox and in the * e-mails sent with the Program, (ii) retain all hypertext links between * LinShare and linshare.org, between linagora.com and Linagora, and (iii) * refrain from infringing Linagora intellectual property rights over its * trademarks and commercial brands. Other Additional Terms apply, see * <http://www.linagora.com/licenses/> for more details. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more * details. * * You should have received a copy of the GNU Affero General Public License and * its applicable Additional Terms for LinShare along with this program. If not, * see <http://www.gnu.org/licenses/> for the GNU Affero General Public License * version 3 and <http://www.linagora.com/licenses/> for the Additional Terms * applicable to LinShare software. */ package org.linagora.linshare.webservice.delegation.impl; import java.io.File; import java.io.InputStream; import java.util.List; import javax.ws.rs.Consumes; import javax.ws.rs.DELETE; import javax.ws.rs.GET; import javax.ws.rs.HEAD; import javax.ws.rs.HeaderParam; import javax.ws.rs.POST; import javax.ws.rs.PUT; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.Produces; import javax.ws.rs.QueryParam; import javax.ws.rs.core.MediaType; import javax.ws.rs.core.Response; import org.apache.commons.httpclient.HttpStatus; import org.apache.commons.lang.Validate; import org.apache.cxf.jaxrs.ext.multipart.Multipart; import org.apache.cxf.jaxrs.ext.multipart.MultipartBody; import org.linagora.linshare.core.domain.constants.AsyncTaskType; import org.linagora.linshare.core.exception.BusinessException; import org.linagora.linshare.core.facade.webservice.common.dto.AccountDto; import org.linagora.linshare.core.facade.webservice.common.dto.AsyncTaskDto; import org.linagora.linshare.core.facade.webservice.common.dto.WorkGroupEntryDto; import org.linagora.linshare.core.facade.webservice.delegation.AsyncTaskFacade; import org.linagora.linshare.core.facade.webservice.delegation.ThreadEntryFacade; import org.linagora.linshare.core.facade.webservice.user.ThreadEntryAsyncFacade; import org.linagora.linshare.webservice.WebserviceBase; import org.linagora.linshare.webservice.delegation.ThreadEntryRestService; import org.linagora.linshare.webservice.userv1.task.ThreadEntryCopyAsyncTask; import org.linagora.linshare.webservice.userv1.task.ThreadEntryUploadAsyncTask; import org.linagora.linshare.webservice.userv1.task.context.ThreadEntryTaskContext; import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor; import com.wordnik.swagger.annotations.Api; import com.wordnik.swagger.annotations.ApiOperation; import com.wordnik.swagger.annotations.ApiParam; import com.wordnik.swagger.annotations.ApiResponse; import com.wordnik.swagger.annotations.ApiResponses; @Path("/{ownerUuid}/threads/{threadUuid}/entries") @Api(value = "/rest/delegation/{ownerUuid}/threads/{threadUuid}/entries", basePath = "/rest/threads/{threadUuid}/entries", description = "thread entries service.", produces = "application/json,application/xml", consumes = "application/json,application/xml") @Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) public class ThreadEntryRestServiceImpl extends WebserviceBase implements ThreadEntryRestService { private final ThreadEntryFacade threadEntryFacade; private final ThreadEntryAsyncFacade threadEntryAsyncFacade; private final AsyncTaskFacade asyncTaskFacade; private org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor taskExecutor; private boolean sizeValidation; public ThreadEntryRestServiceImpl(ThreadEntryFacade threadEntryFacade, ThreadEntryAsyncFacade threadEntryAsyncFacade, AsyncTaskFacade asyncTaskFacade, ThreadPoolTaskExecutor taskExecutor, boolean sizeValidation) { super(); this.threadEntryFacade = threadEntryFacade; this.threadEntryAsyncFacade = threadEntryAsyncFacade; this.asyncTaskFacade = asyncTaskFacade; this.taskExecutor = taskExecutor; this.sizeValidation = sizeValidation; } @Path("/") @POST @Consumes(MediaType.MULTIPART_FORM_DATA) @ApiOperation(value = "Create a thread entry which will contain the uploaded file.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto create( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "File stream.", required = true) InputStream file, @ApiParam(value = "An optional description of a thread entry.") String description, @ApiParam(value = "The given file name of the uploaded file.", required = true) String givenFileName, @ApiParam(value = "True to enable asynchronous upload processing.", required = false) @QueryParam("async") Boolean async, @HeaderParam("Content-Length") Long contentLength, @ApiParam(value = "file size (size validation purpose).", required = false) @Multipart(value = "filesize", required = false) Long fileSize, MultipartBody body) throws BusinessException { Long transfertDuration = getTransfertDuration(); if (file == null) { logger.error("Missing file (check parameter file)"); throw giveRestException(HttpStatus.SC_BAD_REQUEST, "Missing file (check parameter file)"); } String fileName = getFileName(givenFileName, body); // Default mode. No user input. if (async == null) { async = false; } File tempFile = getTempFile(file, "rest-delegation-thread-entries", fileName); long currSize = tempFile.length(); if (sizeValidation) { checkSizeValidation(contentLength, fileSize, currSize); } if (async) { logger.debug("Async mode is used"); // Asynchronous mode AccountDto actorDto = threadEntryFacade.getAuthenticatedAccountDto(); AsyncTaskDto asyncTask = null; try { asyncTask = asyncTaskFacade.create(ownerUuid, currSize, transfertDuration, fileName, null, AsyncTaskType.THREAD_ENTRY_UPLOAD); ThreadEntryTaskContext threadEntryTaskContext = new ThreadEntryTaskContext(actorDto, ownerUuid, threadUuid, tempFile, fileName, null); ThreadEntryUploadAsyncTask task = new ThreadEntryUploadAsyncTask(threadEntryAsyncFacade, threadEntryTaskContext, asyncTask); taskExecutor.execute(task); return new WorkGroupEntryDto(asyncTask, threadEntryTaskContext); } catch (Exception e) { logAsyncFailure(ownerUuid, asyncTask, e); throw e; } finally { deleteTempFile(tempFile); } } else { // TODO : manage transfertDuration // Synchronous mode try { logger.debug("Async mode is not used"); return threadEntryFacade.create(ownerUuid, threadUuid, tempFile, fileName); } finally { deleteTempFile(tempFile); } } } @Path("/copy") @POST @Consumes(MediaType.MULTIPART_FORM_DATA) @ApiOperation(value = "Create a thread entry which will contain the uploaded file.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto copy( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The document entry uuid.", required = true) @PathParam("entryUuid") String entryUuid, @ApiParam(value = "True to enable asynchronous upload processing.", required = false) @QueryParam("async") Boolean async) throws BusinessException { // Default mode. No user input. if (async == null) { async = false; } if (async) { logger.debug("Async mode is used"); AccountDto actorDto = threadEntryFacade.getAuthenticatedAccountDto(); AsyncTaskDto asyncTask = null; try { asyncTask = asyncTaskFacade.create(ownerUuid, entryUuid, AsyncTaskType.DOCUMENT_COPY); ThreadEntryTaskContext tetc = new ThreadEntryTaskContext(actorDto, ownerUuid, threadUuid, entryUuid, null); ThreadEntryCopyAsyncTask task = new ThreadEntryCopyAsyncTask(threadEntryAsyncFacade, tetc, asyncTask); taskExecutor.execute(task); return new WorkGroupEntryDto(asyncTask, tetc); } catch (Exception e) { logAsyncFailure(ownerUuid, asyncTask, e); throw e; } } else { logger.debug("Async mode is not used"); return threadEntryFacade.copy(ownerUuid, threadUuid, entryUuid); } } @Path("/{uuid}") @GET @ApiOperation(value = "Get a thread entry.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto find( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { return threadEntryFacade.find(ownerUuid, threadUuid, uuid); } @Path("/{uuid}") @HEAD @ApiOperation(value = "Get a thread entry.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public void head( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { threadEntryFacade.find(ownerUuid, threadUuid, uuid); } @Path("/") @GET @ApiOperation(value = "Get all thread entries.", response = WorkGroupEntryDto.class, responseContainer = "Set") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public List<WorkGroupEntryDto> findAll( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid) throws BusinessException { return threadEntryFacade.findAll(ownerUuid, threadUuid); } @Path("/") @DELETE @ApiOperation(value = "Delete a thread entry.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry or thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto delete( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry to delete.", required = true) WorkGroupEntryDto threadEntry) throws BusinessException { return threadEntryFacade.delete(ownerUuid, threadUuid, threadEntry); } @Path("/{uuid}") @DELETE @ApiOperation(value = "Delete a thread entry.", response = WorkGroupEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry or thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto delete( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry uuid to delete.", required = true) @PathParam("uuid") String uuid) throws BusinessException { return threadEntryFacade.delete(ownerUuid, threadUuid, uuid); } @Path("/{ownerUuid}/documents/{uuid}/download") @GET @ApiOperation(value = "Download a file.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public Response download( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { return threadEntryFacade.download(ownerUuid, threadUuid, uuid); } @Path("/{ownerUuid}/documents/{uuid}/thumbnail") @GET @ApiOperation(value = "Download the thumbnail of a file.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public Response thumbnail( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The document uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { return threadEntryFacade.thumbnail(ownerUuid, threadUuid, uuid); } @Path("/{ownerUuid}/documents/{uuid}") @PUT @ApiOperation(value = "Update the thread entry properties.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public WorkGroupEntryDto update( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The document uuid.", required = true) @PathParam("uuid") String threadEntryuuid, @ApiParam(value = "The Thread Entry.", required = true) WorkGroupEntryDto threadEntryDto) throws BusinessException { return threadEntryFacade.update(ownerUuid, threadUuid, threadEntryuuid, threadEntryDto); } @Path("/{uuid}/async") @GET @Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON }) @Override public AsyncTaskDto findAsync( @ApiParam(value = "The owner (user) uuid.", required = true) @PathParam("ownerUuid") String ownerUuid, @ApiParam(value = "The async task uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { Validate.notEmpty(uuid, "Missing uuid"); return asyncTaskFacade.find(ownerUuid, uuid); } protected void logAsyncFailure(String ownerUuid, AsyncTaskDto asyncTask, Exception e) { logger.error(e.getMessage()); logger.debug("Exception : ", e); if (asyncTask != null) { asyncTaskFacade.fail(ownerUuid, asyncTask, e); } } }