# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Interfaces
Interface and Description
org.jgroups.ChannelFactory Might get removed in 3.0. Use your own method of injecting channels
org.jgroups.blocks.LockManager
org.jgroups.persistence.PersistenceManager

Deprecated Classes
Class and Description
org.jgroups.blocks.DistributedLockManager Succeessor is `LockService`.
org.jgroups.util.FIFOMessageQueue Will be removed together with the Multiplexer in 3.0
org.jgroups.JChannelFactory Might get removed in 3.0. Use your own method of injecting channels
org.jgroups.util.MarshallerPool
org.jgroups.mux.Multiplexer
org.jgroups.mux.MuxChannel
org.jgroups.blocks.NotificationBus Will be pulled in 3.0, use a JChannel directly instead
org.jgroups.persistence.PersistenceFactory
org.jgroups.blocks.PullPushAdapter Use `Receiver` instead, this class will be removed in JGroups 3.0
org.jgroups.protocols.SFC

Deprecated Fields
Field and Description
org.jgroups.blocks.RequestOptions.ASYNC
org.jgroups.Channel.AUTO_GETSTATE
org.jgroups.Channel.AUTO_RECONNECT
org.jgroups.Channel.BLOCK
org.jgroups.blocks.Request.GET_N
org.jgroups.Channel.GET_STATE_EVENTS
org.jgroups.stack.Protocol.name
org.jgroups.View.payload
org.jgroups.blocks.MethodCall.payload
org.jgroups.blocks.MethodCall.signature
org.jgroups.Channel.SUSPECT
org.jgroups.blocks.RequestOptions.SYNC
org.jgroups.Channel.VIEW

Deprecated Methods
Method and Description
org.jgroups.View.addPayload(String, Object) Will be removed in 3.0
org.jgroups.jmx.JmxConfigurator.asDynamicMBean(JChannel)
org.jgroups.jmx.JmxConfigurator.asDynamicMBean(Protocol)
org.jgroups.blocks.RpcDispatcher.callRemoteMethod(Address, MethodCall)
org.jgroups.blocks.RpcDispatcher.callRemoteMethod(Address, MethodCall, int, long)
org.jgroups.blocks.RpcDispatcher.callRemoteMethod(Address, MethodCall, int, long, boolean)
org.jgroups.blocks.RpcDispatcher.callRemoteMethod(Address, String, Object[], Class[], int, long)
org.jgroups.blocks.RpcDispatcher.callRemoteMethod(Address, String, Object[], String[], int, long)
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethods(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethodsWithFuture(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethodsWithFuture(Vector
org.jgroups.blocks.RpcDispatcher.callRemoteMethodWithFuture(Address, MethodCall)
org.jgroups.blocks.RpcDispatcher.callRemoteMethodWithFuture(Address, MethodCall, int, long, boolean)
org.jgroups.blocks.MessageDispatcher.castMessage(Vector, Message, int, long)
org.jgroups.blocks.MessageDispatcher.castMessage(Vector, Message, int, long, boolean)
org.jgroups.blocks.MessageDispatcher.castMessage(Vector, Message, int, long, boolean, RspFilter)
org.jgroups.blocks.MessageDispatcher.castMessageWithFuture(Vector, Message, int, long, boolean, RspFilter)
org.jgroups.ChannelListener.channelReconnected(Address)
org.jgroups.ChannelListener.channelShunned()
org.jgroups.stack.IpAddress.compare(IpAddress) Use `IpAddress.compareTo(org.jgroups.Address)` instead
org.jgroups.stack.IpAddress.compareToUnique(Object) Use `IpAddress.compareTo(org.jgroups.Address)` instead
org.jgroups.blocks.ReplicatedHashMap.contains(Object)
org.jgroups.JChannelFactory.createChannel(Object) `JChannel`'s conversion to type-specific construction, and the subsequent deprecation of its `JChannel(Object)` constructor, necessitate the deprecation of this factory method as well. Type-specific protocol stack configuration should be specfied during construction of an instance of this factory.
org.jgroups.JChannelFactory.createMultiplexerChannel(String, String) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.createMultiplexerChannel(String, String, boolean, String) Use a shared transport instead of the multiplexer
org.jgroups.stack.Protocol.downThreadEnabled() down thread was removed
org.jgroups.stack.ProtocolStack.dumpTimerQueue() Use `TP.getTimer()` instead to fetch the timer from the transport and then invoke the method on it
org.jgroups.util.RspList.elementAt(int) Use `RspList.entrySet()` or `RspList.values()` instead
org.jgroups.blocks.ReplicatedHashMap.elements()
org.jgroups.stack.ProtocolStack.flushEvents()
org.jgroups.blocks.MethodCall.get(Object)
org.jgroups.util.UUID.getAdditionalData() Will be removed in 3.0. This was only added to be backwards compatible with 2.7
org.jgroups.Channel.getAllStates(Vector, long) Not really needed - we always want to get the state from a single member
org.jgroups.JChannel.getAllStates(Vector, long) Not really needed - we always want to get the state from a single member, use `JChannel.getState(org.jgroups.Address, long)` instead
org.jgroups.mux.Multiplexer.getApplicationIds() Use ${link #getServiceIds()} instead
org.jgroups.protocols.TP.getBindToAllInterfaces() Use `TP.isReceiveOnAllInterfaces()` instead
org.jgroups.Channel.getChannelName() Use `Channel.getClusterName()` instead
org.jgroups.JChannel.getChannelName() Use `JChannel.getClusterName()` instead
org.jgroups.blocks.MessageDispatcher.getConcurrentProcessing()
org.jgroups.blocks.MessageDispatcher.getDeadlockDetection()
org.jgroups.protocols.pbcast.NAKACK.getGcLag()
org.jgroups.stack.GossipRouter.getGossipRequestTimeout()
org.jgroups.protocols.pbcast.GMS.getJoinRetryTimeout()
org.jgroups.Channel.getLocalAddress() Use `Channel.getAddress()` instead
org.jgroups.JChannel.getLocalAddress()
org.jgroups.protocols.pbcast.NAKACK.getMaxXmitBufSize()
org.jgroups.stack.NakReceiverWindow.getMaxXmitBufSize()
org.jgroups.protocols.pbcast.NAKACK.getMaxXmitSize() removed in 2.6
org.jgroups.JChannelFactory.getMultiplexerConfig() Use a shared transport instead of the multiplexer
org.jgroups.protocols.FRAG2.getOverhead() overhead was removed in 2.6.10
org.jgroups.View.getPayload(String) Will be removed in 3.0
org.jgroups.stack.Protocol.getProperties() Use a getter to get the actual instance variable
org.jgroups.protocols.TUNNEL.getRouterHost()
org.jgroups.protocols.TUNNEL.getRouterPort()
org.jgroups.stack.GossipRouter.getRoutingClientReplyTimeout()
org.jgroups.protocols.TP.getSendInterfaces() This property was removed in 2.7
org.jgroups.conf.ConfiguratorFactory.getStackConfigurator(Object) Used by the JChannel(Object) constructor which has been deprecated.
org.jgroups.stack.ProtocolStack.getThreadFactory() Use `Protocol.getThreadFactory()` instead
org.jgroups.stack.ProtocolStack.getTimerThreadFactory()
org.jgroups.stack.ProtocolStack.getTimerThreads() Use `TP.getTimer()` to fetch the timer and call getCorePoolSize() directly
org.jgroups.protocols.UNICAST.getUndeliveredMessages()
org.jgroups.protocols.pbcast.NAKACK.getUndeliveredMessages()
org.jgroups.JChannelFactory.hasMuxChannel(String, String) Use a shared transport instead of the multiplexer
org.jgroups.protocols.TP.isSendOnAllInterfaces() This property was removed in 2.7
org.jgroups.protocols.FD.isShun()
org.jgroups.protocols.FD_ALL.isShun()
org.jgroups.protocols.pbcast.GMS.isShun()
org.jgroups.protocols.TP.isUseIncomingPacketHandler() With the concurrent stack being the default, this property is ignored
org.jgroups.blocks.ReplicatedHashMap.keys()
org.jgroups.JChannel.open() With the removal of shunning, this method should not be used anymore
org.jgroups.Channel.peek(long) Use a `Receiver` instead, this method will not be available in JGroups 3.0
org.jgroups.util.AckCollector.printReceived()
org.jgroups.blocks.MethodCall.put(Object, Object)
org.jgroups.Channel.receive(long) Use a `Receiver` instead
org.jgroups.JChannel.receive(long) Use a `Receiver` instead
org.jgroups.util.AckCollector.receivedAcks()
org.jgroups.Message.removeHeader(short) Use getHeader() instead. The issue with removing a header is described in http://jira.jboss.com/jira/browse/JGRP-393
org.jgroups.util.Headers.removeHeader(short) Use getHeader() instead. The issue with removing a header is described in http://jira.jboss.com/jira/browse/JGRP-393
org.jgroups.View.removePayload(String) Will be removed in 3.0
org.jgroups.util.RspList.reset() Use `RspList.clear()` instead
org.jgroups.blocks.RequestOptions.seal() Will get removed together with SYNC and ASYNC in 3.0
org.jgroups.blocks.MessageDispatcher.send(Message)
org.jgroups.blocks.MessageDispatcher.sendMessage(Message, int, long) Use `MessageDispatcher.sendMessage(org.jgroups.Message, RequestOptions)` instead
org.jgroups.blocks.MessageDispatcher.sendMessageWithFuture(Message, int, long)
org.jgroups.blocks.RequestCorrelator.sendRequest(long, Message, RspCollector)
org.jgroups.util.UUID.setAdditionalData(byte[]) Will be removed in 3.0. This was only added to be backwards compatible with 2.7
org.jgroups.Event.setArg(Object)
org.jgroups.Channel.setChannelListener(ChannelListener) Use addChannelListener() instead
org.jgroups.blocks.MessageDispatcher.setConcurrentProcessing(boolean)
org.jgroups.blocks.RequestCorrelator.setConcurrentProcessing(boolean) Not needed since the introduction of the concurrent stack
org.jgroups.blocks.MessageDispatcher.setDeadlockDetection(boolean)
org.jgroups.blocks.RequestCorrelator.setDeadlockDetection(boolean) deadlock detection is not needed with a concurrent stack
org.jgroups.stack.NakReceiverWindow.setDiscardDeliveredMessages(boolean)
org.jgroups.protocols.pbcast.NAKACK.setGcLag(int)
org.jgroups.stack.GossipRouter.setGossipRequestTimeout(long)
org.jgroups.protocols.pbcast.GMS.setJoinRetryTimeout(long)
org.jgroups.protocols.pbcast.NAKACK.setMaxXmitBufSize(int)
org.jgroups.stack.NakReceiverWindow.setMaxXmitBufSize(int)
org.jgroups.protocols.pbcast.NAKACK.setMaxXmitSize(long) removed in 2.6
org.jgroups.blocks.PullPushAdapter.setMembershipListener(MembershipListener) Use `PullPushAdapter.addMembershipListener(org.jgroups.MembershipListener)`
org.jgroups.JChannelFactory.setMultiplexerConfig(Element) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(Element, boolean) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(File) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(File, boolean) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(Object) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(Object, boolean) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(String) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(String, boolean) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(URL) Use a shared transport instead of the multiplexer
org.jgroups.JChannelFactory.setMultiplexerConfig(URL, boolean) Use a shared transport instead of the multiplexer
org.jgroups.protocols.FRAG2.setOverhead(int) overhead was removed in 2.6.10
org.jgroups.stack.Protocol.setProperties(Properties) The properties are now set through the @Property annotation on the attribute or setter
org.jgroups.stack.Protocol.setPropertiesInternal(Properties) Use a setter instead
org.jgroups.stack.Protocol.setProperty(String, String) Use the corresponding setter instead
org.jgroups.protocols.TUNNEL.setRouterHost(String)
org.jgroups.protocols.TUNNEL.setRouterPort(int)
org.jgroups.stack.GossipRouter.setRoutingClientReplyTimeout(long)
org.jgroups.protocols.FD.setShun(boolean)
org.jgroups.protocols.FD_ALL.setShun(boolean)
org.jgroups.protocols.pbcast.GMS.setShun(boolean)
org.jgroups.stack.ProtocolStack.setThreadFactory(ThreadFactory) Use `Protocol.getThreadFactory()` instead
org.jgroups.stack.ProtocolStack.setTimerThreadFactory(ThreadFactory) Use `TP.setTimerThreadFactory(org.jgroups.util.ThreadFactory)` instead
org.jgroups.Event.setType(int) in order to make an Event immutable
org.jgroups.protocols.TP.setUseConcurrentStack(boolean) the concurrent stack is used by default
org.jgroups.Channel.shutdown()
org.jgroups.JChannel.shutdown() Use `Util.shutdown(Channel)` instead. This method will be removed in 3.0
org.jgroups.util.ExposedByteArrayOutputStream.toString(int) This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via the `toString(String enc)` method, which takes an encoding-name argument, or the `toString()` method, which uses the platform's default character encoding.
org.jgroups.stack.Protocol.upThreadEnabled() up_thread was removed

Deprecated Constructors
Constructor and Description
org.jgroups.JChannel(Object) Use the constructors with specific parameter types instead.
org.jgroups.blocks.MessageDispatcher(Channel, MessageListener, MembershipListener, boolean)
org.jgroups.blocks.MessageDispatcher(Channel, MessageListener, MembershipListener, boolean, boolean)
org.jgroups.blocks.MessageDispatcher(Channel, MessageListener, MembershipListener, RequestHandler, boolean)
org.jgroups.blocks.MessageDispatcher(Channel, MessageListener, MembershipListener, RequestHandler, boolean, boolean)
org.jgroups.blocks.MessageDispatcher(PullPushAdapter, Serializable, MessageListener, MembershipListener)
org.jgroups.blocks.MessageDispatcher(PullPushAdapter, Serializable, MessageListener, MembershipListener, RequestHandler)
org.jgroups.blocks.MessageDispatcher(PullPushAdapter, Serializable, MessageListener, MembershipListener, RequestHandler, boolean)
org.jgroups.blocks.MethodCall(String, Object...)
org.jgroups.blocks.MethodCall(String, Object[], String[])
org.jgroups.blocks.Request(Message, RequestCorrelator, Transport, RspFilter, int, long)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, Address)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, Address, boolean)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, boolean)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, boolean, Address)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, boolean, Address, boolean)
org.jgroups.blocks.RequestCorrelator(String, Object, RequestHandler, boolean, boolean)
org.jgroups.blocks.RpcDispatcher(Channel, MessageListener, MembershipListener, Object, boolean)
org.jgroups.blocks.RpcDispatcher(Channel, MessageListener, MembershipListener, Object, boolean, boolean)
org.jgroups.blocks.RpcDispatcher(PullPushAdapter, Serializable, MessageListener, MembershipListener, Object)