Mark transport-rxtx as @deprecated

Motivation:

transport-rxtx has no tests and there is really no easy way to add some. Beside this this transport is not really well maintained.

Modifications:

Mark transport-rxtx as @deprecated so we can drop it in next major version.

Result:

Notify users of plan to drop the transport.
This commit is contained in:
Norman Maurer 2017-09-10 09:05:17 +02:00
parent 901c66fa81
commit 8c8779669e
6 changed files with 18 additions and 0 deletions

View File

@ -36,7 +36,10 @@ import static io.netty.channel.rxtx.RxtxChannelOption.WAIT_TIME;
/** /**
* Default configuration class for RXTX device connections. * Default configuration class for RXTX device connections.
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
final class DefaultRxtxChannelConfig extends DefaultChannelConfig implements RxtxChannelConfig { final class DefaultRxtxChannelConfig extends DefaultChannelConfig implements RxtxChannelConfig {
private volatile int baudrate = 115200; private volatile int baudrate = 115200;

View File

@ -36,7 +36,10 @@ import static io.netty.channel.rxtx.RxtxChannelOption.WAIT_TIME;
/** /**
* A channel to a serial device using the RXTX library. * A channel to a serial device using the RXTX library.
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
public class RxtxChannel extends OioByteStreamChannel { public class RxtxChannel extends OioByteStreamChannel {
private static final RxtxDeviceAddress LOCAL_ADDRESS = new RxtxDeviceAddress("localhost"); private static final RxtxDeviceAddress LOCAL_ADDRESS = new RxtxDeviceAddress("localhost");

View File

@ -49,7 +49,10 @@ import io.netty.channel.WriteBufferWaterMark;
* <td>{@link RxtxChannelOption#WAIT_TIME}</td><td>{@link #setWaitTimeMillis(int)}</td> * <td>{@link RxtxChannelOption#WAIT_TIME}</td><td>{@link #setWaitTimeMillis(int)}</td>
* </tr> * </tr>
* </table> * </table>
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
public interface RxtxChannelConfig extends ChannelConfig { public interface RxtxChannelConfig extends ChannelConfig {
enum Stopbits { enum Stopbits {
/** /**

View File

@ -22,7 +22,10 @@ import io.netty.channel.rxtx.RxtxChannelConfig.Stopbits;
/** /**
* Option for configuring a serial port connection * Option for configuring a serial port connection
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
public final class RxtxChannelOption<T> extends ChannelOption<T> { public final class RxtxChannelOption<T> extends ChannelOption<T> {
public static final ChannelOption<Integer> BAUD_RATE = valueOf(RxtxChannelOption.class, "BAUD_RATE"); public static final ChannelOption<Integer> BAUD_RATE = valueOf(RxtxChannelOption.class, "BAUD_RATE");

View File

@ -20,7 +20,10 @@ import java.net.SocketAddress;
/** /**
* A {@link SocketAddress} subclass to wrap the serial port address of a RXTX * A {@link SocketAddress} subclass to wrap the serial port address of a RXTX
* device (e.g. COM1, /dev/ttyUSB0). * device (e.g. COM1, /dev/ttyUSB0).
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
public class RxtxDeviceAddress extends SocketAddress { public class RxtxDeviceAddress extends SocketAddress {
private static final long serialVersionUID = -2907820090993709523L; private static final long serialVersionUID = -2907820090993709523L;

View File

@ -16,5 +16,8 @@
/** /**
* A serial and parallel port communication transport based on <a href="http://rxtx.qbang.org/">RXTX</a>. * A serial and parallel port communication transport based on <a href="http://rxtx.qbang.org/">RXTX</a>.
*
* @deprecated this transport will be removed in the next major version.
*/ */
@Deprecated
package io.netty.channel.rxtx; package io.netty.channel.rxtx;