Package com.hierynomus.smbj.session

Class Session

java.lang.Object

com.hierynomus.smbj.session.Session

All Implemented Interfaces:

java.lang.AutoCloseable

public class Session
extends java.lang.Object
implements java.lang.AutoCloseable

A Session

Constructor Summary

Constructors

Constructor	Description
Session(Connection connection, AuthenticationContext userCredentials, SMBEventBus bus, PathResolver pathResolver, SecurityProvider securityProvider)

Method Summary

Modifier and Type	Method	Description
Session	buildNestedSession(SmbPath resolvedSharePath)
void	close()
Share	connectShare(java.lang.String shareName)	Connect to a share on the remote machine over the authenticated session.
AuthenticationContext	getAuthenticationContext()
Connection	getConnection()
PacketSignatory	getPacketSignatory()
long	getSessionId()
void	init(SMB2SessionSetup setup)
boolean	isAnonymous()
boolean	isGuest()
boolean	isSigningRequired()
void	logoff()
<T extends SMB2Packet> T	processSendResponse(SMB2CreateRequest packet)
<T extends SMB2Packet> java.util.concurrent.Future<T>	send(SMB2Packet packet)	send a packet.
void	setSessionId(long sessionId)
void	setSigningKey(byte[] signingKeyBytes)

Methods inherited from class java.lang.Object

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

Constructor Detail

Session

public Session(Connection connection,
               AuthenticationContext userCredentials,
               SMBEventBus bus,
               PathResolver pathResolver,
               SecurityProvider securityProvider)

Method Detail

init

public void init(SMB2SessionSetup setup)

getSessionId

public long getSessionId()

setSessionId

public void setSessionId(long sessionId)

connectShare

public Share connectShare(java.lang.String shareName)

Connect to a share on the remote machine over the authenticated session.

[MS-SMB2].pdf 3.2.4.2 Application Requests a Connection to a Share [MS-SMB2].pdf 3.2.4.2.4 Connecting to the Share [MS-SMB2].pdf 3.2.5.5 Receiving an SMB2 TREE_CONNECT Response

Parameters:

shareName - The name of the share to connect to.

Returns:

the handle to the connected share.

buildNestedSession

public Session buildNestedSession(SmbPath resolvedSharePath)

logoff

public void logoff()
            throws TransportException

Throws:

TransportException

isSigningRequired

public boolean isSigningRequired()

isGuest

public boolean isGuest()

isAnonymous

public boolean isAnonymous()

setSigningKey

public void setSigningKey(byte[] signingKeyBytes)

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

getConnection

public Connection getConnection()

send

public <T extends SMB2Packet> java.util.concurrent.Future<T> send(SMB2Packet packet)
                                                           throws TransportException

send a packet. The packet will be signed or not depending on the session's flags.

Parameters:

packet - SMBPacket to send

Returns:

a Future to be used to retrieve the response packet

Throws:

TransportException

processSendResponse

public <T extends SMB2Packet> T processSendResponse(SMB2CreateRequest packet)
                                             throws TransportException

Throws:

TransportException

getAuthenticationContext

public AuthenticationContext getAuthenticationContext()

getPacketSignatory

public PacketSignatory getPacketSignatory()