Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

Class and Description
com.crankuptheamps.client.Client.Version Do not use. Passing in an AMPS version is deprecated, so Version is deprecated.

Deprecated Fields

Field and Description
com.crankuptheamps.client.BlockPublishStore.AMPS_MIN_PUB_STORE_DISCARDED_VERSION Do not use. Constant is unused and will be removed in a future version.
com.crankuptheamps.client.Client.MIN_MULTI_BOOKMARK_VERSION Do not use. This constant references older server versions no longer supported by the client.
com.crankuptheamps.client.Client.MIN_PERSISTED_BOOKMARK_VERSION Do not use. This constant references older server versions no longer supported by the client.

Deprecated Methods

Method and Description
com.crankuptheamps.client.Client.flush() Use Client.publishFlush() instead. As of 5.3.0.0, this is a no-op.
com.crankuptheamps.client.Client.flush(long) Use Client.publishFlush(long) instead. As of 5.3.0.0, this is a no-op.
com.crankuptheamps.client.VersionInfo.getOldStyleVersion() Use VersionInfo.getVersion() instead.
com.crankuptheamps.client.BookmarkRingBuffer.getRecoveryEntries() Do not use. The notion of a separate "recovered bookmark" section within the ring buffer and the ability to re-log/re-order those entries into the main/active ring buffer section is an obsolete concept that hasn't been needed since the AMPS server stopped providing persisted acks for every message delivered on a replay (i.e. not needed since AMPS 4.0). The bookmark ring buffer has been simplified to remove this concept since a bug was discovered in it (AC-953).
com.crankuptheamps.client.Client.getServerVersion() Use Client.getServerVersionInfo() and VersionInfo.getVersion() instead. This function will be removed in a future version of the client. VersionInfo uses a new format and cannot be directly replaced.
com.crankuptheamps.client.Command.getSOWKey() Use Command.getSowKey() instead.
com.crankuptheamps.client.Command.getSOWKeys() Use Command.getSowKeys() instead.
com.crankuptheamps.client.Client.getVersionAsInt(String) Use VersionInfo.getVersion() instead. This function will be removed in a future version of the client. VersionInfo uses a new format and cannot be directly replaced.
com.crankuptheamps.client.BookmarkRingBuffer.Entry.isPersisted() Do not use. Currently always returns true.
com.crankuptheamps.client.BookmarkRingBuffer.persisted(BookmarkField) Do not use. Currently a no-op.
com.crankuptheamps.client.RingBookmarkStore.persisted(Field, long) Use RingBookmarkStore.persisted(Field, BookmarkField) instead.
com.crankuptheamps.client.MemoryBookmarkStore.persisted(Field, long) Use MemoryBookmarkStore.persisted(Field, BookmarkField) instead.
com.crankuptheamps.client.LoggedBookmarkStore.persisted(Field, long) Use LoggedBookmarkStore.persisted(Field, BookmarkField) instead.
com.crankuptheamps.client.BookmarkStore.persisted(Field, long) Use BookmarkStore.persisted(Field, BookmarkField) instead.
com.crankuptheamps.client.BookmarkRingBuffer.persisted(long) Do not use. Currently a no-op.
com.crankuptheamps.client.BookmarkRingBuffer.relog(long, BookmarkField) Do not use. The notion of a separate "recovered bookmark" section within the ring buffer and the ability to re-log/re-order those entries into the main/active ring buffer section is an obsolete concept that hasn't been needed since the AMPS server stopped providing persisted acks for every message delivered on a replay (i.e. not needed since AMPS 4.0). The bookmark ring buffer has been simplified to remove this concept since a bug was discovered in it (AC-953).
com.crankuptheamps.client.HAClient.setDisconnectHandler(ClientDisconnectHandler) Do not use. Not allowed on an HAClient as it removes automatic failover.
com.crankuptheamps.client.Client.setDisconnectHandler(ClientDisconnectHandler) Use HAClient for failover or ConnectionStateListener for state changes.
com.crankuptheamps.client.Subscription.setLastPersisted(long) Use Subscription.setLastPersisted(BookmarkField) instead.
com.crankuptheamps.client.RingBookmarkStore.Subscription.setLastPersisted(long) Use RingBookmarkStore.Subscription.setLastPersisted(BookmarkField) instead.
com.crankuptheamps.client.MemoryBookmarkStore.Subscription.setLastPersisted(long) Use MemoryBookmarkStore.Subscription.setLastPersisted(BookmarkField) instead.
com.crankuptheamps.client.LoggedBookmarkStore.Subscription.setLastPersisted(long) Use LoggedBookmarkStore.Subscription.setLastPersisted(BookmarkField) instead.
com.crankuptheamps.client.BookmarkRingBuffer.Entry.setPersisted(boolean) Do not use. Currently returns the Entry without making any changes.
com.crankuptheamps.client.BookmarkRingBuffer.setRecovery() Do not use. The notion of a separate "recovered bookmark" section within the ring buffer and the ability to re-log/re-order those entries into the main/active ring buffer section is an obsolete concept that hasn't been needed since the AMPS server stopped providing persisted acks for every message delivered on a replay (i.e. not needed since AMPS 4.0). The bookmark ring buffer has been simplified to remove this concept since a bug was discovered in it (AC-953).
com.crankuptheamps.client.Command.setSOWKey(String) Use Command.setSowKey(String) instead.
com.crankuptheamps.client.Command.setSOWKeys(String) Use Command.setSowKeys(String) instead.
com.crankuptheamps.client.Client.setUnhandledMessageHandler(MessageHandler) Use Client.setLastChanceMessageHandler(MessageHandler) instead.
com.crankuptheamps.client.Client.startTimer() Do not use. No longer supported by the AMPS server.
com.crankuptheamps.client.Client.stopTimer(MessageHandler) Do not use. No longer supported by the AMPS server.

Deprecated Constructors

Constructor and Description
com.crankuptheamps.client.Client(String, int) Use Client(String) instead. Passing in a version is deprecated.
com.crankuptheamps.client.Client(String, Transport, int) Use Client(String, Transport) instead. Passing in a version is deprecated.