Skip to content

Commit

Permalink
Update pages for Kotlin SDK v9.1.0 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
pubnub-release-bot committed Apr 9, 2024
1 parent 458ab65 commit ada2a6f
Show file tree
Hide file tree
Showing 2,928 changed files with 19,214 additions and 18,063 deletions.
4 changes: 2 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@
| Name |
|---|
| [pubnub-core-api](pubnub-core/pubnub-core-api/index.md) | |
| [pubnub-gson](pubnub-gson/index.md) | |
| [pubnub-kotlin](pubnub-kotlin/index.md) | |
| [pubnub-gson-api](pubnub-gson/pubnub-gson-api/index.md) | |
| [pubnub-kotlin-api](pubnub-kotlin/pubnub-kotlin-api/index.md) | |
2,750 changes: 1,409 additions & 1,341 deletions package-list

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions pubnub-core/pubnub-core-api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
| [com.pubnub.api.crypto](pubnub-core-api/com.pubnub.api.crypto/index.md) |
| [com.pubnub.api.crypto.cryptor](pubnub-core-api/com.pubnub.api.crypto.cryptor/index.md) |
| [com.pubnub.api.crypto.data](pubnub-core-api/com.pubnub.api.crypto.data/index.md) |
| [com.pubnub.api.endpoints](pubnub-core-api/com.pubnub.api.endpoints/index.md) |
| [com.pubnub.api.endpoints.remoteaction](pubnub-core-api/com.pubnub.api.endpoints.remoteaction/index.md) |
| [com.pubnub.api.enums](pubnub-core-api/com.pubnub.api.enums/index.md) |
| [com.pubnub.api.models](pubnub-core-api/com.pubnub.api.models/index.md) |
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
//[pubnub-core-api](../../../index.md)/[com.pubnub.api.endpoints](../index.md)/[HasOverridableConfig](index.md)/[configuration](configuration.md)

# configuration

[jvm]\
abstract val [configuration](configuration.md): [BasePNConfiguration](../../com.pubnub.api.v2/-base-p-n-configuration/index.md)
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
//[pubnub-core-api](../../../index.md)/[com.pubnub.api.endpoints](../index.md)/[HasOverridableConfig](index.md)

# HasOverridableConfig

[jvm]\
interface [HasOverridableConfig](index.md)

## Properties

| Name | Summary |
|---|---|
| [configuration](configuration.md) | [jvm]<br>abstract val [configuration](configuration.md): [BasePNConfiguration](../../com.pubnub.api.v2/-base-p-n-configuration/index.md) |

## Functions

| Name | Summary |
|---|---|
| [overrideConfiguration](override-configuration.md) | [jvm]<br>abstract fun [overrideConfiguration](override-configuration.md)(configuration: [BasePNConfiguration](../../com.pubnub.api.v2/-base-p-n-configuration/index.md)) |
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
//[pubnub-core-api](../../../index.md)/[com.pubnub.api.endpoints](../index.md)/[HasOverridableConfig](index.md)/[overrideConfiguration](override-configuration.md)

# overrideConfiguration

[jvm]\
abstract fun [overrideConfiguration](override-configuration.md)(configuration: [BasePNConfiguration](../../com.pubnub.api.v2/-base-p-n-configuration/index.md))
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
//[pubnub-core-api](../../index.md)/[com.pubnub.api.endpoints](index.md)

# Package-level declarations

## Types

| Name | Summary |
|---|---|
| [HasOverridableConfig](-has-overridable-config/index.md) | [jvm]<br>interface [HasOverridableConfig](-has-overridable-config/index.md) |
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ abstract fun [add](add.md)(subscription: [Subscription](index.md))

Add a [Subscription](index.md) to this set.

Please note that this SubscriptionSet will *not* attempt to ensure all subscriptions match their active/inactive state. That is, if you previously called [subscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription-set/subscribe.md) or [unsubscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription-set/unsubscribe.md) on this set, it will not be called on the newly added [subscription](add.md) automatically.
Please note that this SubscriptionSet will *not* attempt to ensure all subscriptions match their active/inactive state. That is, if you previously called [subscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription-set/subscribe.md) or [unsubscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription-set/unsubscribe.md) on this set, it will not be called on the newly added [subscription](add.md) automatically.

#### Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ abstract fun [remove](remove.md)(subscription: [Subscription](index.md))

Remove the [subscription](remove.md) from this set.

Please note that removing a subscription from the set does not automatically [unsubscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription-set/unsubscribe.md) or [close](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription-set/close.md) it.
Please note that removing a subscription from the set does not automatically [unsubscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription-set/unsubscribe.md) or [close](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription-set/close.md) it.

#### Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ Represents a potential subscription to the PubNub real-time network.

Create objects of this class through the [com.pubnub.api.v2.entities.Subscribable.subscription](../../com.pubnub.api.v2.entities/-subscribable/subscription.md) method of the respective entities, such as [com.pubnub.api.v2.entities.BaseChannel](../../com.pubnub.api.v2.entities/-base-channel/index.md), [com.pubnub.api.v2.entities.BaseChannelGroup](../../com.pubnub.api.v2.entities/-base-channel-group/index.md), [com.pubnub.api.v2.entities.BaseChannelMetadata](../../com.pubnub.api.v2.entities/-base-channel-metadata/index.md) and [com.pubnub.api.v2.entities.BaseUserMetadata](../../com.pubnub.api.v2.entities/-base-user-metadata/index.md).

Created subscriptions are initially inactive, which means you must call [subscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription/subscribe.md) to start receiving events.
Created subscriptions are initially inactive, which means you must call [subscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription/subscribe.md) to start receiving events.

This class implements the [AutoCloseable](https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html) interface to help you release resources by calling [unsubscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription/unsubscribe.md) and removing all listeners on [close](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription/close.md). Remember to always call [close](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription/close.md) when you no longer need this Subscription.
This class implements the [AutoCloseable](https://docs.oracle.com/javase/8/docs/api/java/lang/AutoCloseable.html) interface to help you release resources by calling [unsubscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription/unsubscribe.md) and removing all listeners on [close](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription/close.md). Remember to always call [close](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription/close.md) when you no longer need this Subscription.

## Functions

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ class [SubscriptionCursor](index.md)(val timetoken: [Long](https://kotlinlang.or

A holder for a timetoken value.

Used with [BaseSubscription.subscribe](../../../../../pubnub-gson/com.pubnub.api.v2.subscriptions/-base-subscription/subscribe.md) to start listening for events newer or equal to the requested timetoken.
Used with [BaseSubscription.subscribe](../../../../../pubnub-core/pubnub-core-api/com.pubnub.api.v2.subscriptions/-base-subscription/subscribe.md) to start listening for events newer or equal to the requested timetoken.

## Constructors

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[authKey](auth-key.md)

# authKey

[jvm]\
abstract val [authKey](auth-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)

If Access Manager is utilized, client will use this authKey in all restricted requests.
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[connectTimeout](connect-timeout.md)

# connectTimeout

[jvm]\
abstract val [connectTimeout](connect-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)

How long before the client gives up trying to connect with the server.

The value is in seconds.

Defaults to 5.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[cryptoModule](crypto-module.md)

# cryptoModule

[jvm]\
abstract val [cryptoModule](crypto-module.md): [CryptoModule](../../../com.pubnub.api.crypto/-crypto-module/index.md)?

CryptoModule is responsible for handling encryption and decryption. If set, all communications to and from PubNub will be encrypted.
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[includeInstanceIdentifier](include-instance-identifier.md)

# includeInstanceIdentifier

[jvm]\
abstract val [includeInstanceIdentifier](include-instance-identifier.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)

Whether to include a PubNub.instanceId with every request.

Defaults to `false`.
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[includeRequestIdentifier](include-request-identifier.md)

# includeRequestIdentifier

[jvm]\
abstract val [includeRequestIdentifier](include-request-identifier.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)

Whether to include a PubNub.requestId with every request.

Defaults to `true`.
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)

# Builder

[jvm]\
interface [Builder](index.md)

## Properties

| Name | Summary |
|---|---|
| [authKey](auth-key.md) | [jvm]<br>abstract val [authKey](auth-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)<br>If Access Manager is utilized, client will use this authKey in all restricted requests. |
| [connectTimeout](connect-timeout.md) | [jvm]<br>abstract val [connectTimeout](connect-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>How long before the client gives up trying to connect with the server. |
| [cryptoModule](crypto-module.md) | [jvm]<br>abstract val [cryptoModule](crypto-module.md): [CryptoModule](../../../com.pubnub.api.crypto/-crypto-module/index.md)?<br>CryptoModule is responsible for handling encryption and decryption. If set, all communications to and from PubNub will be encrypted. |
| [includeInstanceIdentifier](include-instance-identifier.md) | [jvm]<br>abstract val [includeInstanceIdentifier](include-instance-identifier.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>Whether to include a PubNub.instanceId with every request. |
| [includeRequestIdentifier](include-request-identifier.md) | [jvm]<br>abstract val [includeRequestIdentifier](include-request-identifier.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>Whether to include a PubNub.requestId with every request. |
| [nonSubscribeReadTimeout](non-subscribe-read-timeout.md) | [jvm]<br>abstract val [nonSubscribeReadTimeout](non-subscribe-read-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>For non subscribe operations (publish, herenow, etc), This property relates to a read timeout that is applied from the moment the connection between a client and the server has been successfully established. It defines a maximum time of inactivity between two data packets when waiting for the server’s response. |
| [publishKey](publish-key.md) | [jvm]<br>abstract val [publishKey](publish-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)<br>The publish key from the admin panel (only required if publishing). |
| [retryConfiguration](retry-configuration.md) | [jvm]<br>abstract val [retryConfiguration](retry-configuration.md): [RetryConfiguration](../../../com.pubnub.api.retry/-retry-configuration/index.md)<br>Retry configuration for requests. Defaults to [RetryConfiguration.None](../../../com.pubnub.api.retry/-retry-configuration/-none/index.md). |
| [secretKey](secret-key.md) | [jvm]<br>abstract val [secretKey](secret-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)<br>The secret key from the admin panel (only required for modifying/revealing access permissions). |
| [subscribeKey](subscribe-key.md) | [jvm]<br>abstract val [subscribeKey](subscribe-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)<br>The subscribe key from the admin panel. |
| [userId](user-id.md) | [jvm]<br>abstract val [userId](user-id.md): [UserId](../../../com.pubnub.api/-user-id/index.md)<br>The user ID that the PubNub client will use. |
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[nonSubscribeReadTimeout](non-subscribe-read-timeout.md)

# nonSubscribeReadTimeout

[jvm]\
abstract val [nonSubscribeReadTimeout](non-subscribe-read-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)

For non subscribe operations (publish, herenow, etc), This property relates to a read timeout that is applied from the moment the connection between a client and the server has been successfully established. It defines a maximum time of inactivity between two data packets when waiting for the server’s response.

The value is in seconds.

Defaults to 10.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[publishKey](publish-key.md)

# publishKey

[jvm]\
abstract val [publishKey](publish-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)

The publish key from the admin panel (only required if publishing).
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[retryConfiguration](retry-configuration.md)

# retryConfiguration

[jvm]\
abstract val [retryConfiguration](retry-configuration.md): [RetryConfiguration](../../../com.pubnub.api.retry/-retry-configuration/index.md)

Retry configuration for requests. Defaults to [RetryConfiguration.None](../../../com.pubnub.api.retry/-retry-configuration/-none/index.md).

Use [RetryConfiguration.Linear](../../../com.pubnub.api.retry/-retry-configuration/-linear/index.md) to set retry with linear delay interval Use [RetryConfiguration.Exponential](../../../com.pubnub.api.retry/-retry-configuration/-exponential/index.md) to set retry with exponential delay interval Delay will valy from provided value by random value.
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[secretKey](secret-key.md)

# secretKey

[jvm]\
abstract val [secretKey](secret-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)

The secret key from the admin panel (only required for modifying/revealing access permissions).

Keep away from Android.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[subscribeKey](subscribe-key.md)

# subscribeKey

[jvm]\
abstract val [subscribeKey](subscribe-key.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)

The subscribe key from the admin panel.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
//[pubnub-core-api](../../../../index.md)/[com.pubnub.api.v2](../../index.md)/[BasePNConfigurationOverride](../index.md)/[Builder](index.md)/[userId](user-id.md)

# userId

[jvm]\
abstract val [userId](user-id.md): [UserId](../../../com.pubnub.api/-user-id/index.md)

The user ID that the PubNub client will use.
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
//[pubnub-core-api](../../../index.md)/[com.pubnub.api.v2](../index.md)/[BasePNConfigurationOverride](index.md)

# BasePNConfigurationOverride

interface [BasePNConfigurationOverride](index.md)

#### Inheritors

| |
|---|
| [BasePNConfiguration](../-base-p-n-configuration/index.md) |

## Types

| Name | Summary |
|---|---|
| [Builder](-builder/index.md) | [jvm]<br>interface [Builder](-builder/index.md) |
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@ interface [Builder](index.md)
| [managePresenceListManually](manage-presence-list-manually.md) | [jvm]<br>abstract val [managePresenceListManually](manage-presence-list-manually.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>Enables explicit presence control. When set to true heartbeat calls will contain only channels and groups added explicitly using PubNubCore.presence. Should be used only with ACL set on the server side. For more information please contact PubNub support |
| [maximumConnections](maximum-connections.md) | [jvm]<br>abstract val [maximumConnections](maximum-connections.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)? |
| [maximumMessagesCacheSize](maximum-messages-cache-size.md) | [jvm]<br>abstract val [maximumMessagesCacheSize](maximum-messages-cache-size.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) |
| [nonSubscribeRequestTimeout](non-subscribe-request-timeout.md) | [jvm]<br>abstract val [nonSubscribeRequestTimeout](non-subscribe-request-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>For non subscribe operations (publish, herenow, etc), This property relates to a read timeout that is applied from the moment the connection between a client and the server has been successfully established. It defines a maximum time of inactivity between two data packets when waiting for the server’s response. |
| [nonSubscribeReadTimeout](non-subscribe-read-timeout.md) | [jvm]<br>abstract val [nonSubscribeReadTimeout](non-subscribe-read-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>For non subscribe operations (publish, herenow, etc), This property relates to a read timeout that is applied from the moment the connection between a client and the server has been successfully established. It defines a maximum time of inactivity between two data packets when waiting for the server’s response. |
| [nonSubscribeRequestTimeout](non-subscribe-request-timeout.md) | [jvm]<br>open val [~~nonSubscribeRequestTimeout~~](non-subscribe-request-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>For non subscribe operations (publish, herenow, etc), This property relates to a read timeout that is applied from the moment the connection between a client and the server has been successfully established. It defines a maximum time of inactivity between two data packets when waiting for the server’s response. |
| [origin](origin.md) | [jvm]<br>abstract val [origin](origin.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)<br>Custom origin if needed. |
| [pnsdkSuffixes](pnsdk-suffixes.md) | [jvm]<br>abstract val [pnsdkSuffixes](pnsdk-suffixes.md): [Map](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-map/index.html)&lt;[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html), [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)&gt; |
| [presenceTimeout](presence-timeout.md) | [jvm]<br>abstract val [presenceTimeout](presence-timeout.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>Sets the custom presence server timeout. |
Expand Down
Loading

0 comments on commit ada2a6f

Please sign in to comment.