Module jcifs

Package org.codelibs.jcifs.smb.impl

Class DfsImpl

java.lang.Object

org.codelibs.jcifs.smb.impl.DfsImpl

All Implemented Interfaces:

DfsResolver

public class DfsImpl
extends Object
implements DfsResolver

Caching DFS resolver implementation

This class is intended for internal use.

Constructor Summary

Constructors

Constructor	Description
DfsImpl(CIFSContext tc)	Constructs a DFS resolver implementation

Method Summary

Modifier and Type	Method	Description
void	cache(CIFSContext tc, String path, DfsReferralData dr)	Add a referral to the cache
SmbTransport	getDc(CIFSContext tf, String domain)	Get a connection to the domain controller for a given domain
protected DfsReferralDataInternal	getReferral(CIFSContext tf, SmbTransportInternal trans, String target, String targetDomain, String targetHost, String root, String path)	Get a DFS referral for the specified target
boolean	isTrustedDomain(CIFSContext tf, String domain)	Checks if a domain is trusted for DFS operations
DfsReferralData	resolve(CIFSContext tf, String domain, String root, String path)	Resolve the location of a DFS path

Methods inherited from class java.lang.Object

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

Constructor Details

DfsImpl

public DfsImpl(CIFSContext tc)

Constructs a DFS resolver implementation

Parameters:

tc - the CIFS context containing configuration

Method Details

isTrustedDomain

public boolean isTrustedDomain(CIFSContext tf,
 String domain)
                        throws SmbAuthException

Checks if a domain is trusted for DFS operations

Specified by:

isTrustedDomain in interface DfsResolver

Parameters:

tf - the CIFS context

domain - the domain name to check

Returns:

whether the given domain is trusted

Throws:

SmbAuthException

See Also:

• DfsResolver.isTrustedDomain(org.codelibs.jcifs.smb.CIFSContext, java.lang.String)

getDc

public SmbTransport getDc(CIFSContext tf,
 String domain)
                   throws SmbAuthException

Get a connection to the domain controller for a given domain

Specified by:

getDc in interface DfsResolver

Parameters:

tf - the CIFS context

domain - the domain name

Returns:

connection to the domain controller

Throws:

SmbAuthException

See Also:

• DfsResolver.getDc(org.codelibs.jcifs.smb.CIFSContext, java.lang.String)

getReferral

protected DfsReferralDataInternal getReferral(CIFSContext tf,
 SmbTransportInternal trans,
 String target,
 String targetDomain,
 String targetHost,
 String root,
 String path)
                                       throws SmbAuthException

Get a DFS referral for the specified target

Parameters:

tf - the CIFS context

trans - the SMB transport

target - the target path

targetDomain - the target domain

targetHost - the target host

root - the DFS root

path - the DFS path

Returns:

the DFS referral data or null if not found

Throws:

SmbAuthException - if authentication fails

resolve

public DfsReferralData resolve(CIFSContext tf,
 String domain,
 String root,
 String path)
                        throws SmbAuthException

Resolve the location of a DFS path

Specified by:

resolve in interface DfsResolver

Parameters:

tf - the CIFS context containing configuration and credentials

domain - the domain for the DFS referral

root - the DFS root share

path - the DFS path to resolve

Returns:

the final referral for the given DFS path

Throws:

SmbAuthException - if authentication fails

See Also:

• DfsResolver.resolve(org.codelibs.jcifs.smb.CIFSContext, java.lang.String, java.lang.String, java.lang.String)

cache

public void cache(CIFSContext tc,
 String path,
 DfsReferralData dr)

Description copied from interface: DfsResolver

Add a referral to the cache

Specified by:

cache in interface DfsResolver

Parameters:

tc - the CIFS context containing configuration

path - the DFS path for this referral

dr - the DFS referral data to cache