Deprecated API

Contents

• Terminally Deprecated
• Classes
• Fields
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
org.freedesktop.dbus.connections.AbstractConnection.changeThreadCount(byte)	does nothing as threading has been changed significantly
org.freedesktop.dbus.connections.AbstractConnection.TCP_ADDRESS_PROPERTY	is no longer in use
org.freedesktop.dbus.connections.AbstractConnection.TCP_CONNECT_TIMEOUT	no longer used
org.freedesktop.dbus.connections.BusAddress(String)	Use BusAddress.of instead
org.freedesktop.dbus.connections.BusAddress.getParameters()	will be removed in future, use BusAddress.getParameterValue(String) or BusAddress.hasParameter(String)
org.freedesktop.dbus.connections.BusAddress.getRawAddress()	use BusAddress.toString()
org.freedesktop.dbus.connections.config.SaslConfig.create()	only intended for internal backward compatibility, will be removed soon
org.freedesktop.dbus.connections.config.TransportConfigBuilder.withSaslAuthMode(TransportBuilder.SaslAuthMode)	use TransportConfigBuilder.configureSasl() instead
org.freedesktop.dbus.connections.config.TransportConfigBuilder.withSaslUid(long)	use TransportConfigBuilder.configureSasl() instead
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withErrorHandlerThreadCount(int)	use receivingThreadConfig().withErrorHandlerThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withMethodCallThreadCount(int)	use receivingThreadConfig().withMethodCallThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withMethodReturnThreadCount(int)	use receivingThreadConfig().withMethodReturnThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withSignalThreadCount(int)	use receivingThreadConfig().withSignalThreadCount(_threads)
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String, boolean, boolean)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String, boolean, boolean, int)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(DBusConnection.DBusBusType)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(DBusConnection.DBusBusType, boolean, int)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.newConnection(DBusConnection.DBusBusType)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.setDbusMachineIdFile(String)	no longer required when DBusConnectionBuilder is used
org.freedesktop.dbus.connections.impl.DBusConnectionBuilder.getSystemEndianness()	if required, use BaseConnectionBuilder.getSystemEndianness()
org.freedesktop.dbus.connections.impl.DirectConnection(String)	use DirectConnectionBuilder
org.freedesktop.dbus.connections.impl.DirectConnection(String, int)	use DirectConnectionBuilder
org.freedesktop.dbus.connections.impl.DirectConnectionBuilder.getSystemEndianness()	if required, use BaseConnectionBuilder.getSystemEndianness()
org.freedesktop.dbus.connections.SASL()	should not be used as SASL configuration is not provided
org.freedesktop.dbus.connections.transports.AbstractTransport.getSaslAuthMode()	please use AbstractTransport.getSaslConfig().getAuthMode() instead
org.freedesktop.dbus.connections.transports.AbstractTransport.getSaslMode()	please use AbstractTransport.getSaslConfig().getMode() instead
org.freedesktop.dbus.connections.transports.AbstractTransport.isAbstractAllowed()	Is no longer used and will be removed
org.freedesktop.dbus.connections.transports.AbstractTransport.setSaslAuthMode(int)	please use AbstractTransport.getSaslConfig().setSaslAuthMode(int) instead
org.freedesktop.dbus.connections.transports.AbstractTransport.setSaslMode(SASL.SaslMode)	please use AbstractTransport.getSaslConfig().setMode(int) instead
org.freedesktop.dbus.connections.transports.TransportBuilder.isListening(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.listening(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withAutoConnect(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withSaslAuthMode(TransportBuilder.SaslAuthMode)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withTimeout(int)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFileGroup(String)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFileOwner(String)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFilePermissions(PosixFilePermission...)	please use TransportBuilder.configure()
org.freedesktop.dbus.messages.Message.getHeaders()	use getHeader(). This method did return a map containing message header. It allows changing the map, but changes did not result in changing the actual message header. Therefore using a map was removed and an object array is used instead. Changes to that array (content) will be result in a changed header in the message.
org.freedesktop.dbus.SignalTuple	this class was used as map key internally and is no longer in use
org.freedesktop.dbus.spi.transport.ITransportProvider.createTransport(BusAddress, int)	just used for compatibility will be removed in the future. Please use ITransportProvider.createTransport(BusAddress, TransportConfig).
org.freedesktop.dbus.utils.AddressBuilder.DBUS_SESSION_BUS_ADDRESS	Constant has been moved to DBusSysProps.
org.freedesktop.dbus.utils.AddressBuilder.DBUS_SYSTEM_BUS_ADDRESS	Constant has been moved to DBusSysProps.
org.freedesktop.dbus.utils.AddressBuilder.DEFAULT_SYSTEM_BUS_ADDRESS	Constant has been moved to DBusSysProps.

Deprecated Classes

Class	Description
org.freedesktop.dbus.SignalTuple	this class was used as map key internally and is no longer in use

Deprecated Fields

Field	Description
org.freedesktop.dbus.connections.AbstractConnection.TCP_ADDRESS_PROPERTY	is no longer in use
org.freedesktop.dbus.connections.AbstractConnection.TCP_CONNECT_TIMEOUT	no longer used
org.freedesktop.dbus.utils.AddressBuilder.DBUS_SESSION_BUS_ADDRESS	Constant has been moved to DBusSysProps.
org.freedesktop.dbus.utils.AddressBuilder.DBUS_SYSTEM_BUS_ADDRESS	Constant has been moved to DBusSysProps.
org.freedesktop.dbus.utils.AddressBuilder.DEFAULT_SYSTEM_BUS_ADDRESS	Constant has been moved to DBusSysProps.

Deprecated Methods

Method	Description
org.freedesktop.dbus.connections.AbstractConnection.changeThreadCount(byte)	does nothing as threading has been changed significantly
org.freedesktop.dbus.connections.BusAddress.getParameters()	will be removed in future, use BusAddress.getParameterValue(String) or BusAddress.hasParameter(String)
org.freedesktop.dbus.connections.BusAddress.getRawAddress()	use BusAddress.toString()
org.freedesktop.dbus.connections.config.SaslConfig.create()	only intended for internal backward compatibility, will be removed soon
org.freedesktop.dbus.connections.config.TransportConfigBuilder.withSaslAuthMode(TransportBuilder.SaslAuthMode)	use TransportConfigBuilder.configureSasl() instead
org.freedesktop.dbus.connections.config.TransportConfigBuilder.withSaslUid(long)	use TransportConfigBuilder.configureSasl() instead
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withErrorHandlerThreadCount(int)	use receivingThreadConfig().withErrorHandlerThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withMethodCallThreadCount(int)	use receivingThreadConfig().withMethodCallThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withMethodReturnThreadCount(int)	use receivingThreadConfig().withMethodReturnThreadCount(_threads)
org.freedesktop.dbus.connections.impl.BaseConnectionBuilder.withSignalThreadCount(int)	use receivingThreadConfig().withSignalThreadCount(_threads)
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String, boolean, boolean)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(String, boolean, boolean, int)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(DBusConnection.DBusBusType)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.getConnection(DBusConnection.DBusBusType, boolean, int)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.newConnection(DBusConnection.DBusBusType)	use DBusConnectionBuilder
org.freedesktop.dbus.connections.impl.DBusConnection.setDbusMachineIdFile(String)	no longer required when DBusConnectionBuilder is used
org.freedesktop.dbus.connections.impl.DBusConnectionBuilder.getSystemEndianness()	if required, use BaseConnectionBuilder.getSystemEndianness()
org.freedesktop.dbus.connections.impl.DirectConnectionBuilder.getSystemEndianness()	if required, use BaseConnectionBuilder.getSystemEndianness()
org.freedesktop.dbus.connections.transports.AbstractTransport.getSaslAuthMode()	please use AbstractTransport.getSaslConfig().getAuthMode() instead
org.freedesktop.dbus.connections.transports.AbstractTransport.getSaslMode()	please use AbstractTransport.getSaslConfig().getMode() instead
org.freedesktop.dbus.connections.transports.AbstractTransport.isAbstractAllowed()	Is no longer used and will be removed
org.freedesktop.dbus.connections.transports.AbstractTransport.setSaslAuthMode(int)	please use AbstractTransport.getSaslConfig().setSaslAuthMode(int) instead
org.freedesktop.dbus.connections.transports.AbstractTransport.setSaslMode(SASL.SaslMode)	please use AbstractTransport.getSaslConfig().setMode(int) instead
org.freedesktop.dbus.connections.transports.TransportBuilder.isListening(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.listening(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withAutoConnect(boolean)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withSaslAuthMode(TransportBuilder.SaslAuthMode)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withTimeout(int)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFileGroup(String)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFileOwner(String)	please use TransportBuilder.configure()
org.freedesktop.dbus.connections.transports.TransportBuilder.withUnixSocketFilePermissions(PosixFilePermission...)	please use TransportBuilder.configure()
org.freedesktop.dbus.messages.Message.getHeaders()	use getHeader(). This method did return a map containing message header. It allows changing the map, but changes did not result in changing the actual message header. Therefore using a map was removed and an object array is used instead. Changes to that array (content) will be result in a changed header in the message.
org.freedesktop.dbus.SignalTuple.getAllPossibleTuples(String, String, String, String)	should no longer be used
org.freedesktop.dbus.spi.transport.ITransportProvider.createTransport(BusAddress, int)	just used for compatibility will be removed in the future. Please use ITransportProvider.createTransport(BusAddress, TransportConfig).

Deprecated Constructors

Constructor	Description
org.freedesktop.dbus.connections.BusAddress(String)	Use BusAddress.of instead
org.freedesktop.dbus.connections.impl.DirectConnection(String)	use DirectConnectionBuilder
org.freedesktop.dbus.connections.impl.DirectConnection(String, int)	use DirectConnectionBuilder
org.freedesktop.dbus.connections.SASL()	should not be used as SASL configuration is not provided