Package dev.relism.flash.api.multipart

Class Part

java.lang.Object

dev.relism.flash.api.multipart.Part

public final class Part
extends Object

One part of a multipart/form-data body produced by Multipart.

Two internal states:

• Buffered (text fields and Multipart.parts() results) — body is in a byte[]; stream(), materialize(), and text() are all repeatable and free of I/O.
• Streaming (file parts returned by Multipart.file(String)) — body is a bounded socket InputStream; call stream() or materialize() exactly once, before requesting the next part from Multipart.

Method Summary

Modifier and Type	Method	Description
String	contentType()	Content-Type declared in the part headers, or null if absent.
String	filename()	Original filename from filename="...", or null for text fields.
boolean	isFile()	true if this part has a filename attribute (i.e.
byte[]	materialize()	Materialises the body into a byte[].
String	name()	Field or file name from Content-Disposition: form-data; name="...".
InputStream	stream()	Returns an InputStream over the part body.
String	text()	Decodes the body as UTF-8.

Methods inherited from class java.lang.Object

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

Method Details

name

public String name()

Field or file name from Content-Disposition: form-data; name="...".

filename

public String filename()

Original filename from filename="...", or null for text fields.

contentType

public String contentType()

Content-Type declared in the part headers, or null if absent.

isFile

public boolean isFile()

true if this part has a filename attribute (i.e. a file upload).

stream

public InputStream stream()

Returns an InputStream over the part body. For buffered parts: returns a fresh reader each call. For streaming file parts: returns the raw socket stream — read once only.

materialize

public byte[] materialize()
                   throws IOException

Materialises the body into a byte[]. Result is cached; safe to call repeatedly. For streaming file parts: triggers a full read from the socket on first call.

Throws:

IOException

text

public String text()
            throws IOException

Decodes the body as UTF-8. Materialises if needed; result is cached. For streaming file parts: triggers a full read from the socket on first call.

Throws:

IOException