# StringCronetCallback


```
abstract class StringCronetCallback : InMemoryTransformCronetCallback
```

<br />

|---|---|---|---|---|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) |||||
| ↳ | [org.chromium.net.UrlRequest.Callback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest.Callback) ||||
|   | ↳ | [org.chromium.net.apihelpers.ImplicitFlowControlCallback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback) |||
|   |   | ↳ | [org.chromium.net.apihelpers.InMemoryTransformCronetCallback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback) ||
|   |   |   | ↳ | [org.chromium.net.apihelpers.StringCronetCallback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/StringCronetCallback) |

*** ** * ** ***

A specialization of `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback` that interprets the response body as a string.

The charset used to decode the string is derived from the `Content-Type` header.

## Summary

| ### Public functions |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/StringCronetCallback!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/StringCronetCallback#addCompletionListener(org.chromium.net.apihelpers.CronetRequestCompletionListener<? super java.lang.String>)( listener: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/CronetRequestCompletionListener<https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!>! )` Adds a completion listener. |

| ### Protected functions |
|---|---|
| `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/StringCronetCallback#transformBodyBytes(org.chromium.net.UrlResponseInfo,byte[])(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, bodyBytes: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html!)` Transforms (deserializes) the plain full body into a user-defined object. |

| ### Inherited functions |
|---|
| From [org.chromium.net.apihelpers.ImplicitFlowControlCallback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback) |---|---| | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onCanceled(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo)(request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!)` Invoked if request was canceled via `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest#cancel()`. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onFailed(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,org.chromium.net.CronetException)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, error: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetException! )` Invoked if request failed for any reason after `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest#start()`. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onReadCompleted(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,java.nio.ByteBuffer)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, byteBuffer: https://developer.android.com/reference/java/nio/ByteBuffer.html! )` Invoked whenever part of the response body has been read. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onRedirectReceived(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,java.lang.String)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, newLocationUrl: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html! )` Invoked whenever a redirect is encountered. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onResponseStarted(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo)(request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!)` Invoked when the final set of headers, after all redirects, is received. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#onSucceeded(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo)(request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!)` Invoked when request is completed successfully. | | `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/ImplicitFlowControlCallback#shouldFollowRedirect(org.chromium.net.UrlResponseInfo,java.lang.String)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, newLocationUrl: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html!)` Invoked whenever a redirect is encountered. | |
| From [org.chromium.net.apihelpers.InMemoryTransformCronetCallback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback) |---|---| | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback#onBodyChunkRead(org.chromium.net.UrlResponseInfo,java.nio.ByteBuffer)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, bodyChunk: https://developer.android.com/reference/java/nio/ByteBuffer.html!)` Invoked whenever part of the response body has been read. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback#onCanceled(org.chromium.net.UrlResponseInfo)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo?)` Invoked if request was canceled via `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest#cancel()`. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback#onFailed(org.chromium.net.UrlResponseInfo,org.chromium.net.CronetException)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo?, exception: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetException!)` Invoked if request failed for any reason after `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest#start()`. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback#onResponseStarted(org.chromium.net.UrlResponseInfo)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!)` Invoked when the final set of headers, after all redirects, is received. | | `https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/InMemoryTransformCronetCallback#onSucceeded(org.chromium.net.UrlResponseInfo)(info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!)` Invoked when request is completed successfully. | |
| From [org.chromium.net.UrlRequest.Callback](https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest.Callback) |---|---| | `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest.Callback#onFailed(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,org.chromium.net.CronetException)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, error: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/CronetException! )` Invoked if request failed for any reason after `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest#start()`. | | `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest.Callback#onReadCompleted(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,java.nio.ByteBuffer)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, byteBuffer: https://developer.android.com/reference/java/nio/ByteBuffer.html! )` Invoked whenever part of the response body has been read. | | `abstract https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html` | `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest.Callback#onRedirectReceived(org.chromium.net.UrlRequest,org.chromium.net.UrlResponseInfo,java.lang.String)( request: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlRequest!, info: https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/UrlResponseInfo!, newLocationUrl: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html! )` Invoked whenever a redirect is encountered. | |

## Public functions

### addCompletionListener

```
fun addCompletionListener(
    listener: CronetRequestCompletionListener<String!>!
): StringCronetCallback!
```

Adds a completion listener. All listeners are informed when the request reaches a terminal state, in order of addition. If a listener is added multiple times, it will only be called once according to the first time it was added.

| See also |
|---|---|
| `https://developer.android.com/develop/connectivity/cronet/reference/kotlin/org/chromium/net/apihelpers/CronetRequestCompletionListener` |   |

## Protected functions

### transformBodyBytes

```
protected fun transformBodyBytes(info: UrlResponseInfo!, bodyBytes: ByteArray!): String!
```

Transforms (deserializes) the plain full body into a user-defined object.

It is assumed that the implementing classes handle edge cases (such as empty and malformed bodies) appropriately. Cronet doesn't inspects the objects and passes them (or any exceptions) along to the issuer of the request.