/* * Copyright 2002-2017 the original author or authors. * * 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 org.springframework.http.converter; import java.io.FileNotFoundException; import java.io.IOException; import java.io.InputStream; import org.springframework.core.io.ByteArrayResource; import org.springframework.core.io.InputStreamResource; import org.springframework.core.io.Resource; import org.springframework.http.HttpInputMessage; import org.springframework.http.HttpOutputMessage; import org.springframework.http.MediaType; import org.springframework.http.MediaTypeFactory; import org.springframework.util.StreamUtils; /** * Implementation of {@link HttpMessageConverter} that can read/write {@link Resource Resources} * and supports byte range requests. * * <p>By default, this converter can read all media types. The {@link MediaTypeFactory} is used * to determine the {@code Content-Type} of written resources. * * @author Arjen Poutsma * @author Juergen Hoeller * @author Kazuki Shimizu * @since 3.0.2 */ public class ResourceHttpMessageConverter extends AbstractHttpMessageConverter<Resource> { private final boolean supportsReadStreaming; /** * Create a new instance of the {@code ResourceHttpMessageConverter} * that supports read streaming, i.e. can convert an * {@code HttpInputMessage} to {@code InputStreamResource}. */ public ResourceHttpMessageConverter() { super(MediaType.ALL); this.supportsReadStreaming = true; } /** * Create a new instance of the {@code ResourceHttpMessageConverter}. * @param supportsReadStreaming whether the converter should support * read streaming, i.e. convert to {@code InputStreamResource} * @since 5.0 */ public ResourceHttpMessageConverter(boolean supportsReadStreaming) { super(MediaType.ALL); this.supportsReadStreaming = supportsReadStreaming; } @Override protected boolean supports(Class<?> clazz) { return Resource.class.isAssignableFrom(clazz); } @Override protected Resource readInternal(Class<? extends Resource> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException { final String filename = inputMessage.getHeaders().getContentDisposition().getFilename(); if (this.supportsReadStreaming && InputStreamResource.class == clazz) { return new InputStreamResource(inputMessage.getBody()) { @Override public String getFilename() { return filename; } }; } else if (clazz.isAssignableFrom(ByteArrayResource.class)) { byte[] body = StreamUtils.copyToByteArray(inputMessage.getBody()); return new ByteArrayResource(body) { @Override public String getFilename() { return filename; } }; } else { throw new IllegalStateException("Unsupported resource class: " + clazz); } } @Override protected MediaType getDefaultContentType(Resource resource) { return MediaTypeFactory.getMediaType(resource).orElse(MediaType.APPLICATION_OCTET_STREAM); } @Override protected Long getContentLength(Resource resource, MediaType contentType) throws IOException { // Don't try to determine contentLength on InputStreamResource - cannot be read afterwards... // Note: custom InputStreamResource subclasses could provide a pre-calculated content length! if (InputStreamResource.class == resource.getClass()) { return null; } long contentLength = resource.contentLength(); return (contentLength < 0 ? null : contentLength); } @Override protected void writeInternal(Resource resource, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException { writeContent(resource, outputMessage); } protected void writeContent(Resource resource, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException { try { InputStream in = resource.getInputStream(); try { StreamUtils.copy(in, outputMessage.getBody()); } catch (NullPointerException ex) { // ignore, see SPR-13620 } finally { try { in.close(); } catch (Throwable ex) { // ignore, see SPR-12999 } } } catch (FileNotFoundException ex) { // ignore, see SPR-12999 } } }