runtime-core/aws.smithy.kotlin.runtime.content

Package-level declarations

Types

expect class BigDecimal(value: String) : Number, Comparable<BigDecimal>

A floating point decimal number with arbitrary precision.

actual class BigDecimal(val value: String) : Number, Comparable<BigDecimal>

expect class BigInteger(value: String) : Number, Comparable<BigInteger>

An arbitrarily large signed integer

actual class BigInteger(val value: String) : Number, Comparable<BigInteger>

sealed class ByteStream

Represents an abstract read-only stream of bytes

sealed class Document

A Document is used to store arbitrary or unstructured data.

DocumentBuilder

class DocumentBuilder

class FileContent(val file: File, val start: Long = 0, val endInclusive: Long = file.length() - 1)

ByteStream backed by a local file

Functions

fun buildDocument(init: DocumentBuilder.() -> Unit): Document

Builds a Document with the given builder.

fun Document(value: Boolean): Document

Construct a Document from a Boolean.

fun Document(value: Number): Document

Construct a Document from a Number of arbitrary precision.

fun Document(value: String): Document

Construct a Document from a String.

fun Document(value: List<Document?>): Document

Construct a Document from a List.

fun Document(value: Map<String, Document?>): Document

Construct a Document from a Map.

Inherited functions

appendToOutputStream

suspend fun <Error class: unknown class>.appendToOutputStream(outputStream: OutputStream): Long

Writes this stream to the given OutputStream. This method does not flush or close the given OutputStream.

fun File.asByteStream(range: LongRange): <Error class: unknown class>

Create a ByteStream from a file with the given range

fun InputStream.asByteStream(contentLength: Long? = null): <Error class: unknown class>

Create a ByteStream.SourceStream that reads from this InputStream

fun Path.asByteStream(range: LongRange): <Error class: unknown class>

Create a ByteStream from a path with the given range

fun File.asByteStream(start: Long = 0, endInclusive: Long = length() - 1): <Error class: unknown class>

Create a ByteStream from a file

fun Path.asByteStream(start: Long = 0, endInclusive: Long = -1): <Error class: unknown class>

Create a ByteStream from a path

fun ByteStream.cancel()

suspend fun ByteStream.decodeToString(): String

fun <Error class: unknown class>.fromFile(file: File): <Error class: unknown class>

Create a ByteStream from a file

fromInputStream

fun <Error class: unknown class>.fromInputStream(inputStream: InputStream, contentLength: Long? = null): <Error class: unknown class>

Create a ByteStream.SourceStream that reads from the given InputStream

suspend fun ByteStream.toByteArray(): ByteArray

Consume the ByteStream and pull the entire contents into memory as a ByteArray. Only do this if you are sure the contents fit in-memory as this will read the entire contents of a streaming variant.

fun <Error class: unknown class><ByteArray>.toByteStream(scope: <Error class: unknown class>, contentLength: Long? = null): ByteStream

Create a ByteStream from a Flow of byte arrays.

fun ByteStream.toFlow(bufferSize: Long = 8192): <Error class: unknown class><ByteArray>

Return a Flow that consumes the underlying ByteStream when collected.

fun <Error class: unknown class>.toInputStream(): InputStream

Create a blocking InputStream that reads from the underlying ByteStream.

suspend fun <Error class: unknown class>.writeToFile(file: File): Long

Write the contents of this ByteStream to file and close it

suspend fun <Error class: unknown class>.writeToFile(path: Path): Long

Write the contents of this ByteStream to file at the given path

writeToOutputStream

suspend fun <Error class: unknown class>.writeToOutputStream(outputStream: OutputStream): Long

Writes this stream to the given OutputStream, then closes it.