Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
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.jcsmp.MessageType Replaced by DeliveryMode.
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 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.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.

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.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.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.XMLMessage.getAppMessageID() Renamed to XMLMessage.getApplicationMessageId().
com.solacesystems.jcsmp.XMLMessage.getAppMessageType() Renamed to XMLMessage.getApplicationMessageType().
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.JCSMPSession.getMessageConsumer() Please see JCSMPSession.getMessageConsumer(XMLMessageListener).
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(JCSMPReconnectEventHandler) Please see JCSMPSession.getMessageConsumer(JCSMPReconnectEventHandler, XMLMessageListener).
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider) Please see JCSMPSession.getMessageConsumer(SubscriptionStateProvider, XMLMessageListener).
com.solacesystems.jcsmp.JCSMPSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler) Please see JCSMPSession.getMessageConsumer(SubscriptionStateProvider, JCSMPReconnectEventHandler, XMLMessageListener).
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.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.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.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.Producer.getStreamingCallbackHandler()
com.solacesystems.jcsmp.JCSMPErrorResponseException.getSubcode() use JCSMPErrorResponseException.getSubcodeEx().
com.solacesystems.jcsmp.JCSMPRuntime.getSupportedMaxNumOfXpesInOneRequest()
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.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.XMLMessage.rewindAttachment() This method no longer has any effect.
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.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.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.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.XMLMessage.writeNewAttachment(byte[], int, int) Use XMLMessage.writeAttachment(byte[],int,int) instead.
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(InputStream) Use XMLMessage.writeAttachment(InputStream) instead.
com.solacesystems.jcsmp.XMLMessage.writeNewAttachment(InputStream, int, int) Use XMLMessage.writeAttachment(InputStream) instead.

Deprecated Enum Constants

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