com.dg.libs.rest.parsers.StringHttpResponseParser Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of android-rest Show documentation

This is a library for android for Making RestFul Requests

There is a newer version: 2.9.0

package com.dg.libs.rest.parsers;

import java.io.InputStream;

import com.dg.libs.rest.client.StreamUtil;

/**
 * The {@link HttpResponseParser} interface has the responsibility to parse
 * responses from the server.
 * 
 * @param 
 *           Parameter that indicates which object the parser returns. It can be
 *           of any type.
 */
public abstract class StringHttpResponseParser implements HttpResponseParser {

	/**
	 * Do not override this method. Use the **abstract** {@link #parse(String)}
	 * 
	 * This method is used for parsing text from the server. can be used for
	 * anything that can be converted out of a string
	 * 
	 * @param responseStream
	 *           The JSON string needed for parsing.
	 * @return Object of any type returned by the parser.
	 * @throws Exception
	 *            Thrown when various parsing errors occur.
	 */
	@Override
	public T parse(final InputStream responseStream) throws Exception {
		return parse(StreamUtil.convertStreamToString(responseStream));
	}

	public abstract T parse(final String response) throws Exception;
}