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.userv2.impl; 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.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.core.MediaType; import javax.ws.rs.core.Response; import org.apache.commons.httpclient.HttpStatus; import org.apache.cxf.jaxrs.ext.multipart.Multipart; import org.apache.cxf.jaxrs.ext.multipart.MultipartBody; import org.linagora.linshare.core.exception.BusinessException; import org.linagora.linshare.core.facade.webservice.common.dto.ThreadEntryDto; import org.linagora.linshare.core.facade.webservice.user.ThreadEntryFacade; import org.linagora.linshare.webservice.WebserviceBase; import org.linagora.linshare.webservice.userv2.ThreadEntryRestService; 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("/threads/{threadUuid}/entries") @Api(value = "/rest/user/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; public ThreadEntryRestServiceImpl(ThreadEntryFacade threadEntryFacade) { super(); this.threadEntryFacade = threadEntryFacade; } @Path("/") @POST @Consumes(MediaType.MULTIPART_FORM_DATA) @ApiOperation(value = "Create a thread entry which will contain the uploaded file.", response = ThreadEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public ThreadEntryDto create( @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "File stream.", required = true) InputStream theFile, @ApiParam(value = "An optional description of a thread entry.") @Multipart(value = "description", required = false) String description, @ApiParam(value = "The given file name of the uploaded file.", required = true) @Multipart(value = "filename", required = false) String givenFileName, MultipartBody body) throws BusinessException { String fileName; if (theFile == null) { throw giveRestException(HttpStatus.SC_BAD_REQUEST, "Missing file (check parameter file)"); } if (givenFileName == null || givenFileName.isEmpty()) { // parameter givenFileName is optional // so need to search this information in the header of the // attachement (with id file) fileName = body.getAttachment("file").getContentDisposition().getParameter("filename"); } else { fileName = givenFileName; } return threadEntryFacade.create(threadUuid, theFile, fileName); } @Path("/copy/{entryUuid}") @POST @ApiOperation(value = "Create a thread entry which will contain the uploaded file.", response = ThreadEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public ThreadEntryDto copy( @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The document entry uuid.", required = true) @PathParam("entryUuid") String entryUuid) throws BusinessException { return threadEntryFacade.copy(threadUuid, entryUuid); } @Path("/{uuid}") @GET @ApiOperation(value = "Get a thread entry.", response = ThreadEntryDto.class) @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public ThreadEntryDto find( @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(threadUuid, uuid); } @Path("/") @GET @ApiOperation(value = "Get all thread entries.", response = ThreadEntryDto.class, responseContainer = "Set") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public List<ThreadEntryDto> findAll( @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid) throws BusinessException { return threadEntryFacade.findAll(threadUuid); } @Path("/") @DELETE @ApiOperation(value = "Delete a thread entry.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner or thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public void delete( @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread entry to delete.", required = true) ThreadEntryDto threadEntry) throws BusinessException { threadEntryFacade.delete(threadUuid, threadEntry); } @Path("/{uuid}") @DELETE @ApiOperation(value = "Delete a thread entry.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner or thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public void delete( @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 { threadEntryFacade.delete(threadUuid, uuid); } @Path("/{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 = "Owner 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 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(threadUuid, uuid); } @Path("/{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 = "Owner 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 thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The document uuid.", required = true) @PathParam("uuid") String uuid) throws BusinessException { return threadEntryFacade.thumbnail(threadUuid, uuid); } @Path("/{uuid}") @PUT @ApiOperation(value = "Update a thread entry.") @ApiResponses({ @ApiResponse(code = 403, message = "Current logged in account does not have the delegation role."), @ApiResponse(code = 404, message = "Owner or thread entry not found."), @ApiResponse(code = 400, message = "Bad request : missing required fields."), @ApiResponse(code = 500, message = "Internal server error."), }) @Override public ThreadEntryDto update( @ApiParam(value = "The thread uuid.", required = true) @PathParam("threadUuid") String threadUuid, @ApiParam(value = "The thread uuid.", required = true) @PathParam("uuid") String threadEntryUuid, ThreadEntryDto threadEntryDto) throws BusinessException { return threadEntryFacade.update(threadUuid, threadEntryUuid, threadEntryDto); } }