Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
hudson.remoting.CallableFilter Use CallableDecorator

Deprecated Classes

Class and Description
hudson.remoting.Base64 Use Base64 instead
org.jenkinsci.remoting.util.Charsets Use StandardCharsets
hudson.remoting.forward.ForwarderFactory
hudson.remoting.forward.PortForwarder

Deprecated Exceptions

Exceptions and Description
hudson.remoting.ClassFilter.ClassFilterException Only used by deprecated ClassFilter.appendDefaultFilter(java.util.regex.Pattern).

Deprecated Fields

Field and Description
hudson.remoting.ClassFilter.FILE_OVERRIDE_LOCATION_PROPERTY use ClassFilter.setDefault(hudson.remoting.ClassFilter) as needed
hudson.remoting.Engine.listener Use Engine.events.
org.jenkinsci.remoting.protocol.ProtocolLayer.UTF_8 Use StandardCharsets

Deprecated Methods

Method and Description
hudson.remoting.Channel.addLocalExecutionInterceptor(CallableFilter) use Channel.addLocalExecutionInterceptor(CallableDecorator)
hudson.remoting.ClassFilter.appendDefaultFilter(Pattern) use ClassFilter.setDefault(hudson.remoting.ClassFilter) as needed
hudson.remoting.Channel.createLocalToRemotePortForwarding(int, String, int) as of 3.39
hudson.remoting.Channel.createRemoteToLocalPortForwarding(int, String, int) as of 3.39
org.jenkinsci.remoting.util.KeyUtils.fingerprint(Key)
org.jenkinsci.remoting.org.apache.commons.net.util.SubnetUtils.SubnetInfo.getAddressCount() (3.4) use SubnetUtils.SubnetInfo.getAddressCountLong() instead
hudson.remoting.Channel.getUnderlyingOutput() Future version of the remoting module may add other modes of creating channel that doesn't involve stream pair. Therefore, we aren't committing to this method. This method isn't a part of the committed API of the channel class.
hudson.remoting.Capability.hasMimicException() no longer used
hudson.remoting.Channel.isRestricted() Use methods like Channel.isRemoteClassLoadingAllowed() and Channel.isArbitraryCallableAllowed() to test individual features.
hudson.remoting.ChannelBuilder.isRestricted() Test individual features instead.
hudson.remoting.Which.jarURL(Class<?>) Use Which.classFileUrl(Class)
hudson.remoting.Launcher.main(InputStream, OutputStream, Channel.Mode, boolean) Use #main(InputStream, OutputStream, Mode, boolean, JarCache)
hudson.remoting.PingThread.onDead() as of 2.9 Override PingThread.onDead(Throwable) to receive the cause, but also override this method and provide a fallback behaviour to be backward compatible with earlier version of remoting library.
hudson.remoting.Channel.removeLocalExecutionInterceptor(CallableFilter) use Channel.removeLocalExecutionInterceptor(CallableDecorator)
hudson.remoting.Channel.setRestricted(boolean) Use methods like Channel.setRemoteClassLoadingAllowed(boolean) and Channel.setArbitraryCallableAllowed(boolean) to control individual features.
hudson.remoting.Channel.waitForRemoteProperty(ChannelProperty<T>) Because ChannelProperty is identity-equality, this method would never work. This is a design error.
hudson.remoting.ChannelBuilder.withRestricted(boolean) Control individual features.

Deprecated Constructors

Constructor and Description
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(mode) .build(is, os)
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(mode) .withHeaderStream(header) .withArbitraryCallableAllowed(true) .withRemoteClassLoadingAllowed(true) .build(is, os)
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream, boolean) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(mode) .withHeaderStream(header) .withArbitraryCallableAllowed(!restricted) .withRemoteClassLoadingAllowed(!restricted) .withBaseLoader(base) .build(is, os)
hudson.remoting.Channel(String, ExecutorService, Channel.Mode, InputStream, OutputStream, OutputStream, boolean, ClassLoader) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(mode) .withHeaderStream(header) .withArbitraryCallableAllowed(!restricted) .withRemoteClassLoadingAllowed(!restricted) .withBaseLoader(base) .build(is, os)
hudson.remoting.Channel(String, ExecutorService, CommandTransport, boolean, ClassLoader) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withArbitraryCallableAllowed(!restricted) .withRemoteClassLoadingAllowed(!restricted) .withBaseLoader(base) .build(transport)
hudson.remoting.Channel(String, ExecutorService, CommandTransport, boolean, ClassLoader, JarCache) as of 2.38 Use ChannelBuilder ChannelBuilder(name, exec) .withArbitraryCallableAllowed(!restricted) .withRemoteClassLoadingAllowed(!restricted) .withBaseLoader(base) .withJarCache(jarCache) .build(transport)
hudson.remoting.Channel(String, ExecutorService, InputStream, OutputStream) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(Channel.Mode.BINARY) .build(is, os)
hudson.remoting.Channel(String, ExecutorService, InputStream, OutputStream, OutputStream) as of 2.24 Use ChannelBuilder ChannelBuilder(name, exec) .withMode(Channel.Mode.BINARY) .withHeaderStream(header) .build(is, os)
hudson.remoting.ChannelClosedException() Use ChannelClosedException.ChannelClosedException(Throwable) or ChannelClosedException.ChannelClosedException(java.lang.String, java.lang.Throwable). This constructor will not include cause of the termination.
hudson.remoting.ChannelClosedException(String, Throwable) Use ChannelClosedException.ChannelClosedException(Channel, String, Throwable)
hudson.remoting.ChannelClosedException(Throwable) Use ChannelClosedException.ChannelClosedException(Channel, Throwable)
hudson.remoting.FastPipedOutputStream(FastPipedInputStream, int) as of 1.350 bufferSize parameter is ignored.
org.jenkinsci.remoting.engine.JnlpAgentEndpoint(String, int, RSAPublicKey, Set<String>) Use JnlpAgentEndpoint.JnlpAgentEndpoint(java.lang.String, int, java.security.interfaces.RSAPublicKey, java.util.Set, java.net.URL)
hudson.remoting.ObjectInputStreamEx(InputStream, ClassLoader) as of 2.53
hudson.remoting.RemoteInputStream(InputStream) as of 2.35 Use RemoteInputStream.RemoteInputStream(InputStream, Flag) and specify either RemoteInputStream.Flag.GREEDY or RemoteInputStream.Flag.NOT_GREEDY.
hudson.remoting.RemoteInputStream(InputStream, boolean) as of 2.35 Use RemoteInputStream.RemoteInputStream(InputStream, Flag, Flag ) with RemoteInputStream.Flag.MANUAL_UNEXPORT. Also specify either RemoteInputStream.Flag.GREEDY or RemoteInputStream.Flag.NOT_GREEDY.
hudson.remoting.SocketInputStream(Socket) Use SocketChannelStream.in(Socket)
hudson.remoting.SocketOutputStream(Socket) Use SocketChannelStream.out(Socket)
hudson.remoting.UnexportCommand(int) Use UnexportCommand.UnexportCommand(int, Throwable)