Resolver package is unstable
Motivation: The resolver package had some changes late in the 4.1.CR phase and the intention was to mark this package as unstable until these interfaces solidify, but we forgot to mark the package and public classes with the unstable annotation. Modifications: - resolver package public interfaces and package-info should be annotated with @UnstableApi Result: The unstable nature of the resolver package is more clearly communicated.
This commit is contained in:
parent
54c9ecf682
commit
b91dd0678d
@ -20,6 +20,7 @@ import io.netty.util.concurrent.EventExecutor;
|
|||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
import io.netty.util.internal.TypeParameterMatcher;
|
import io.netty.util.internal.TypeParameterMatcher;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.SocketAddress;
|
import java.net.SocketAddress;
|
||||||
import java.nio.channels.UnsupportedAddressTypeException;
|
import java.nio.channels.UnsupportedAddressTypeException;
|
||||||
@ -31,6 +32,7 @@ import static io.netty.util.internal.ObjectUtil.checkNotNull;
|
|||||||
/**
|
/**
|
||||||
* A skeletal {@link AddressResolver} implementation.
|
* A skeletal {@link AddressResolver} implementation.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public abstract class AbstractAddressResolver<T extends SocketAddress> implements AddressResolver<T> {
|
public abstract class AbstractAddressResolver<T extends SocketAddress> implements AddressResolver<T> {
|
||||||
|
|
||||||
private final EventExecutor executor;
|
private final EventExecutor executor;
|
||||||
|
@ -17,6 +17,7 @@ package io.netty.resolver;
|
|||||||
|
|
||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.io.Closeable;
|
import java.io.Closeable;
|
||||||
import java.net.SocketAddress;
|
import java.net.SocketAddress;
|
||||||
@ -26,6 +27,7 @@ import java.util.List;
|
|||||||
/**
|
/**
|
||||||
* Resolves a possibility unresolved {@link SocketAddress}.
|
* Resolves a possibility unresolved {@link SocketAddress}.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public interface AddressResolver<T extends SocketAddress> extends Closeable {
|
public interface AddressResolver<T extends SocketAddress> extends Closeable {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -19,6 +19,7 @@ package io.netty.resolver;
|
|||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.FutureListener;
|
import io.netty.util.concurrent.FutureListener;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
import io.netty.util.internal.logging.InternalLogger;
|
import io.netty.util.internal.logging.InternalLogger;
|
||||||
import io.netty.util.internal.logging.InternalLoggerFactory;
|
import io.netty.util.internal.logging.InternalLoggerFactory;
|
||||||
|
|
||||||
@ -31,6 +32,7 @@ import java.util.concurrent.ConcurrentMap;
|
|||||||
/**
|
/**
|
||||||
* Creates and manages {@link NameResolver}s so that each {@link EventExecutor} has its own resolver instance.
|
* Creates and manages {@link NameResolver}s so that each {@link EventExecutor} has its own resolver instance.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public abstract class AddressResolverGroup<T extends SocketAddress> implements Closeable {
|
public abstract class AddressResolverGroup<T extends SocketAddress> implements Closeable {
|
||||||
|
|
||||||
private static final InternalLogger logger = InternalLoggerFactory.getInstance(AddressResolverGroup.class);
|
private static final InternalLogger logger = InternalLoggerFactory.getInstance(AddressResolverGroup.class);
|
||||||
|
@ -19,6 +19,7 @@ import io.netty.util.concurrent.EventExecutor;
|
|||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.FutureListener;
|
import io.netty.util.concurrent.FutureListener;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.util.Arrays;
|
import java.util.Arrays;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
@ -30,6 +31,7 @@ import static io.netty.util.internal.ObjectUtil.*;
|
|||||||
*
|
*
|
||||||
* In case of a failure, only the last one will be reported.
|
* In case of a failure, only the last one will be reported.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public final class CompositeNameResolver<T> extends SimpleNameResolver<T> {
|
public final class CompositeNameResolver<T> extends SimpleNameResolver<T> {
|
||||||
|
|
||||||
private final NameResolver<T>[] resolvers;
|
private final NameResolver<T>[] resolvers;
|
||||||
|
@ -17,12 +17,14 @@
|
|||||||
package io.netty.resolver;
|
package io.netty.resolver;
|
||||||
|
|
||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.InetSocketAddress;
|
import java.net.InetSocketAddress;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A {@link AddressResolverGroup} of {@link DefaultNameResolver}s.
|
* A {@link AddressResolverGroup} of {@link DefaultNameResolver}s.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public final class DefaultAddressResolverGroup extends AddressResolverGroup<InetSocketAddress> {
|
public final class DefaultAddressResolverGroup extends AddressResolverGroup<InetSocketAddress> {
|
||||||
|
|
||||||
public static final DefaultAddressResolverGroup INSTANCE = new DefaultAddressResolverGroup();
|
public static final DefaultAddressResolverGroup INSTANCE = new DefaultAddressResolverGroup();
|
||||||
|
@ -19,6 +19,7 @@ package io.netty.resolver;
|
|||||||
import io.netty.util.internal.SocketUtils;
|
import io.netty.util.internal.SocketUtils;
|
||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.InetAddress;
|
import java.net.InetAddress;
|
||||||
import java.net.UnknownHostException;
|
import java.net.UnknownHostException;
|
||||||
@ -29,6 +30,7 @@ import java.util.List;
|
|||||||
* A {@link InetNameResolver} that resolves using JDK's built-in domain name lookup mechanism.
|
* A {@link InetNameResolver} that resolves using JDK's built-in domain name lookup mechanism.
|
||||||
* Note that this resolver performs a blocking name lookup from the caller thread.
|
* Note that this resolver performs a blocking name lookup from the caller thread.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public class DefaultNameResolver extends InetNameResolver {
|
public class DefaultNameResolver extends InetNameResolver {
|
||||||
|
|
||||||
public DefaultNameResolver(EventExecutor executor) {
|
public DefaultNameResolver(EventExecutor executor) {
|
||||||
|
@ -19,6 +19,7 @@ import io.netty.util.concurrent.EventExecutor;
|
|||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.FutureListener;
|
import io.netty.util.concurrent.FutureListener;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.InetAddress;
|
import java.net.InetAddress;
|
||||||
import java.net.InetSocketAddress;
|
import java.net.InetSocketAddress;
|
||||||
@ -28,6 +29,7 @@ import java.util.List;
|
|||||||
/**
|
/**
|
||||||
* A {@link AbstractAddressResolver} that resolves {@link InetSocketAddress}.
|
* A {@link AbstractAddressResolver} that resolves {@link InetSocketAddress}.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public class InetSocketAddressResolver extends AbstractAddressResolver<InetSocketAddress> {
|
public class InetSocketAddressResolver extends AbstractAddressResolver<InetSocketAddress> {
|
||||||
|
|
||||||
final NameResolver<InetAddress> nameResolver;
|
final NameResolver<InetAddress> nameResolver;
|
||||||
|
@ -18,6 +18,7 @@ package io.netty.resolver;
|
|||||||
|
|
||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.io.Closeable;
|
import java.io.Closeable;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
@ -25,6 +26,7 @@ import java.util.List;
|
|||||||
/**
|
/**
|
||||||
* Resolves an arbitrary string that represents the name of an endpoint into an address.
|
* Resolves an arbitrary string that represents the name of an endpoint into an address.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public interface NameResolver<T> extends Closeable {
|
public interface NameResolver<T> extends Closeable {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@ -18,6 +18,7 @@ package io.netty.resolver;
|
|||||||
|
|
||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.SocketAddress;
|
import java.net.SocketAddress;
|
||||||
import java.util.Collections;
|
import java.util.Collections;
|
||||||
@ -27,6 +28,7 @@ import java.util.List;
|
|||||||
* A {@link AddressResolver} that does not perform any resolution but always reports successful resolution.
|
* A {@link AddressResolver} that does not perform any resolution but always reports successful resolution.
|
||||||
* This resolver is useful when name resolution is performed by a handler in a pipeline, such as a proxy handler.
|
* This resolver is useful when name resolution is performed by a handler in a pipeline, such as a proxy handler.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public class NoopAddressResolver extends AbstractAddressResolver<SocketAddress> {
|
public class NoopAddressResolver extends AbstractAddressResolver<SocketAddress> {
|
||||||
|
|
||||||
public NoopAddressResolver(EventExecutor executor) {
|
public NoopAddressResolver(EventExecutor executor) {
|
||||||
|
@ -17,12 +17,14 @@
|
|||||||
package io.netty.resolver;
|
package io.netty.resolver;
|
||||||
|
|
||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.net.SocketAddress;
|
import java.net.SocketAddress;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A {@link AddressResolverGroup} of {@link NoopAddressResolver}s.
|
* A {@link AddressResolverGroup} of {@link NoopAddressResolver}s.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public final class NoopAddressResolverGroup extends AddressResolverGroup<SocketAddress> {
|
public final class NoopAddressResolverGroup extends AddressResolverGroup<SocketAddress> {
|
||||||
|
|
||||||
public static final NoopAddressResolverGroup INSTANCE = new NoopAddressResolverGroup();
|
public static final NoopAddressResolverGroup INSTANCE = new NoopAddressResolverGroup();
|
||||||
|
@ -19,6 +19,7 @@ package io.netty.resolver;
|
|||||||
import io.netty.util.concurrent.EventExecutor;
|
import io.netty.util.concurrent.EventExecutor;
|
||||||
import io.netty.util.concurrent.Future;
|
import io.netty.util.concurrent.Future;
|
||||||
import io.netty.util.concurrent.Promise;
|
import io.netty.util.concurrent.Promise;
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
@ -27,6 +28,7 @@ import static io.netty.util.internal.ObjectUtil.*;
|
|||||||
/**
|
/**
|
||||||
* A skeletal {@link NameResolver} implementation.
|
* A skeletal {@link NameResolver} implementation.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
public abstract class SimpleNameResolver<T> implements NameResolver<T> {
|
public abstract class SimpleNameResolver<T> implements NameResolver<T> {
|
||||||
|
|
||||||
private final EventExecutor executor;
|
private final EventExecutor executor;
|
||||||
|
@ -17,4 +17,7 @@
|
|||||||
/**
|
/**
|
||||||
* Resolves an arbitrary string that represents the name of an endpoint into an address.
|
* Resolves an arbitrary string that represents the name of an endpoint into an address.
|
||||||
*/
|
*/
|
||||||
|
@UnstableApi
|
||||||
package io.netty.resolver;
|
package io.netty.resolver;
|
||||||
|
|
||||||
|
import io.netty.util.internal.UnstableApi;
|
||||||
|
Loading…
Reference in New Issue
Block a user