Modifier and Type	Class and Description
public static class	SocketAddressResolver.Async Creates `InetSocketAddress` instances asynchronously in a different thread.
public static class	SocketAddressResolver.Sync Creates `InetSocketAddress` instances synchronously in the caller thread.

Modifier and Type	Method and Description
public void	resolve(String the host to resolve host, int the port of the resulting socket address port, Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails promise) Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`.

resolve	back to summary
public void resolve(String host, int port, Promise<List<InetSocketAddress>> promise) Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`. Parameters host:String the host to resolve port:int the port of the resulting socket address promise:Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails

org.eclipse.jetty.util back to summary

public Class SocketAddressResolver.Async

Class Inheritance

extends Object
implements SocketAddressResolver

java.lang.Object
org.eclipse.jetty.util.SocketAddressResolver.Async

All Implemented Interfaces

org.eclipse.jetty.util.SocketAddressResolver

Annotations

@ManagedObject:The asynchronous address resolver

Creates InetSocketAddress instances asynchronously in a different thread.

InetSocketAddress#InetSocketAddress(String, int) attempts to perform a DNS resolution of the host name, and this may block for several seconds. This class creates the InetSocketAddress in a separate thread and provides the result through a Promise, with the possibility to specify a timeout for the operation.

Example usage:

SocketAddressResolver resolver = new SocketAddressResolver.Async(executor, scheduler, timeout);
resolver.resolve("www.google.com", 80, new Promise<SocketAddress>()
{
    public void succeeded(SocketAddress result)
    {
        // The address was resolved
    }

    public void failed(Throwable failure)
    {
        // The address resolution failed
    }
});

Field Summary

Modifier and Type	Field and Description
private final Executor	executor
private static final Logger	LOG
private final Scheduler	scheduler
private final long	timeout

Constructor Summary

Access	Constructor and Description
public	Async(Executor the thread pool to use to perform DNS resolution in pooled threads executor, Scheduler the scheduler to schedule tasks to cancel DNS resolution if it takes too long scheduler, long the timeout, in milliseconds, for the DNS resolution to complete timeout) Creates a new instance with the given executor (to perform DNS resolution in a separate thread), the given scheduler (to cancel the operation if it takes too long) and the given timeout, in milliseconds.

Access

Constructor and Description

public

Async(Executor

the thread pool to use to perform DNS resolution in pooled threads

executor, Scheduler

the scheduler to schedule tasks to cancel DNS resolution if it takes too long

scheduler, long

the timeout, in milliseconds, for the DNS resolution to complete

timeout)

Creates a new instance with the given executor (to perform DNS resolution in a separate thread), the given scheduler (to cancel the operation if it takes too long) and the given timeout, in milliseconds.

Method Summary

Modifier and Type	Method and Description
public Executor	getExecutor()
public Scheduler	getScheduler()
public long	getTimeout()
public void	resolve(final String the host to resolve host, final int the port of the resulting socket address port, final Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails promise) Implements org.eclipse.jetty.util.SocketAddressResolver.resolve. Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

executor	back to summary
private final Executor executor

LOG	back to summary
private static final Logger LOG

scheduler	back to summary
private final Scheduler scheduler

timeout	back to summary
private final long timeout

Constructor Detail

Async	back to summary
public Async(Executor executor, Scheduler scheduler, long timeout) Creates a new instance with the given executor (to perform DNS resolution in a separate thread), the given scheduler (to cancel the operation if it takes too long) and the given timeout, in milliseconds. Parameters executor:Executor the thread pool to use to perform DNS resolution in pooled threads scheduler:Scheduler the scheduler to schedule tasks to cancel DNS resolution if it takes too long timeout:long the timeout, in milliseconds, for the DNS resolution to complete

Async

back to summary

public Async(Executor executor, Scheduler scheduler, long timeout)

Parameters

executor:Executor: the thread pool to use to perform DNS resolution in pooled threads
scheduler:Scheduler: the scheduler to schedule tasks to cancel DNS resolution if it takes too long
timeout:long: the timeout, in milliseconds, for the DNS resolution to complete

Method Detail

getExecutor	back to summary
public Executor getExecutor()

getScheduler	back to summary
public Scheduler getScheduler()

getTimeout	back to summary
public long getTimeout() Annotations @ManagedAttribute:The timeout, in milliseconds, to resolve an address readonly:true

resolve back to summary

resolve	back to summary
public void resolve(final String host, final int port, final Promise<List<InetSocketAddress>> promise) Implements org.eclipse.jetty.util.SocketAddressResolver.resolve. Doc from org.eclipse.jetty.util.SocketAddressResolver.resolve. Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`. Parameters host:String the host to resolve port:int the port of the resulting socket address promise:Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails Annotations @Override

public void resolve(final String host, final int port, final Promise<List<InetSocketAddress>> promise)

Implements org.eclipse.jetty.util.SocketAddressResolver.resolve.

Doc from org.eclipse.jetty.util.SocketAddressResolver.resolve.

Resolves via DNS the given host and port, within the connect timeout, returning a list of InetSocketAddress through the given Promise.

Parameters

host:String: the host to resolve
port:int: the port of the resulting socket address
promise:Promise<List<InetSocketAddress>>: the callback invoked when the resolution succeeds or fails

Annotations

@Override

org.eclipse.jetty.util back to summary

public Class SocketAddressResolver.Sync

Class Inheritance

extends Object
implements SocketAddressResolver

java.lang.Object
org.eclipse.jetty.util.SocketAddressResolver.Sync

All Implemented Interfaces

org.eclipse.jetty.util.SocketAddressResolver

Annotations

@ManagedObject:The synchronous address resolver

Creates InetSocketAddress instances synchronously in the caller thread.

Constructor Summary

Access	Constructor and Description
public	Sync()

Method Summary

Modifier and Type	Method and Description
public void	resolve(String the host to resolve host, int the port of the resulting socket address port, Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails promise) Implements org.eclipse.jetty.util.SocketAddressResolver.resolve. Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

Sync	back to summary
public Sync()

Method Detail

resolve back to summary

resolve	back to summary
public void resolve(String host, int port, Promise<List<InetSocketAddress>> promise) Implements org.eclipse.jetty.util.SocketAddressResolver.resolve. Doc from org.eclipse.jetty.util.SocketAddressResolver.resolve. Resolves via DNS the given host and port, within the connect timeout, returning a list of `InetSocketAddress` through the given `Promise`. Parameters host:String the host to resolve port:int the port of the resulting socket address promise:Promise<List<InetSocketAddress>> the callback invoked when the resolution succeeds or fails Annotations @Override

public void resolve(String host, int port, Promise<List<InetSocketAddress>> promise)

Implements org.eclipse.jetty.util.SocketAddressResolver.resolve.

Doc from org.eclipse.jetty.util.SocketAddressResolver.resolve.

Resolves via DNS the given host and port, within the connect timeout, returning a list of InetSocketAddress through the given Promise.

Parameters

host:String: the host to resolve
port:int: the port of the resulting socket address
promise:Promise<List<InetSocketAddress>>: the callback invoked when the resolution succeeds or fails

Annotations

@Override

public Interface SocketAddressResolver

Nested and Inner Type Summary

Method Summary

Method Detail

public Class SocketAddressResolver.Async

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class SocketAddressResolver.Sync

Constructor Summary

Method Summary

Constructor Detail

Method Detail