Package io.grpc.internal

Class JndiResourceResolverFactory

java.lang.Object

io.grpc.internal.JndiResourceResolverFactory

All Implemented Interfaces:

DnsNameResolver.ResourceResolverFactory

final class JndiResourceResolverFactory
extends Object
implements DnsNameResolver.ResourceResolverFactory

JndiResourceResolverFactory resolves additional records for the DnsNameResolver.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final class	JndiResourceResolverFactory.JndiRecordFetcher
(package private) static final class	JndiResourceResolverFactory.JndiResourceResolver
(package private) static interface	JndiResourceResolverFactory.RecordFetcher

Field Summary

Fields

Modifier and Type	Field	Description
private static final Throwable	JNDI_UNAVAILABILITY_CAUSE

Constructor Summary

Constructors

Constructor	Description
JndiResourceResolverFactory()

Method Summary

Modifier and Type	Method	Description
private static Throwable	initJndi()	Returns whether the JNDI DNS resolver is available.
DnsNameResolver.ResourceResolver	newResourceResolver()	Creates a new resource resolver.
Throwable	unavailabilityCause()	Returns the reason why the resource resolver cannot be created.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

JNDI_UNAVAILABILITY_CAUSE

@Nullable
private static final Throwable JNDI_UNAVAILABILITY_CAUSE

Constructor Details

JndiResourceResolverFactory

public JndiResourceResolverFactory()

Method Details

initJndi

@Nullable
private static Throwable initJndi()

Returns whether the JNDI DNS resolver is available. This is accomplished by looking up a particular class. It is believed to be the default (only?) DNS resolver that will actually be used. It is provided by the OpenJDK, but unlikely Android. Actual resolution will be done by using a service provider when a hostname query is present, so the DnsContextFactory may not actually be used to perform the query. This is believed to be "okay."

newResourceResolver

@Nullable
public DnsNameResolver.ResourceResolver newResourceResolver()

Description copied from interface: DnsNameResolver.ResourceResolverFactory

Creates a new resource resolver. The return value is null iff DnsNameResolver.ResourceResolverFactory.unavailabilityCause() is not null;

Specified by:

newResourceResolver in interface DnsNameResolver.ResourceResolverFactory

unavailabilityCause

@Nullable
public Throwable unavailabilityCause()

Description copied from interface: DnsNameResolver.ResourceResolverFactory

Returns the reason why the resource resolver cannot be created. The return value is null if DnsNameResolver.ResourceResolverFactory.newResourceResolver() is suitable for use.

Specified by:

unavailabilityCause in interface DnsNameResolver.ResourceResolverFactory