Package org.gcube.common.gxrest.request

Class GXHTTPStreamRequest

java.lang.Object

org.gcube.common.gxrest.request.GXHTTPStreamRequest

All Implemented Interfaces:

org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

public class GXHTTPStreamRequest
extends Object
implements org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

A context-aware request to a web application. It supports sending streams through Put/Post requests.

Author:

Manuele Simi (ISTI-CNR), Luca Frosini (ISTI-CNR)

Field Summary

Fields

Modifier and Type	Field	Description
protected static final org.slf4j.Logger	logger	The logger.

Method Summary

Modifier and Type	Method	Description
void	clear()	Clear up the request.
GXInboundResponse	connect()
GXInboundResponse	delete()
GXHTTPStreamRequest	from(String agent)	Sets the User-Agent for the request.
GXInboundResponse	get()
GXInboundResponse	head()
GXHTTPStreamRequest	header(String name, String value)	Adds a header to the request.
static GXHTTPStreamRequest	newRequest(String address)	Creates a new request.
GXInboundResponse	options()
GXInboundResponse	patch()
GXInboundResponse	patch(InputStream body)
GXHTTPStreamRequest	path(String path)	Adds a path to the request URL.
GXInboundResponse	post()
GXInboundResponse	post(InputStream body)
GXInboundResponse	purge()
GXInboundResponse	put()
GXInboundResponse	put(InputStream body)
GXHTTPStreamRequest	queryParams(Map<String,String> queryParams)	Adds query parameters to the request.
GXInboundResponse	trace()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

logger

protected static final org.slf4j.Logger logger

The logger.

Method Details

newRequest

public static GXHTTPStreamRequest newRequest(String address)

Creates a new request.

Parameters:

address - the address of the web app to call

Returns:

the request

put

public GXInboundResponse put(InputStream body)
                      throws Exception

Specified by:

put in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

post

public GXInboundResponse post(InputStream body)
                       throws Exception

Specified by:

post in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

patch

public GXInboundResponse patch(InputStream body)
                        throws Exception

Specified by:

patch in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

put

public GXInboundResponse put()
                      throws Exception

Specified by:

put in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

delete

public GXInboundResponse delete()
                         throws Exception

Specified by:

delete in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

purge

public GXInboundResponse purge()
                        throws Exception

Specified by:

purge in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

head

public GXInboundResponse head()
                       throws Exception

Specified by:

head in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

get

public GXInboundResponse get()
                      throws Exception

Specified by:

get in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

post

public GXInboundResponse post()
                       throws Exception

Specified by:

post in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

trace

public GXInboundResponse trace()
                        throws Exception

Specified by:

trace in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

patch

public GXInboundResponse patch()
                        throws Exception

Specified by:

patch in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

options

public GXInboundResponse options()
                          throws Exception

Specified by:

options in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

connect

public GXInboundResponse connect()
                          throws Exception

Specified by:

connect in interface org.gcube.common.gxhttp.reference.GXHTTP<InputStream,GXInboundResponse>

Throws:

Exception

from

public GXHTTPStreamRequest from(String agent)

Sets the User-Agent for the request.

Parameters:

agent - the agent

Returns:

the request

clear

public void clear()

Clear up the request.

path

public GXHTTPStreamRequest path(String path)
                         throws UnsupportedEncodingException

Adds a path to the request URL.

Parameters:

path - the path to add

Returns:

the request

Throws:

UnsupportedEncodingException - if the encoding is not supported

header

public GXHTTPStreamRequest header(String name,
 String value)

Adds a header to the request.

Parameters:

name - the name of the header

value - the value of the header

Returns:

the request

queryParams

public GXHTTPStreamRequest queryParams(Map<String,String> queryParams)
                                throws UnsupportedEncodingException

Adds query parameters to the request.

Parameters:

queryParams - the query parameters

Returns:

the request

Throws:

UnsupportedEncodingException - if the encoding is not supported