org.eclipse.jetty.client.util

Class MultiPartContentProvider

java.lang.Object

org.eclipse.jetty.client.util.AbstractTypedContentProvider

org.eclipse.jetty.client.util.MultiPartContentProvider

All Implemented Interfaces:

Closeable, AutoCloseable, Iterable<ByteBuffer>, ContentProvider, ContentProvider.Typed, AsyncContentProvider

public class MultiPartContentProvider
extends AbstractTypedContentProvider
implements AsyncContentProvider, Closeable

A ContentProvider for form uploads with the "multipart/form-data" content type.

Example usage:

 MultiPartContentProvider multiPart = new MultiPartContentProvider();
 multiPart.addFieldPart("field", new StringContentProvider("foo"), null);
 multiPart.addFilePart("icon", "img.png", new PathContentProvider(Paths.get("/tmp/img.png")), null);
 multiPart.close();
 ContentResponse response = client.newRequest("localhost", connector.getLocalPort())
         .method(HttpMethod.POST)
         .content(multiPart)
         .send();
 

The above example would be the equivalent of submitting this form:

 <form method="POST" enctype="multipart/form-data"  accept-charset="UTF-8">
     <input type="text" name="field" value="foo" />
     <input type="file" name="icon" />
 </form>
 

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.AsyncContentProvider

AsyncContentProvider.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.api.ContentProvider

ContentProvider.Typed

Constructor Summary

Constructors

Constructor and Description
MultiPartContentProvider()
MultiPartContentProvider(String boundary)

Method Summary

Modifier and Type	Method and Description
void	addFieldPart(String name, ContentProvider content, HttpFields fields) Adds a field part with the given name as field name, and the given content as part content.
void	addFilePart(String name, String fileName, ContentProvider content, HttpFields fields) Adds a file part with the given name as field name, the given fileName as file name, and the given content as part content.
void	close()
long	getLength()
Iterator<ByteBuffer>	iterator()
void	setListener(AsyncContentProvider.Listener listener)

Methods inherited from class org.eclipse.jetty.client.util.AbstractTypedContentProvider

getContentType

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

MultiPartContentProvider

public MultiPartContentProvider()

MultiPartContentProvider

public MultiPartContentProvider(String boundary)

Method Detail

addFieldPart

public void addFieldPart(String name,
                         ContentProvider content,
                         HttpFields fields)

Adds a field part with the given name as field name, and the given content as part content.

The Content-Type of this part will be obtained from:

• the Content-Type header in the fields parameter; otherwise
• the ContentProvider.Typed.getContentType() method if the content parameter implements ContentProvider.Typed; otherwise
• "text/plain"

Parameters:

name - the part name

content - the part content

fields - the headers associated with this part

addFilePart

public void addFilePart(String name,
                        String fileName,
                        ContentProvider content,
                        HttpFields fields)

Adds a file part with the given name as field name, the given fileName as file name, and the given content as part content.

The Content-Type of this part will be obtained from:

• the Content-Type header in the fields parameter; otherwise
• the ContentProvider.Typed.getContentType() method if the content parameter implements ContentProvider.Typed; otherwise
• "application/octet-stream"

Parameters:

name - the part name

fileName - the file name associated to this part

content - the part content

fields - the headers associated with this part

setListener

public void setListener(AsyncContentProvider.Listener listener)

Specified by:

setListener in interface AsyncContentProvider

Parameters:

listener - the listener to be notified of content availability

getLength

public long getLength()

Specified by:

getLength in interface ContentProvider

Returns:

the content length, if known, or -1 if the content length is unknown

iterator

public Iterator<ByteBuffer> iterator()

Specified by:

iterator in interface Iterable<ByteBuffer>

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable