/**
* Copyright 2005-2014 Restlet
*
* The contents of this file are subject to the terms of one of the following
* open source licenses: Apache 2.0 or or EPL 1.0 (the "Licenses"). You can
* select the license that you prefer but you may not use this file except in
* compliance with one of these Licenses.
*
* You can obtain a copy of the Apache 2.0 license at
* http://www.opensource.org/licenses/apache-2.0
*
* You can obtain a copy of the EPL 1.0 license at
* http://www.opensource.org/licenses/eclipse-1.0
*
* See the Licenses for the specific language governing permissions and
* limitations under the Licenses.
*
* Alternatively, you can obtain a royalty free commercial license with less
* limitations, transferable or non-transferable, directly at
* http://restlet.com/products/restlet-framework
*
* Restlet is a registered trademark of Restlet S.A.S.
*/
package org.restlet.ext.jaxrs.internal.wrappers.provider;
import java.io.IOException;
import java.io.InputStream;
import java.lang.annotation.Annotation;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Type;
import java.util.List;
import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.MultivaluedMap;
import org.restlet.data.CharacterSet;
import org.restlet.data.MediaType;
/**
* Class to wrap an initialized {@link javax.ws.rs.ext.MessageBodyReader}
*
* @author Stephan Koops
* @see javax.ws.rs.ext.MessageBodyReader
*/
public interface MessageBodyReader {
/**
* Returns the list of produced {@link MediaType}s of the wrapped
* {@link javax.ws.rs.ext.MessageBodyWriter}.
*
* @return List of produced {@link MediaType}s.
*/
List<MediaType> getConsumedMimes();
/**
* Returns the JAX-RS {@link javax.ws.rs.ext.MessageBodyReader}.
*
* @return the JAX-RS MessageBodyReader
*/
javax.ws.rs.ext.MessageBodyReader<?> getJaxRsReader();
/**
*
* @param type
* @param genericType
* @param annotations
* @param mediaType
* @return true, if the mapped message body reader could read to the given
* class
* @see {@link javax.ws.rs.ext.MessageBodyReader#isReadable(Class, Type, Annotation[])}
*/
boolean isReadable(Class<?> type, Type genericType,
Annotation annotations[], javax.ws.rs.core.MediaType mediaType);
/**
*
* @param type
* @param genericType
* @param annotations
* @param mediaType
* @param characterSet
* @param httpHeaders
* @param entityStream
* @return the read object
* @throws IOException
* @throws WebApplicationException
* @throws InvocationTargetException
* @see {@link javax.ws.rs.ext.MessageBodyReader#readFrom(Class, Type, Annotation[], javax.ws.rs.core.MediaType, MultivaluedMap, InputStream)}
*/
Object readFrom(Class<?> type, Type genericType, Annotation annotations[],
MediaType mediaType, CharacterSet characterSet,
MultivaluedMap<String, String> httpHeaders, InputStream entityStream)
throws IOException, WebApplicationException,
InvocationTargetException;
/**
* Checks, if this message body reader supports the given type (by the type
* parameter of the {@link javax.ws.rs.ext.MessageBodyWriter})
*
* @param entityClass
* the type
* @param genericType
* the generic type
* @return true, if this MessageBodyReader supports the given type, false,
* if not.
*/
boolean supportsRead(Class<?> entityClass, Type genericType);
}