Deprecated List (Solace JMS API v10.10.2)

Deprecated Interfaces
Interface and Description
com.solacesystems.jcsmpx.impl.DestinationManager This interface is deprecated and will be removed in a future release.
com.solacesystems.jcsmp.DestinationSubscriptionStateProvider `DestinationSubscriptionStateProvider` is no longer supported, and its use has no effect.
com.solacesystems.common.expect.ExpectConfig
com.solacesystems.jms.SolEventListener This interface has been replaced by `SolConsumerEventListener`, which is simpler to use and uses a more traditional object-oriented approach.
com.solacesystems.jms.SolEventSource `SolConsumerEventSource` largely implements the same concepts provided by this class. It makes use of `SolConsumerEventListener` which replaced `SolEventListener`.
com.solacesystems.jcsmp.StreamXMLMessage Use of message types other than `BytesXMLMessage` is deprecated.
com.solacesystems.jcsmp.SubscriptionStateProvider SubscriptionStateProvider is no longer supported and its use has no effect.
com.solacesystems.jcsmp.TextXMLMessage Use of message types other than `BytesXMLMessage` is deprecated.

Deprecated Classes
Class and Description
com.solacesystems.jms.impl.ConnectionFactoryProperties
com.solacesystems.jcsmp.DestinationSubscriptionState `DestinationSubscriptionState` is no longer supported and its use has no effect.
com.solacesystems.common.expect.ExpectConfigMgr
com.solacesystems.jms.impl.JNDIConnectionProperties
com.solacesystems.jcsmp.MessageType Replaced by `DeliveryMode`.
com.solacesystems.jcsmp.secure.SecureSessionProperties
com.solacesystems.jcsmp.SubscriptionState SubscriptionState is no longer supported and its use has no effect.

Deprecated Enums
Enum and Description

com.solacesystems.jcsmp.JCSMPErrorResponseSubcode
Replaced by JCSMPErrorResponseSubcodeEx

Deprecated Enums
Enum and Description
com.solacesystems.jcsmp.JCSMPErrorResponseSubcode Replaced by `JCSMPErrorResponseSubcodeEx`

Deprecated Exceptions
Exceptions and Description
com.solacesystems.jcsmp.SubscriptionsOutOfSynchException This class is no longer supported and will be removed in a future release.

Deprecated Fields
Field and Description
com.solacesystems.jcsmp.JCSMPProperties.CLIENT_MODE
com.solacesystems.jcsmp.JCSMPProperties.CONTROL_CHANNEL_PROPERTIES These channel properties are deprecated in favor of `JCSMPProperties.CLIENT_CHANNEL_PROPERTIES`. If the default settings for CLIENT_CHANNEL_PROPERTIES are modified in any way, they override these legacy channel properties.
com.solacesystems.jcsmp.JCSMPProperties.MAX_RESENDS
com.solacesystems.jcsmp.JCSMPProperties.PUBLISHER_DATA_CHANNEL_PROPERTIES These channel properties are deprecated in favor of `JCSMPProperties.CLIENT_CHANNEL_PROPERTIES`. If the default settings for CLIENT_CHANNEL_PROPERTIES are modified in any way, they override these legacy channel properties.
com.solacesystems.jcsmp.JCSMPProperties.SECURE_PROPS
com.solacesystems.jms.SupportedProperty.SOLACE_JMS_SSL_PROTOCOL
com.solacesystems.jcsmp.JCSMPProperties.SSL_PROTOCOL
com.solacesystems.jcsmp.JCSMPProperties.SUBSCRIBER_DATA_CHANNEL_PROPERTIES These channel properties are deprecated in favor of `JCSMPProperties.CLIENT_CHANNEL_PROPERTIES`. If the default settings for CLIENT_CHANNEL_PROPERTIES are modified in any way, they override these legacy channel properties.
com.solacesystems.jcsmp.JCSMPProperties.SUBSCRIBER_LOCAL_PRIORITY
com.solacesystems.jcsmp.JCSMPProperties.SUBSCRIBER_NETWORK_PRIORITY

Deprecated Methods
Method and Description
com.solacesystems.jcsmp.Session.addSubscriber() It is no longer necessary to call this function. This function might be removed in a future version of JCSMP.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.addSubscriber()
com.solacesystems.jcsmp.Session.clearSubscriber() This method is no longer supported. The recommended way to delete subscriptions from the appliance is to perform an `applySubscriptions()` on the session with an empty subscription list.
com.solacesystems.jms.impl.MessageProducerAdapterFactory.createMessageProducerAdapter(SessionProperties)
com.solacesystems.jcsmp.JCSMPFactory.createQueue(String, String) Use `JCSMPFactory.createQueue(String)`.
com.solacesystems.jcsmp.Producer.createStreamXMLMessage()
com.solacesystems.jcsmp.Producer.createStreamXMLMessage(InputStream)
com.solacesystems.jcsmp.Producer.createTextXMLMessage()
com.solacesystems.jcsmp.Producer.createTextXMLMessage(String)
com.solacesystems.jcsmp.JCSMPFactory.createTopicDestination(String)
com.solacesystems.jcsmp.XMLMessage.getAppMessageID() Renamed to `XMLMessage.getApplicationMessageId()`.
com.solacesystems.jcsmp.XMLMessage.getAppMessageType() Renamed to `XMLMessage.getApplicationMessageType()`.
com.solacesystems.jcsmp.XMLMessage.getDeliverToOne()
com.solacesystems.jcsmp.JCSMPErrorResponseSubcodeEx.getDescription(int) This method is no longer supported, and its use is discouraged. Refer to API documentation for explanations of these error subcodes.
com.solacesystems.jcsmp.DestinationUtils.getEncodedName(Destination) See `DestinationUtils.getNetworkName(Destination)`.
com.solacesystems.jcsmp.secure.SecureSessionProperties.getJCSMPSecureProtocolFactory()
com.solacesystems.jcsmp.protocol.smf.SimpleSmfClient.getJcsmpSecureProtocolSocketFactory()
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer() Please see `JCSMPSession.getMessageConsumer(XMLMessageListener)`.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer()
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(JCSMPReconnectEventHandler) Please see `JCSMPSession.getMessageConsumer(JCSMPReconnectEventHandler, XMLMessageListener)`.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer(JCSMPReconnectEventHandler)
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider) Please see `JCSMPSession.getMessageConsumer(SubscriptionStateProvider, XMLMessageListener)`.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer(SubscriptionStateProvider)
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler) Please see `JCSMPSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler, XMLMessageListener)`.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler)
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler, XMLMessageListener) Subscriptions out-of-sync checking is no longer supported. This method will be removed in a future version.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler, XMLMessageListener)
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider, XMLMessageListener) Subscriptions out-of-sync checking is no longer supported. This method will be removed in a future version.
com.solacesystems.jcsmp.impl.JCSMPBasicSession.getMessageConsumer(SubscriptionStateProvider, XMLMessageListener)
com.solacesystems.jcsmp.JCSMPSession.getMessageProducer() Please see `JCSMPSession.getMessageProducer(JCSMPStreamingPublishEventHandler)`. Note that using this deprecated method can introduce a performance penalty during a streaming publishing Session because it forces the appliance to transmit acknowledgements to every message. Using the recommended `JCSMPSession.getMessageProducer(JCSMPStreamingPublishEventHandler)` form eliminates this problem.
com.solacesystems.jcsmp.XMLMessage.getMessageType() See `XMLMessage.getDeliveryMode()`. Gets the type of the message. Valid types are enumerated in `MessageType`: `MessageType.NON_PERSISTENT` `MessageType.PERSISTENT` `MessageType.DIRECT` (default)
com.solacesystems.jms.SolConnectionFactory.getSendADMaxResends()
com.solacesystems.jcsmp.XMLMessage.getSenderID() Renamed to `XMLMessage.getSenderId()`.
com.solacesystems.jcsmp.XMLMessage.getSendTimestamp() Renamed to `XMLMessage.getSenderTimestamp()`.
com.solacesystems.jcsmp.JCSMPChannelProperties.getSmfPort() Use of this setting is discouraged, the recommended way of selecting ports is through the "Host:Port" syntax of the `JCSMPProperties.HOST` property.
com.solacesystems.jcsmp.secure.SecureSessionProperties.getSSLContext()
com.solacesystems.jcsmp.Producer.getStreamingCallbackHandler()
com.solacesystems.jcsmp.JCSMPErrorResponseException.getSubcode() use `JCSMPErrorResponseException.getSubcodeEx()`.
com.solacesystems.jcsmp.JCSMPRuntime.getSupportedMaxNumOfXpesInOneRequest()
com.solacesystems.jcsmp.JCSMPStreamingPublishEventHandler.handleError(String, JCSMPException, long) This method is invoked during streaming publishing if there is an error in reading the response, or if a non-OK response is read. Note: Handler processing should be kept to a minimum because it blocks the thread from which the error originated. Error responses from the appliance If an error response is available, it is represented as a `JCSMPErrorResponseException`. The subcodes discussed in `JCSMPStreamingPublishCorrelatingEventHandler` might be present to provide further information about why the message was rejected.
com.solacesystems.jcsmp.Topic.isRxAllDeliverToOne()
com.solacesystems.jcsmp.TopicProperties.isRxAllDeliverToOne()
com.solacesystems.jcsmp.JCSMPChannelProperties.isSecureChannel()
com.solacesystems.common.util.DestinationUtil.normalizeDestination(String)
com.solacesystems.jcsmp.DestinationUtils.queueFromEncodedName(String) See `DestinationUtils.queueFromNetworkName(String)`.
com.solacesystems.jcsmp.BytesXMLMessage.readBytes(byte[]) As of release 4.5, use `XMLMessage.readContentBytes(int, byte[], int, int)`. This function used a read pointer stored in the message and therefore was not thread-safe when called by consumers of the message.
com.solacesystems.jcsmp.BytesXMLMessage.readBytes(byte[], int) As of release 4.5, use `XMLMessage.readContentBytes(int, byte[], int, int)`. This function used a read pointer stored in the message and therefore was not thread-safe when called by consumers of the message.
com.solacesystems.jcsmp.XMLMessage.rejectMessage() As of version 4.0, rejectMessage has no separate effect from ackMessage. Applications should avoid using this method as it will be removed in a future release.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.rejectMessage()
com.solacesystems.jcsmp.Session.removeSubscriber() Subscribers are now created and removed only through the appliance's management interface. This method has the same effect as `Session.clearSubscriber()`
com.solacesystems.jcsmp.impl.JCSMPBasicSession.removeSubscriber()
com.solacesystems.jcsmp.JCSMPStreamingPublishEventHandler.responseReceived(String) This method is invoked whenever an OK response is received. When publishing `PERSISTENT` and `NON_PERSISTENT` messages, the `messageID` is passed as an argument to this callback when an acknowledgement is received. Note: This method is not invoked for `DIRECT` messages because they do not receive acknowledgements.
com.solacesystems.jcsmp.XMLMessage.rewindAttachment() This method no longer has any effect.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.rewindAttachment()
com.solacesystems.jcsmp.BytesXMLMessage.rewindContent() As of release 4.5, use `XMLMessage.readContentBytes(int, byte[], int, int)`. This function used a read pointer stored in the message and therefore was not thread-safe when called by consumers of the message.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.rewindMetadata()
com.solacesystems.jcsmp.XMLMessageProducer.send(XMLMessage)
com.solacesystems.jcsmp.XMLMessage.setAppMessageID(String) Renamed to `XMLMessage.setApplicationMessageId(String)`.
com.solacesystems.jcsmp.XMLMessage.setAppMessageType(String) Renamed to `XMLMessage.setApplicationMessageType(String)`.
com.solacesystems.jcsmp.XMLMessage.setDeliverToOne(boolean)
com.solacesystems.jcsmp.protocol.smf.SimpleSmfClient.setJcsmpSecureProtocolSocketFactory(JCSMPSecureProtocolSocketFactory)
com.solacesystems.jcsmp.XMLMessageConsumer.setMessageListener(XMLMessageListener) As of release 4.1, please provide an `XMLMessageListener` when acquiring an `XMLMessageConsumer` from a session. This method is deprecated and provided for backwards-compatibility; if using it, note that it must be called immediately after acquiring the `XMLMessageConsumer`, before it is started, and it may only be called once. Failure to respect these conditions will result in an `IllegalStateException` being thrown.
com.solacesystems.jcsmp.XMLMessage.setMessageType(MessageType) See `XMLMessage.setDeliveryMode(DeliveryMode)`. Sets the type of the message. Valid types are enumerated in `MessageType`: `MessageType.NON_PERSISTENT` `MessageType.PERSISTENT` `MessageType.DIRECT` (default)
com.solacesystems.jcsmp.TopicProperties.setRxAllDeliverToOne(boolean)
com.solacesystems.jms.SolConnectionFactoryImpl.setSendADMaxResends(Integer)
com.solacesystems.jms.SolConnectionFactory.setSendADMaxResends(Integer)
com.solacesystems.jcsmp.XMLMessage.setSenderID(String) Renamed to `XMLMessage.setSenderId(String)`.
com.solacesystems.jcsmp.XMLMessage.setSendTimestamp(long) Renamed to `XMLMessage.setSenderTimestamp(long)`.
com.solacesystems.jcsmp.JCSMPChannelProperties.setSmfPort(int) Use of this setting is discouraged, the recommended way of selecting ports is through the "Host:Port" syntax of the `JCSMPProperties.HOST` property.
com.solacesystems.jcsmp.XMLMessageProducer.setStreamingCallbackHandler(JCSMPStreamingPublishEventHandler) As of release 4.1, please provide an `JCSMPStreamingPublishEventHandler` when acquiring an `XMLMessageProducer` from a session. This method is deprecated and has no effect.
com.solacesystems.jcsmp.DestinationUtils.topicFromEncodedName(String) See `DestinationUtils.topicFromNetworkName(String)`.
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(byte[]) Use `XMLMessage.writeAttachment(byte[])` instead
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.writeNewAttachment(byte[]) Use `JCSMPXMLMessage.writeAttachment(byte[])` instead
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(byte[], int, int) Use `XMLMessage.writeAttachment(byte[],int,int)` instead.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.writeNewAttachment(byte[], int, int) Use `JCSMPXMLMessage.writeAttachment(byte[],int,int)` instead
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(InputStream) Use `XMLMessage.writeAttachment(InputStream)` instead.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.writeNewAttachment(InputStream) Use `JCSMPXMLMessage.writeAttachment(InputStream)` instead
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(InputStream, int, int) Use `XMLMessage.writeAttachment(InputStream)` instead.
com.solacesystems.jcsmp.impl.JCSMPXMLMessage.writeNewAttachment(InputStream, int, int)

Deprecated Constructors
Constructor and Description
com.solacesystems.jms.impl.DefaultMessageProducerAdapter(SessionProperties, boolean)
com.solacesystems.jms.impl.FlowMessageProducerAdapter(SessionProperties)
com.solacesystems.jcsmp.secure.SecureSessionProperties(JCSMPSecureProtocolSocketFactory)
com.solacesystems.jcsmp.secure.SecureSessionProperties(URL, String)
com.solacesystems.jms.impl.TransactedMessageProducerAdapter(SessionProperties)
com.solacesystems.jms.impl.XAMessageProducerAdapter(SessionProperties)

Deprecated Enum Constants
Enum Constant and Description
com.solacesystems.jcsmp.CapabilityType.FLOW_CHANGE_UPDATES Use `CapabilityType.ACTIVE_FLOW_INDICATION` Peer supports Flow Change Updates.

Deprecated API

Contents

Error responses from the appliance