# 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.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.Channel.getAllStates(Vector, long) Not really needed - we always want to get the state from a single member
  org.jgroups.mux.Multiplexer.getApplicationIds() Use ${link #getServiceIds()} instead
  org.jgroups.protocols.TP.getBindToAllInterfaces() Use `TP.isReceiveOnAllInterfaces()` instead
  org.jgroups.JChannel.getChannelName() Use `JChannel.getClusterName()` instead
  org.jgroups.Channel.getChannelName() Use `Channel.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.JChannel.getLocalAddress()
  org.jgroups.Channel.getLocalAddress() Use `Channel.getAddress()` instead
  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_ALL.isShun()
  org.jgroups.protocols.FD.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.JChannel.receive(long) Use a `Receiver` instead
  org.jgroups.Channel.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_ALL.setShun(boolean)
  org.jgroups.protocols.FD.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.JChannel.shutdown() Use `Util.shutdown(Channel)` instead. This method will be removed in 3.0
  org.jgroups.Channel.shutdown()
  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)

Copyright © 1998-2009 Bela Ban / Red Hat. All Rights Reserved.