SmbFile (jCIFS 1.3.18.1 API)

java.lang.Object
- java.net.URLConnection
- - jcifs.smb.SmbFile

直系の既知のサブクラス:: SmbNamedPipe

public class SmbFile
extends URLConnection

This class represents a resource on an SMB network. Mainly these resources are files and directories however an SmbFile may also refer to servers and workgroups. If the resource is a file or directory the methods of SmbFile follow the behavior of the well known File class. One fundamental difference is the usage of a URL scheme [1] to specify the target file or directory. SmbFile URLs have the following syntax:

     smb://[[[domain;]username[:password]@]server[:port]/[[share/[dir/]file]]][?param=value[param2=value2[...]]]

This example:

     smb://storage15/public/foo.txt

would reference the file foo.txt in the share public on the server storage15. In addition to referencing files and directories, jCIFS can also address servers, and workgroups.

Important: all SMB URLs that represent workgroups, servers, shares, or directories require a trailing slash '/'.

When using the java.net.URL class with 'smb://' URLs it is necessary to first call the static jcifs.Config.registerSmbURLHandler(); method. This is required to register the SMB protocol handler.

The userinfo component of the SMB URL (domain;user:pass) must be URL encoded if it contains reserved characters. According to RFC 2396 these characters are non US-ASCII characters and most meta characters however jCIFS will work correctly with anything but '@' which is used to delimit the userinfo component from the server and '%' which is the URL escape character itself.

The server component may a traditional NetBIOS name, a DNS name, or IP address. These name resolution mechanisms and their resolution order can be changed (See Setting Name Resolution Properties). The servername and path components are not case sensitive but the domain, username, and password components are. It is also likely that properties must be specified for jcifs to function (See Setting JCIFS Properties). Here are some examples of SMB URLs with brief descriptions of what they do:

[1] This URL scheme is based largely on the SMB Filesharing URL Scheme IETF draft.

SMB URL Examples
URL	Description
`smb://users-nyc;miallen:mypass@angus/tmp/`	This URL references a share called `tmp` on the server `angus` as user `miallen` who's password is `mypass`.
`smb://Administrator:P%40ss@msmith1/c/WINDOWS/Desktop/foo.txt`	A relativly sophisticated example that references a file `msmith1`'s desktop as user `Administrator`. Notice the '@' is URL encoded with the '%40' hexcode escape.
`smb://angus/`	This references only a server. The behavior of some methods is different in this context(e.g. you cannot `delete` a server) however as you might expect the `list` method will list the available shares on this server.
`smb://myworkgroup/`	This syntactically is identical to the above example. However if `myworkgroup` happends to be a workgroup(which is indeed suggested by the name) the `list` method will return a list of servers that have registered themselves as members of `myworkgroup`.
`smb://`	Just as `smb://server/` lists shares and `smb://workgroup/` lists servers, the `smb://` URL lists all available workgroups on a netbios LAN. Again, in this context many methods are not valid and return default values(e.g. `isHidden` will always return false).
`smb://angus.foo.net/d/jcifs/pipes.doc`	The server name may also be a DNS name as it is in this example. See Setting Name Resolution Properties for details.
`smb://192.168.1.15/ADMIN$/`	The server name may also be an IP address. See Setting Name Resolution Properties for details.
`smb://domain;username:password@server/share/path/to/file.txt`	A prototypical example that uses all the fields.
`smb://myworkgroup/angus/ <-- ILLEGAL`	Despite the hierarchial relationship between workgroups, servers, and filesystems this example is not valid.
`smb://server/share/path/to/dir <-- ILLEGAL`	URLs that represent workgroups, servers, shares, or directories require a trailing slash '/'.
`smb://MYGROUP/?SERVER=192.168.10.15`	SMB URLs support some query string parameters. In this example the `SERVER` parameter is used to override the server name service lookup to contact the server 192.168.10.15 (presumably known to be a master browser) for the server list in workgroup `MYGROUP`.

A second constructor argument may be specified to augment the URL for better programmatic control when processing many files under a common base. This is slightly different from the corresponding java.io.File usage; a '/' at the beginning of the second parameter will still use the server component of the first parameter. The examples below illustrate the resulting URLs when this second contructor argument is used.

Examples Of SMB URLs When Augmented With A Second Constructor Parameter
First Parameter	Second Parameter	Result
`smb://host/share/a/b/`	`c/d/`	`smb://host/share/a/b/c/d/`
`smb://host/share/foo/bar/`	`/share2/zig/zag`	`smb://host/share2/zig/zag`
`smb://host/share/foo/bar/`	`../zip/`	`smb://host/share/foo/zip/`
`smb://host/share/zig/zag`	`smb://foo/bar/`	`smb://foo/bar/`
`smb://host/share/foo/`	`../.././.././../foo/`	`smb://host/foo/`
`smb://host/share/zig/zag`	`/`	`smb://host/`
`smb://server/`	`../`	`smb://server/`
`smb://`	`myworkgroup/`	`smb://myworkgroup/`
`smb://myworkgroup/`	`angus/`	`smb://myworkgroup/angus/ <-- ILLEGAL (But if you first create an SmbFile with 'smb://workgroup/' and use and use it as the first parameter to a constructor that accepts it with a second String parameter jCIFS will factor out the 'workgroup'.)`

Instances of the SmbFile class are immutable; that is, once created, the abstract pathname represented by an SmbFile object will never change.

関連項目:: File

フィールドのサマリー

フィールド
修飾子とタイプ	フィールドと説明
`static int`	`ATTR_ARCHIVE` A file with this bit on as returned by `getAttributes()` or set with `setAttributes()` is an archived file
`static int`	`ATTR_DIRECTORY` A file with this bit on as returned by `getAttributes()` is a directory
`static int`	`ATTR_HIDDEN` A file with this bit on as returned by `getAttributes()` or set with `setAttributes()` will be hidden
`static int`	`ATTR_READONLY` A file with this bit on as returned by `getAttributes()` or set with `setAttributes()` will be read-only
`static int`	`ATTR_SYSTEM` A file with this bit on as returned by `getAttributes()` or set with `setAttributes()` will be a system file
`static int`	`ATTR_VOLUME` A file with this bit on as returned by `getAttributes()` is a volume
`static int`	`CAP_DFS`
`static int`	`CAP_EXTENDED_SECURITY`
`static int`	`CAP_LARGE_FILES`
`static int`	`CAP_LEVEL_II_OPLOCKS`
`static int`	`CAP_LOCK_AND_READ`
`static int`	`CAP_MPX_MODE`
`static int`	`CAP_NONE`
`static int`	`CAP_NT_FIND`
`static int`	`CAP_NT_SMBS`
`static int`	`CAP_RAW_MODE`
`static int`	`CAP_RPC_REMOTE_APIS`
`static int`	`CAP_STATUS32`
`static int`	`CAP_UNICODE`
`static int`	`CAPABILITIES`
`static int`	`CMD_OFFSET`
`static int`	`CONN_TIMEOUT`
`static LinkedList`	`CONNECTIONS`
`static int`	`DEFAULT_CAPABILITIES`
`static int`	`DEFAULT_CONN_TIMEOUT`
`static int`	`DEFAULT_FLAGS2`
`static int`	`DEFAULT_MAX_MPX_COUNT`
`static int`	`DEFAULT_PORT`
`static int`	`DEFAULT_RCV_BUF_SIZE`
`static int`	`DEFAULT_RESPONSE_TIMEOUT`
`static int`	`DEFAULT_SND_BUF_SIZE`
`static int`	`DEFAULT_SO_TIMEOUT`
`static int`	`DEFAULT_SSN_LIMIT`
`static int`	`DELETE`
`protected static Dfs`	`dfs`
`static int`	`ERROR_CODE_OFFSET`
`static int`	`FILE_APPEND_DATA`
`static int`	`FILE_DELETE`
`static int`	`FILE_EXECUTE`
`static int`	`FILE_NO_SHARE` When specified as the `shareAccess` constructor parameter, other SMB clients (including other threads making calls into jCIFS) will not be permitted to access the target file and will receive "The file is being accessed by another process" message.
`static int`	`FILE_READ_ATTRIBUTES`
`static int`	`FILE_READ_DATA`
`static int`	`FILE_READ_EA`
`static int`	`FILE_SHARE_DELETE` When specified as the `shareAccess` constructor parameter, other SMB clients will be permitted to delete the target file while this file is open.
`static int`	`FILE_SHARE_READ` When specified as the `shareAccess` constructor parameter, other SMB clients will be permitted to read from the target file while this file is open.
`static int`	`FILE_SHARE_WRITE` When specified as the `shareAccess` constructor parameter, other SMB clients will be permitted to write to the target file while this file is open.
`static int`	`FILE_WRITE_ATTRIBUTES`
`static int`	`FILE_WRITE_DATA`
`static int`	`FILE_WRITE_EA`
`static int`	`FLAGS_COPY_SOURCE_MODE_ASCII`
`static int`	`FLAGS_COPY_TARGET_MODE_ASCII`
`static int`	`FLAGS_LOCK_AND_READ_WRITE_AND_UNLOCK`
`static int`	`FLAGS_NONE`
`static int`	`FLAGS_NOTIFY_OF_MODIFY_ACTION`
`static int`	`FLAGS_OFFSET`
`static int`	`FLAGS_OPLOCK_REQUESTED_OR_GRANTED`
`static int`	`FLAGS_PATH_NAMES_CANONICALIZED`
`static int`	`FLAGS_PATH_NAMES_CASELESS`
`static int`	`FLAGS_RECEIVE_BUFFER_POSTED`
`static int`	`FLAGS_RESPONSE`
`static int`	`FLAGS_TARGET_MUST_BE_DIRECTORY`
`static int`	`FLAGS_TARGET_MUST_BE_FILE`
`static int`	`FLAGS_TREE_COPY`
`static int`	`FLAGS_VERIFY_ALL_WRITES`
`static int`	`FLAGS2`
`static int`	`FLAGS2_EXTENDED_ATTRIBUTES`
`static int`	`FLAGS2_EXTENDED_SECURITY_NEGOTIATION`
`static int`	`FLAGS2_LONG_FILENAMES`
`static int`	`FLAGS2_NONE`
`static int`	`FLAGS2_PERMIT_READ_IF_EXECUTE_PERM`
`static int`	`FLAGS2_RESOLVE_PATHS_IN_DFS`
`static int`	`FLAGS2_SECURITY_SIGNATURES`
`static int`	`FLAGS2_STATUS32`
`static int`	`FLAGS2_UNICODE`
`static boolean`	`FORCE_UNICODE`
`static int`	`GENERIC_ALL`
`static int`	`GENERIC_EXECUTE`
`static int`	`GENERIC_READ`
`static int`	`GENERIC_WRITE`
`static int`	`HEADER_LENGTH`
`static InetAddress`	`LADDR`
`static int`	`LM_COMPATIBILITY`
`static int`	`LPORT`
`static int`	`MAX_MPX_COUNT`
`static long`	`MILLISECONDS_BETWEEN_1970_AND_1601`
`static String`	`NATIVE_LANMAN`
`static String`	`NATIVE_OS`
`static String`	`NETBIOS_HOSTNAME`
`static SmbTransport`	`NULL_TRANSPORT`
`static String`	`OEM_ENCODING`
`static int`	`OPEN_FUNCTION_FAIL_IF_EXISTS`
`static int`	`OPEN_FUNCTION_OVERWRITE_IF_EXISTS`
`static int`	`PID`
`static int`	`RCV_BUF_SIZE`
`static int`	`READ_CONTROL`
`static int`	`RESPONSE_TIMEOUT`
`static int`	`SECURITY_SHARE`
`static int`	`SECURITY_USER`
`static int`	`SIGNATURE_OFFSET`
`static boolean`	`SIGNPREF`
`static int`	`SND_BUF_SIZE`
`static int`	`SO_TIMEOUT`
`static int`	`SSN_LIMIT`
`static int`	`SYNCHRONIZE`
`static boolean`	`TCP_NODELAY`
`static int`	`TID_OFFSET`
`static int`	`TYPE_COMM` Returned by `getType()` if the resource this `SmbFile` represents is a communications device.
`static int`	`TYPE_FILESYSTEM` Returned by `getType()` if the resource this `SmbFile` represents is a regular file or directory.
`static int`	`TYPE_NAMED_PIPE` Returned by `getType()` if the resource this `SmbFile` represents is a named pipe.
`static int`	`TYPE_PRINTER` Returned by `getType()` if the resource this `SmbFile` represents is a printer.
`static int`	`TYPE_SERVER` Returned by `getType()` if the resource this `SmbFile` represents is a server.
`static int`	`TYPE_SHARE` Returned by `getType()` if the resource this `SmbFile` represents is a share.
`static int`	`TYPE_WORKGROUP` Returned by `getType()` if the resource this `SmbFile` represents is a workgroup.
`static TimeZone`	`TZ`
`static String`	`UNI_ENCODING`
`static boolean`	`USE_BATCHING`
`static boolean`	`USE_EXTSEC`
`static boolean`	`USE_NTSMBS`
`static boolean`	`USE_NTSTATUS`
`static boolean`	`USE_UNICODE`
`static int`	`VC_NUMBER`
`static int`	`WRITE_DAC`
`static int`	`WRITE_OWNER`

クラスから継承されたフィールド java.net.URLConnection
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`SmbFile(SmbFile context, String name)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(SmbFile context, String name, int shareAccess)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(String url)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(String url, NtlmPasswordAuthentication auth)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(String url, NtlmPasswordAuthentication auth, int shareAccess)` Constructs an SmbFile representing a file on an SMB network.
`SmbFile(String context, String name)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(String context, String name, NtlmPasswordAuthentication auth)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(String context, String name, NtlmPasswordAuthentication auth, int shareAccess)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
`SmbFile(URL url)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory from a `URL` object.
`SmbFile(URL url, NtlmPasswordAuthentication auth)` Constructs an SmbFile representing a resource on an SMB network such as a file or directory from a `URL` object and an `NtlmPasswordAuthentication` object.

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド非推奨のメソッド
修飾子とタイプ	メソッドと説明
`boolean`	`canRead()` Tests to see if the file this `SmbFile` represents can be read.
`boolean`	`canWrite()` Tests to see if the file this `SmbFile` represents exists and is not marked read-only.
`void`	`connect()` It is not necessary to call this method directly.
`void`	`copyTo(SmbFile dest)` This method will copy the file or directory represented by this `SmbFile` and it's sub-contents to the location specified by the `dest` parameter.
`void`	`createNewFile()` Create a new file but fail if it already exists.
`long`	`createTime()` Retrieve the time this `SmbFile` was created.
`void`	`delete()` This method will delete the file or directory specified by this `SmbFile`.
`boolean`	`equals(Object obj)` Tests to see if two `SmbFile` objects are equal.
`boolean`	`exists()` Tests to see if the SMB resource exists.
`int`	`getAttributes()` Return the attributes of this file.
`String`	`getCanonicalPath()` Returns the full URL of this SMB resource with '.' and '..' components factored out.
`int`	`getContentLength()` This URLConnection method just returns the result of `length()`.
`long`	`getDate()` This URLConnection method just returns the result of `lastModified`.
`String`	`getDfsPath()` If the path of this `SmbFile` falls within a DFS volume, this method will return the referral path to which it maps.
`long`	`getDiskFreeSpace()` This method returns the free disk space in bytes of the drive this share represents or the drive on which the directory or file resides.
`InputStream`	`getInputStream()` This URLConnection method just returns a new `SmbFileInputStream` created with this file.
`long`	`getLastModified()` This URLConnection method just returns the result of `lastModified`.
`String`	`getName()` Returns the last component of the target URL.
`OutputStream`	`getOutputStream()` This URLConnection method just returns a new `SmbFileOutputStream` created with this file.
`SID`	`getOwnerGroup()`
`SID`	`getOwnerUser()`
`String`	`getParent()` Everything but the last component of the URL representing this SMB resource is effectivly it's parent.
`String`	`getPath()` Returns the full uncanonicalized URL of this SMB resource.
`Principal`	`getPrincipal()` Returns the `NtlmPasswordAuthentication` object used as credentials with this file or pipe.
`ACE[]`	`getSecurity()` Return an array of Access Control Entry (ACE) objects representing the security descriptor associated with this file or directory.
`ACE[]`	`getSecurity(boolean resolveSids)` Return an array of Access Control Entry (ACE) objects representing the security descriptor associated with this file or directory.
`String`	`getServer()` Retrieve the hostname of the server for this SMB resource.
`String`	`getShare()` Retrieves the share associated with this SMB resource.
`ACE[]`	`getShareSecurity(boolean resolveSids)` Return an array of Access Control Entry (ACE) objects representing the share permissions on the share exporting this file or directory.
`int`	`getType()` Returns type of of object this `SmbFile` represents.
`String`	`getUncPath()` Retuns the Windows UNC style path with backslashs intead of forward slashes.
`int`	`hashCode()` Computes a hashCode for this file based on the URL string and IP address if the server.
`boolean`	`isDirectory()` Tests to see if the file this `SmbFile` represents is a directory.
`boolean`	`isFile()` Tests to see if the file this `SmbFile` represents is not a directory.
`boolean`	`isHidden()` Tests to see if the file this SmbFile represents is marked as hidden.
`long`	`lastModified()` Retrieve the last time the file represented by this `SmbFile` was modified.
`long`	`length()` Returns the length of this `SmbFile` in bytes.
`String[]`	`list()` List the contents of this SMB resource.
`String[]`	`list(SmbFilenameFilter filter)` List the contents of this SMB resource.
`SmbFile[]`	`listFiles()` List the contents of this SMB resource as an array of `SmbFile` objects.
`SmbFile[]`	`listFiles(SmbFileFilter filter)` List the contents of this SMB resource.
`SmbFile[]`	`listFiles(SmbFilenameFilter filter)` List the contents of this SMB resource.
`SmbFile[]`	`listFiles(String wildcard)` The CIFS protocol provides for DOS "wildcards" to be used as a performance enhancement.
`void`	`mkdir()` Creates a directory with the path specified by this `SmbFile`.
`void`	`mkdirs()` Creates a directory with the path specified by this `SmbFile` and any parent directories that do not exist.
`protected boolean`	`pathNamesPossiblyEqual(String path1, String path2)`
`void`	`renameTo(SmbFile dest)` Changes the name of the file this `SmbFile` represents to the name designated by the `SmbFile` argument.
`void`	`setAttributes(int attrs)` Set the attributes of this file.
`void`	`setCreateTime(long time)` Set the create time of the file.
`void`	`setLastModified(long time)` Set the last modified time of the file.
`void`	`setReadOnly()` Make this file read-only.
`void`	`setReadWrite()` Turn off the read-only attribute of this file.
`String`	`toString()` Returns the string representation of this SmbFile object.
`URL`	`toURL()` 非推奨です。 Use getURL() instead

クラスから継承されたメソッド java.net.URLConnection
addRequestProperty, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLengthLong, getContentType, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getPermission, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches

クラスから継承されたメソッド java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - FILE_NO_SHARE
```
public static final int FILE_NO_SHARE
```
    When specified as the shareAccess constructor parameter, other SMB clients (including other threads making calls into jCIFS) will not be permitted to access the target file and will receive "The file is being accessed by another process" message.
    
    関連項目:
    
    定数フィールド値
  - FILE_SHARE_READ
```
public static final int FILE_SHARE_READ
```
    When specified as the shareAccess constructor parameter, other SMB clients will be permitted to read from the target file while this file is open. This constant may be logically OR'd with other share access flags.
    
    関連項目:
    
    定数フィールド値
  - FILE_SHARE_WRITE
```
public static final int FILE_SHARE_WRITE
```
    When specified as the shareAccess constructor parameter, other SMB clients will be permitted to write to the target file while this file is open. This constant may be logically OR'd with other share access flags.
    
    関連項目:
    
    定数フィールド値
  - FILE_SHARE_DELETE
```
public static final int FILE_SHARE_DELETE
```
    When specified as the shareAccess constructor parameter, other SMB clients will be permitted to delete the target file while this file is open. This constant may be logically OR'd with other share access flags.
    
    関連項目:
    
    定数フィールド値
  - ATTR_READONLY
```
public static final int ATTR_READONLY
```
    A file with this bit on as returned by getAttributes() or set with setAttributes() will be read-only
    
    関連項目:
    
    定数フィールド値
  - ATTR_HIDDEN
```
public static final int ATTR_HIDDEN
```
    A file with this bit on as returned by getAttributes() or set with setAttributes() will be hidden
    
    関連項目:
    
    定数フィールド値
  - ATTR_SYSTEM
```
public static final int ATTR_SYSTEM
```
    A file with this bit on as returned by getAttributes() or set with setAttributes() will be a system file
    
    関連項目:
    
    定数フィールド値
  - ATTR_VOLUME
```
public static final int ATTR_VOLUME
```
    A file with this bit on as returned by getAttributes() is a volume
    
    関連項目:
    
    定数フィールド値
  - ATTR_DIRECTORY
```
public static final int ATTR_DIRECTORY
```
    A file with this bit on as returned by getAttributes() is a directory
    
    関連項目:
    
    定数フィールド値
  - ATTR_ARCHIVE
```
public static final int ATTR_ARCHIVE
```
    A file with this bit on as returned by getAttributes() or set with setAttributes() is an archived file
    
    関連項目:
    
    定数フィールド値
  - TYPE_FILESYSTEM
```
public static final int TYPE_FILESYSTEM
```
    Returned by getType() if the resource this SmbFile represents is a regular file or directory.
    
    関連項目:
    
    定数フィールド値
  - TYPE_WORKGROUP
```
public static final int TYPE_WORKGROUP
```
    Returned by getType() if the resource this SmbFile represents is a workgroup.
    
    関連項目:
    
    定数フィールド値
  - TYPE_SERVER
```
public static final int TYPE_SERVER
```
    Returned by getType() if the resource this SmbFile represents is a server.
    
    関連項目:
    
    定数フィールド値
  - TYPE_SHARE
```
public static final int TYPE_SHARE
```
    Returned by getType() if the resource this SmbFile represents is a share.
    
    関連項目:
    
    定数フィールド値
  - TYPE_NAMED_PIPE
```
public static final int TYPE_NAMED_PIPE
```
    Returned by getType() if the resource this SmbFile represents is a named pipe.
    
    関連項目:
    
    定数フィールド値
  - TYPE_PRINTER
```
public static final int TYPE_PRINTER
```
    Returned by getType() if the resource this SmbFile represents is a printer.
    
    関連項目:
    
    定数フィールド値
  - TYPE_COMM
```
public static final int TYPE_COMM
```
    Returned by getType() if the resource this SmbFile represents is a communications device.
    
    関連項目:
    
    定数フィールド値
  - dfs
```
protected static Dfs dfs
```
  - DEFAULT_PORT
```
public static final int DEFAULT_PORT
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_MAX_MPX_COUNT
```
public static final int DEFAULT_MAX_MPX_COUNT
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_RESPONSE_TIMEOUT
```
public static final int DEFAULT_RESPONSE_TIMEOUT
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_SO_TIMEOUT
```
public static final int DEFAULT_SO_TIMEOUT
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_RCV_BUF_SIZE
```
public static final int DEFAULT_RCV_BUF_SIZE
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_SND_BUF_SIZE
```
public static final int DEFAULT_SND_BUF_SIZE
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_SSN_LIMIT
```
public static final int DEFAULT_SSN_LIMIT
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_CONN_TIMEOUT
```
public static final int DEFAULT_CONN_TIMEOUT
```
    関連項目:
    
    定数フィールド値
  - LADDR
```
public static final InetAddress LADDR
```
  - LPORT
```
public static final int LPORT
```
  - MAX_MPX_COUNT
```
public static final int MAX_MPX_COUNT
```
  - SND_BUF_SIZE
```
public static final int SND_BUF_SIZE
```
  - RCV_BUF_SIZE
```
public static final int RCV_BUF_SIZE
```
  - USE_UNICODE
```
public static final boolean USE_UNICODE
```
  - FORCE_UNICODE
```
public static final boolean FORCE_UNICODE
```
  - USE_NTSTATUS
```
public static final boolean USE_NTSTATUS
```
  - SIGNPREF
```
public static final boolean SIGNPREF
```
  - USE_NTSMBS
```
public static final boolean USE_NTSMBS
```
  - USE_EXTSEC
```
public static final boolean USE_EXTSEC
```
  - NETBIOS_HOSTNAME
```
public static final String NETBIOS_HOSTNAME
```
  - LM_COMPATIBILITY
```
public static final int LM_COMPATIBILITY
```
  - FLAGS_NONE
```
public static final int FLAGS_NONE
```
    関連項目:
    
    定数フィールド値
  - FLAGS_LOCK_AND_READ_WRITE_AND_UNLOCK
```
public static final int FLAGS_LOCK_AND_READ_WRITE_AND_UNLOCK
```
    関連項目:
    
    定数フィールド値
  - FLAGS_RECEIVE_BUFFER_POSTED
```
public static final int FLAGS_RECEIVE_BUFFER_POSTED
```
    関連項目:
    
    定数フィールド値
  - FLAGS_PATH_NAMES_CASELESS
```
public static final int FLAGS_PATH_NAMES_CASELESS
```
    関連項目:
    
    定数フィールド値
  - FLAGS_PATH_NAMES_CANONICALIZED
```
public static final int FLAGS_PATH_NAMES_CANONICALIZED
```
    関連項目:
    
    定数フィールド値
  - FLAGS_OPLOCK_REQUESTED_OR_GRANTED
```
public static final int FLAGS_OPLOCK_REQUESTED_OR_GRANTED
```
    関連項目:
    
    定数フィールド値
  - FLAGS_NOTIFY_OF_MODIFY_ACTION
```
public static final int FLAGS_NOTIFY_OF_MODIFY_ACTION
```
    関連項目:
    
    定数フィールド値
  - FLAGS_RESPONSE
```
public static final int FLAGS_RESPONSE
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_NONE
```
public static final int FLAGS2_NONE
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_LONG_FILENAMES
```
public static final int FLAGS2_LONG_FILENAMES
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_EXTENDED_ATTRIBUTES
```
public static final int FLAGS2_EXTENDED_ATTRIBUTES
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_SECURITY_SIGNATURES
```
public static final int FLAGS2_SECURITY_SIGNATURES
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_EXTENDED_SECURITY_NEGOTIATION
```
public static final int FLAGS2_EXTENDED_SECURITY_NEGOTIATION
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_RESOLVE_PATHS_IN_DFS
```
public static final int FLAGS2_RESOLVE_PATHS_IN_DFS
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_PERMIT_READ_IF_EXECUTE_PERM
```
public static final int FLAGS2_PERMIT_READ_IF_EXECUTE_PERM
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_STATUS32
```
public static final int FLAGS2_STATUS32
```
    関連項目:
    
    定数フィールド値
  - FLAGS2_UNICODE
```
public static final int FLAGS2_UNICODE
```
    関連項目:
    
    定数フィールド値
  - CAP_NONE
```
public static final int CAP_NONE
```
    関連項目:
    
    定数フィールド値
  - CAP_RAW_MODE
```
public static final int CAP_RAW_MODE
```
    関連項目:
    
    定数フィールド値
  - CAP_MPX_MODE
```
public static final int CAP_MPX_MODE
```
    関連項目:
    
    定数フィールド値
  - CAP_UNICODE
```
public static final int CAP_UNICODE
```
    関連項目:
    
    定数フィールド値
  - CAP_LARGE_FILES
```
public static final int CAP_LARGE_FILES
```
    関連項目:
    
    定数フィールド値
  - CAP_NT_SMBS
```
public static final int CAP_NT_SMBS
```
    関連項目:
    
    定数フィールド値
  - CAP_RPC_REMOTE_APIS
```
public static final int CAP_RPC_REMOTE_APIS
```
    関連項目:
    
    定数フィールド値
  - CAP_STATUS32
```
public static final int CAP_STATUS32
```
    関連項目:
    
    定数フィールド値
  - CAP_LEVEL_II_OPLOCKS
```
public static final int CAP_LEVEL_II_OPLOCKS
```
    関連項目:
    
    定数フィールド値
  - CAP_LOCK_AND_READ
```
public static final int CAP_LOCK_AND_READ
```
    関連項目:
    
    定数フィールド値
  - CAP_NT_FIND
```
public static final int CAP_NT_FIND
```
    関連項目:
    
    定数フィールド値
  - CAP_DFS
```
public static final int CAP_DFS
```
    関連項目:
    
    定数フィールド値
  - CAP_EXTENDED_SECURITY
```
public static final int CAP_EXTENDED_SECURITY
```
    関連項目:
    
    定数フィールド値
  - FILE_READ_DATA
```
public static final int FILE_READ_DATA
```
    関連項目:
    
    定数フィールド値
  - FILE_WRITE_DATA
```
public static final int FILE_WRITE_DATA
```
    関連項目:
    
    定数フィールド値
  - FILE_APPEND_DATA
```
public static final int FILE_APPEND_DATA
```
    関連項目:
    
    定数フィールド値
  - FILE_READ_EA
```
public static final int FILE_READ_EA
```
    関連項目:
    
    定数フィールド値
  - FILE_WRITE_EA
```
public static final int FILE_WRITE_EA
```
    関連項目:
    
    定数フィールド値
  - FILE_EXECUTE
```
public static final int FILE_EXECUTE
```
    関連項目:
    
    定数フィールド値
  - FILE_DELETE
```
public static final int FILE_DELETE
```
    関連項目:
    
    定数フィールド値
  - FILE_READ_ATTRIBUTES
```
public static final int FILE_READ_ATTRIBUTES
```
    関連項目:
    
    定数フィールド値
  - FILE_WRITE_ATTRIBUTES
```
public static final int FILE_WRITE_ATTRIBUTES
```
    関連項目:
    
    定数フィールド値
  - DELETE
```
public static final int DELETE
```
    関連項目:
    
    定数フィールド値
  - READ_CONTROL
```
public static final int READ_CONTROL
```
    関連項目:
    
    定数フィールド値
  - WRITE_DAC
```
public static final int WRITE_DAC
```
    関連項目:
    
    定数フィールド値
  - WRITE_OWNER
```
public static final int WRITE_OWNER
```
    関連項目:
    
    定数フィールド値
  - SYNCHRONIZE
```
public static final int SYNCHRONIZE
```
    関連項目:
    
    定数フィールド値
  - GENERIC_ALL
```
public static final int GENERIC_ALL
```
    関連項目:
    
    定数フィールド値
  - GENERIC_EXECUTE
```
public static final int GENERIC_EXECUTE
```
    関連項目:
    
    定数フィールド値
  - GENERIC_WRITE
```
public static final int GENERIC_WRITE
```
    関連項目:
    
    定数フィールド値
  - GENERIC_READ
```
public static final int GENERIC_READ
```
    関連項目:
    
    定数フィールド値
  - FLAGS_TARGET_MUST_BE_FILE
```
public static final int FLAGS_TARGET_MUST_BE_FILE
```
    関連項目:
    
    定数フィールド値
  - FLAGS_TARGET_MUST_BE_DIRECTORY
```
public static final int FLAGS_TARGET_MUST_BE_DIRECTORY
```
    関連項目:
    
    定数フィールド値
  - FLAGS_COPY_TARGET_MODE_ASCII
```
public static final int FLAGS_COPY_TARGET_MODE_ASCII
```
    関連項目:
    
    定数フィールド値
  - FLAGS_COPY_SOURCE_MODE_ASCII
```
public static final int FLAGS_COPY_SOURCE_MODE_ASCII
```
    関連項目:
    
    定数フィールド値
  - FLAGS_VERIFY_ALL_WRITES
```
public static final int FLAGS_VERIFY_ALL_WRITES
```
    関連項目:
    
    定数フィールド値
  - FLAGS_TREE_COPY
```
public static final int FLAGS_TREE_COPY
```
    関連項目:
    
    定数フィールド値
  - OPEN_FUNCTION_FAIL_IF_EXISTS
```
public static final int OPEN_FUNCTION_FAIL_IF_EXISTS
```
    関連項目:
    
    定数フィールド値
  - OPEN_FUNCTION_OVERWRITE_IF_EXISTS
```
public static final int OPEN_FUNCTION_OVERWRITE_IF_EXISTS
```
    関連項目:
    
    定数フィールド値
  - PID
```
public static final int PID
```
  - SECURITY_SHARE
```
public static final int SECURITY_SHARE
```
    関連項目:
    
    定数フィールド値
  - SECURITY_USER
```
public static final int SECURITY_USER
```
    関連項目:
    
    定数フィールド値
  - CMD_OFFSET
```
public static final int CMD_OFFSET
```
    関連項目:
    
    定数フィールド値
  - ERROR_CODE_OFFSET
```
public static final int ERROR_CODE_OFFSET
```
    関連項目:
    
    定数フィールド値
  - FLAGS_OFFSET
```
public static final int FLAGS_OFFSET
```
    関連項目:
    
    定数フィールド値
  - SIGNATURE_OFFSET
```
public static final int SIGNATURE_OFFSET
```
    関連項目:
    
    定数フィールド値
  - TID_OFFSET
```
public static final int TID_OFFSET
```
    関連項目:
    
    定数フィールド値
  - HEADER_LENGTH
```
public static final int HEADER_LENGTH
```
    関連項目:
    
    定数フィールド値
  - MILLISECONDS_BETWEEN_1970_AND_1601
```
public static final long MILLISECONDS_BETWEEN_1970_AND_1601
```
    関連項目:
    
    定数フィールド値
  - TZ
```
public static final TimeZone TZ
```
  - USE_BATCHING
```
public static final boolean USE_BATCHING
```
  - OEM_ENCODING
```
public static final String OEM_ENCODING
```
  - UNI_ENCODING
```
public static final String UNI_ENCODING
```
    関連項目:
    
    定数フィールド値
  - DEFAULT_FLAGS2
```
public static final int DEFAULT_FLAGS2
```
  - DEFAULT_CAPABILITIES
```
public static final int DEFAULT_CAPABILITIES
```
  - FLAGS2
```
public static final int FLAGS2
```
  - CAPABILITIES
```
public static final int CAPABILITIES
```
  - TCP_NODELAY
```
public static final boolean TCP_NODELAY
```
  - RESPONSE_TIMEOUT
```
public static final int RESPONSE_TIMEOUT
```
  - CONNECTIONS
```
public static final LinkedList CONNECTIONS
```
  - SSN_LIMIT
```
public static final int SSN_LIMIT
```
  - SO_TIMEOUT
```
public static final int SO_TIMEOUT
```
  - CONN_TIMEOUT
```
public static final int CONN_TIMEOUT
```
  - NATIVE_OS
```
public static final String NATIVE_OS
```
  - NATIVE_LANMAN
```
public static final String NATIVE_LANMAN
```
  - VC_NUMBER
```
public static final int VC_NUMBER
```
    関連項目:
    
    定数フィールド値
  - NULL_TRANSPORT
```
public static final SmbTransport NULL_TRANSPORT
```
- コンストラクタの詳細
  - SmbFile
```
public SmbFile(String url)
        throws MalformedURLException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. See the description and examples of smb URLs above.
    
    パラメータ:
    
    url - A URL string
    
    例外:
    
    MalformedURLException - If the parent and child parameters do not follow the prescribed syntax
  - SmbFile
```
public SmbFile(SmbFile context,
               String name)
        throws MalformedURLException,
               UnknownHostException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. The second parameter is a relative path from the parent SmbFile. See the description above for examples of using the second name parameter.
    
    パラメータ:
    
    context - A base SmbFile
    
    name - A path string relative to the parent paremeter
    
    例外:
    
    MalformedURLException - If the parent and child parameters do not follow the prescribed syntax
    
    UnknownHostException - If the server or workgroup of the context file cannot be determined
  - SmbFile
```
public SmbFile(String context,
               String name)
        throws MalformedURLException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. The second parameter is a relative path from the parent. See the description above for examples of using the second chile parameter.
    
    パラメータ:
    
    context - A URL string
    
    name - A path string relative to the context paremeter
    
    例外:
    
    MalformedURLException - If the context and name parameters do not follow the prescribed syntax
  - SmbFile
```
public SmbFile(String url,
               NtlmPasswordAuthentication auth)
        throws MalformedURLException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory.
    
    パラメータ:
    
    url - A URL string
    
    auth - The credentials the client should use for authentication
    
    例外:
    
    MalformedURLException - If the url parameter does not follow the prescribed syntax
  - SmbFile
```
public SmbFile(String url,
               NtlmPasswordAuthentication auth,
               int shareAccess)
        throws MalformedURLException
```
    Constructs an SmbFile representing a file on an SMB network. The shareAccess parameter controls what permissions other clients have when trying to access the same file while this instance is still open. This value is either FILE_NO_SHARE or any combination of FILE_SHARE_READ, FILE_SHARE_WRITE, and FILE_SHARE_DELETE logically OR'd together.
    
    パラメータ:
    
    url - A URL string
    
    auth - The credentials the client should use for authentication
    
    shareAccess - Specifies what access other clients have while this file is open.
    
    例外:
    
    MalformedURLException - If the url parameter does not follow the prescribed syntax
  - SmbFile
```
public SmbFile(String context,
               String name,
               NtlmPasswordAuthentication auth)
        throws MalformedURLException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. The second parameter is a relative path from the context. See the description above for examples of using the second name parameter.
    
    パラメータ:
    
    context - A URL string
    
    name - A path string relative to the context paremeter
    
    auth - The credentials the client should use for authentication
    
    例外:
    
    MalformedURLException - If the context and name parameters do not follow the prescribed syntax
  - SmbFile
```
public SmbFile(String context,
               String name,
               NtlmPasswordAuthentication auth,
               int shareAccess)
        throws MalformedURLException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. The second parameter is a relative path from the context. See the description above for examples of using the second name parameter. The shareAccess parameter controls what permissions other clients have when trying to access the same file while this instance is still open. This value is either FILE_NO_SHARE or any combination of FILE_SHARE_READ, FILE_SHARE_WRITE, and FILE_SHARE_DELETE logically OR'd together.
    
    パラメータ:
    
    context - A URL string
    
    name - A path string relative to the context paremeter
    
    auth - The credentials the client should use for authentication
    
    shareAccess - Specifies what access other clients have while this file is open.
    
    例外:
    
    MalformedURLException - If the context and name parameters do not follow the prescribed syntax
  - SmbFile
```
public SmbFile(SmbFile context,
               String name,
               int shareAccess)
        throws MalformedURLException,
               UnknownHostException
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory. The second parameter is a relative path from the context. See the description above for examples of using the second name parameter. The shareAccess parameter controls what permissions other clients have when trying to access the same file while this instance is still open. This value is either FILE_NO_SHARE or any combination of FILE_SHARE_READ, FILE_SHARE_WRITE, and FILE_SHARE_DELETE logically OR'd together.
    
    パラメータ:
    
    context - A base SmbFile
    
    name - A path string relative to the context file path
    
    shareAccess - Specifies what access other clients have while this file is open.
    
    例外:
    
    MalformedURLException - If the context and name parameters do not follow the prescribed syntax
    
    UnknownHostException
  - SmbFile
```
public SmbFile(URL url)
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory from a URL object.
    
    パラメータ:
    
    url - The URL of the target resource
  - SmbFile
```
public SmbFile(URL url,
               NtlmPasswordAuthentication auth)
```
    Constructs an SmbFile representing a resource on an SMB network such as a file or directory from a URL object and an NtlmPasswordAuthentication object.
    
    パラメータ:
    
    url - The URL of the target resource
    
    auth - The credentials the client should use for authentication
- メソッドの詳細
  - connect
```
public void connect()
             throws IOException
```
    It is not necessary to call this method directly. This is the URLConnection implementation of connect().
    
    定義:
    
    connect クラス内 URLConnection
    
    例外:
    
    IOException
  - getPrincipal
```
public Principal getPrincipal()
```
    Returns the NtlmPasswordAuthentication object used as credentials with this file or pipe. This can be used to retrieve the username for example: String username = f.getPrincipal().getName(); The Principal object returned will never be null however the username can be null indication anonymous credentials were used (e.g. some IPC$ services).
  - getName
```
public String getName()
```
    Returns the last component of the target URL. This will effectively be the name of the file or directory represented by this SmbFile or in the case of URLs that only specify a server or workgroup, the server or workgroup will be returned. The name of the root URL smb:// is also smb://. If this SmbFile refers to a workgroup, server, share, or directory, the name will include a trailing slash '/' so that composing new SmbFiles will maintain the trailing slash requirement.
    
    戻り値:
    
    The last component of the URL associated with this SMB resource or smb:// if the resource is smb:// itself.
  - getParent
```
public String getParent()
```
    Everything but the last component of the URL representing this SMB resource is effectivly it's parent. The root URL smb:// does not have a parent. In this case smb:// is returned.
    
    戻り値:
    
    The parent directory of this SMB resource or smb:// if the resource refers to the root of the URL hierarchy which incedentally is also smb://.
  - getPath
```
public String getPath()
```
    Returns the full uncanonicalized URL of this SMB resource. An SmbFile constructed with the result of this method will result in an SmbFile that is equal to the original.
    
    戻り値:
    
    The uncanonicalized full URL of this SMB resource.
  - getUncPath
```
public String getUncPath()
```
    Retuns the Windows UNC style path with backslashs intead of forward slashes.
    
    戻り値:
    
    The UNC path.
  - getCanonicalPath
```
public String getCanonicalPath()
```
    Returns the full URL of this SMB resource with '.' and '..' components factored out. An SmbFile constructed with the result of this method will result in an SmbFile that is equal to the original.
    
    戻り値:
    
    The canonicalized URL of this SMB resource.
  - getShare
```
public String getShare()
```
    Retrieves the share associated with this SMB resource. In the case of smb://, smb://workgroup/, and smb://server/ URLs which do not specify a share, null will be returned.
    
    戻り値:
    
    The share component or null if there is no share
  - getServer
```
public String getServer()
```
    Retrieve the hostname of the server for this SMB resource. If this SmbFile references a workgroup, the name of the workgroup is returned. If this SmbFile refers to the root of this SMB network hierarchy, null is returned.
    
    戻り値:
    
    The server or workgroup name or null if this SmbFile refers to the root smb:// resource.
  - getType
```
public int getType()
            throws SmbException
```
    Returns type of of object this SmbFile represents.
    
    戻り値:
    
    TYPE_FILESYSTEM, TYPE_WORKGROUP, TYPE_SERVER, TYPE_SHARE, TYPE_PRINTER, TYPE_NAMED_PIPE, or TYPE_COMM.
    
    例外:
    
    SmbException
  - exists
```
public boolean exists()
               throws SmbException
```
    Tests to see if the SMB resource exists. If the resource refers only to a server, this method determines if the server exists on the network and is advertising SMB services. If this resource refers to a workgroup, this method determines if the workgroup name is valid on the local SMB network. If this SmbFile refers to the root smb:// resource true is always returned. If this SmbFile is a traditional file or directory, it will be queried for on the specified server as expected.
    
    戻り値:
    
    true if the resource exists or is alive or false otherwise
    
    例外:
    
    SmbException
  - canRead
```
public boolean canRead()
                throws SmbException
```
    Tests to see if the file this SmbFile represents can be read. Because any file, directory, or other resource can be read if it exists, this method simply calls the exists method.
    
    戻り値:
    
    true if the file is read-only
    
    例外:
    
    SmbException
  - canWrite
```
public boolean canWrite()
                 throws SmbException
```
    Tests to see if the file this SmbFile represents exists and is not marked read-only. By default, resources are considered to be read-only and therefore for smb://, smb://workgroup/, and smb://server/ resources will be read-only.
    
    戻り値:
    
    true if the resource exists is not marked read-only
    
    例外:
    
    SmbException
  - isDirectory
```
public boolean isDirectory()
                    throws SmbException
```
    Tests to see if the file this SmbFile represents is a directory.
    
    戻り値:
    
    true if this SmbFile is a directory
    
    例外:
    
    SmbException
  - isFile
```
public boolean isFile()
               throws SmbException
```
    Tests to see if the file this SmbFile represents is not a directory.
    
    戻り値:
    
    true if this SmbFile is not a directory
    
    例外:
    
    SmbException
  - isHidden
```
public boolean isHidden()
                 throws SmbException
```
    Tests to see if the file this SmbFile represents is marked as hidden. This method will also return true for shares with names that end with '$' such as IPC$ or C$.
    
    戻り値:
    
    true if the SmbFile is marked as being hidden
    
    例外:
    
    SmbException
  - getDfsPath
```
public String getDfsPath()
                  throws SmbException
```
    If the path of this SmbFile falls within a DFS volume, this method will return the referral path to which it maps. Otherwise null is returned.
    
    例外:
    
    SmbException
  - createTime
```
public long createTime()
                throws SmbException
```
    Retrieve the time this SmbFile was created. The value returned is suitable for constructing a Date object (i.e. seconds since Epoch 1970). Times should be the same as those reported using the properties dialog of the Windows Explorer program. For Win95/98/Me this is actually the last write time. It is currently not possible to retrieve the create time from files on these systems.
    
    戻り値:
    
    The number of milliseconds since the 00:00:00 GMT, January 1, 1970 as a long value
    
    例外:
    
    SmbException
  - lastModified
```
public long lastModified()
                  throws SmbException
```
    Retrieve the last time the file represented by this SmbFile was modified. The value returned is suitable for constructing a Date object (i.e. seconds since Epoch 1970). Times should be the same as those reported using the properties dialog of the Windows Explorer program.
    
    戻り値:
    
    The number of milliseconds since the 00:00:00 GMT, January 1, 1970 as a long value
    
    例外:
    
    SmbException
  - list
```
public String[] list()
              throws SmbException
```
    List the contents of this SMB resource. The list returned by this method will be;
    - files and directories contained within this resource if the resource is a normal disk file directory,
    - all available NetBIOS workgroups or domains if this resource is the top level URL smb://,
    - all servers registered as members of a NetBIOS workgroup if this resource refers to a workgroup in a smb://workgroup/ URL,
    - all browseable shares of a server including printers, IPC services, or disk volumes if this resource is a server URL in the form smb://server/,
    - or null if the resource cannot be resolved.
    戻り値:
    
    A String[] array of files and directories, workgroups, servers, or shares depending on the context of the resource URL
    
    例外:
    
    SmbException
  - list
```
public String[] list(SmbFilenameFilter filter)
              throws SmbException
```
    List the contents of this SMB resource. The list returned will be identical to the list returned by the parameterless list() method minus filenames filtered by the specified filter.
    
    パラメータ:
    
    filter - a filename filter to exclude filenames from the results
    
    例外:
    
    SmbException - # @return An array of filenames
  - listFiles
```
public SmbFile[] listFiles()
                    throws SmbException
```
    List the contents of this SMB resource as an array of SmbFile objects. This method is much more efficient than the regular list method when querying attributes of each file in the result set.
    The list of SmbFiles returned by this method will be;
    - files and directories contained within this resource if the resource is a normal disk file directory,
    - all available NetBIOS workgroups or domains if this resource is the top level URL smb://,
    - all servers registered as members of a NetBIOS workgroup if this resource refers to a workgroup in a smb://workgroup/ URL,
    - all browseable shares of a server including printers, IPC services, or disk volumes if this resource is a server URL in the form smb://server/,
    - or null if the resource cannot be resolved.
    戻り値:
    
    An array of SmbFile objects representing file and directories, workgroups, servers, or shares depending on the context of the resource URL
    
    例外:
    
    SmbException
  - listFiles
```
public SmbFile[] listFiles(String wildcard)
                    throws SmbException
```
    The CIFS protocol provides for DOS "wildcards" to be used as a performance enhancement. The client does not have to filter the names and the server does not have to return all directory entries.
    The wildcard expression may consist of two special meta characters in addition to the normal filename characters. The '*' character matches any number of characters in part of a name. If the expression begins with one or more '?'s then exactly that many characters will be matched whereas if it ends with '?'s it will match that many characters or less.
    Wildcard expressions will not filter workgroup names or server names.
    winnt> ls c?o* clock.avi -rw-- 82944 Mon Oct 14 1996 1:38 AM Cookies drw-- 0 Fri Nov 13 1998 9:42 PM 2 items in 5ms
    パラメータ:
    
    wildcard - a wildcard expression
    
    戻り値:
    
    An array of SmbFile objects representing file and directories, workgroups, servers, or shares depending on the context of the resource URL
    
    例外:
    
    SmbException
  - listFiles
```
public SmbFile[] listFiles(SmbFilenameFilter filter)
                    throws SmbException
```
    List the contents of this SMB resource. The list returned will be identical to the list returned by the parameterless listFiles() method minus files filtered by the specified filename filter.
    
    パラメータ:
    
    filter - a filter to exclude files from the results
    
    戻り値:
    
    An array of SmbFile objects
    
    例外:
    
    SmbException
  - listFiles
```
public SmbFile[] listFiles(SmbFileFilter filter)
                    throws SmbException
```
    List the contents of this SMB resource. The list returned will be identical to the list returned by the parameterless listFiles() method minus filenames filtered by the specified filter.
    
    パラメータ:
    
    filter - a file filter to exclude files from the results
    
    戻り値:
    
    An array of SmbFile objects
    
    例外:
    
    SmbException
  - renameTo
```
public void renameTo(SmbFile dest)
              throws SmbException
```
    Changes the name of the file this SmbFile represents to the name designated by the SmbFile argument.
    Remember: SmbFiles are immutible and therefore the path associated with this SmbFile object will not change). To access the renamed file it is necessary to construct a new SmbFile.
    
    パラメータ:
    
    dest - An SmbFile that represents the new pathname
    
    例外:
    
    NullPointerException - If the dest argument is null
    
    SmbException
  - copyTo
```
public void copyTo(SmbFile dest)
            throws SmbException
```
    This method will copy the file or directory represented by this SmbFile and it's sub-contents to the location specified by the dest parameter. This file and the destination file do not need to be on the same host. This operation does not copy extended file attibutes such as ACLs but it does copy regular attributes as well as create and last write times. This method is almost twice as efficient as manually copying as it employs an additional write thread to read and write data concurrently.
    It is not possible (nor meaningful) to copy entire workgroups or servers.
    
    パラメータ:
    
    dest - the destination file or directory
    
    例外:
    
    SmbException
  - delete
```
public void delete()
            throws SmbException
```
    This method will delete the file or directory specified by this SmbFile. If the target is a directory, the contents of the directory will be deleted as well. If a file within the directory or it's sub-directories is marked read-only, the read-only status will be removed and the file will be deleted.
    
    例外:
    
    SmbException
  - length
```
public long length()
            throws SmbException
```
    Returns the length of this SmbFile in bytes. If this object is a TYPE_SHARE the total capacity of the disk shared in bytes is returned. If this object is a directory or a type other than TYPE_SHARE, 0L is returned.
    
    戻り値:
    
    The length of the file in bytes or 0 if this SmbFile is not a file.
    
    例外:
    
    SmbException
  - getDiskFreeSpace
```
public long getDiskFreeSpace()
                      throws SmbException
```
    This method returns the free disk space in bytes of the drive this share represents or the drive on which the directory or file resides. Objects other than TYPE_SHARE or TYPE_FILESYSTEM will result in 0L being returned.
    
    戻り値:
    
    the free disk space in bytes of the drive on which this file or directory resides
    
    例外:
    
    SmbException
  - mkdir
```
public void mkdir()
           throws SmbException
```
    Creates a directory with the path specified by this SmbFile. For this method to be successful, the target must not already exist. This method will fail when used with smb://, smb://workgroup/, smb://server/, or smb://server/share/ URLs because workgroups, servers, and shares cannot be dynamically created (although in the future it may be possible to create shares).
    
    例外:
    
    SmbException
  - mkdirs
```
public void mkdirs()
            throws SmbException
```
    Creates a directory with the path specified by this SmbFile and any parent directories that do not exist. This method will fail when used with smb://, smb://workgroup/, smb://server/, or smb://server/share/ URLs because workgroups, servers, and shares cannot be dynamically created (although in the future it may be possible to create shares).
    
    例外:
    
    SmbException
  - createNewFile
```
public void createNewFile()
                   throws SmbException
```
    Create a new file but fail if it already exists. The check for existance of the file and it's creation are an atomic operation with respect to other filesystem activities.
    
    例外:
    
    SmbException
  - setCreateTime
```
public void setCreateTime(long time)
                   throws SmbException
```
    Set the create time of the file. The time is specified as milliseconds from Jan 1, 1970 which is the same as that which is returned by the createTime() method.
    This method does not apply to workgroups, servers, or shares.
    
    パラメータ:
    
    time - the create time as milliseconds since Jan 1, 1970
    
    例外:
    
    SmbException
  - setLastModified
```
public void setLastModified(long time)
                     throws SmbException
```
    Set the last modified time of the file. The time is specified as milliseconds from Jan 1, 1970 which is the same as that which is returned by the lastModified(), getLastModified(), and getDate() methods.
    This method does not apply to workgroups, servers, or shares.
    
    パラメータ:
    
    time - the last modified time as milliseconds since Jan 1, 1970
    
    例外:
    
    SmbException
  - getAttributes
```
public int getAttributes()
                  throws SmbException
```
    Return the attributes of this file. Attributes are represented as a bitset that must be masked with ATTR_* constants to determine if they are set or unset. The value returned is suitable for use with the setAttributes() method.
    
    戻り値:
    
    the ATTR_* attributes associated with this file
    
    例外:
    
    SmbException
  - setAttributes
```
public void setAttributes(int attrs)
                   throws SmbException
```
    Set the attributes of this file. Attributes are composed into a bitset by bitwise ORing the ATTR_* constants. Setting the value returned by getAttributes will result in both files having the same attributes.
    
    例外:
    
    SmbException
  - setReadOnly
```
public void setReadOnly()
                 throws SmbException
```
    Make this file read-only. This is shorthand for setAttributes( getAttributes() | ATTR_READ_ONLY ).
    
    例外:
    
    SmbException
  - setReadWrite
```
public void setReadWrite()
                  throws SmbException
```
    Turn off the read-only attribute of this file. This is shorthand for setAttributes( getAttributes() & ~ATTR_READONLY ).
    
    例外:
    
    SmbException
  - toURL
```
public URL toURL()
          throws MalformedURLException
```
    非推奨です。 Use getURL() instead
    
    Returns a URL for this SmbFile. The URL may be used as any other URL might to access an SMB resource. Currently only retrieving data and information is supported (i.e. no doOutput).
    
    戻り値:
    
    A new URL for this SmbFile
    
    例外:
    
    MalformedURLException
  - hashCode
```
public int hashCode()
```
    Computes a hashCode for this file based on the URL string and IP address if the server. The hashing function uses the hashcode of the server address, the canonical representation of the URL, and does not compare authentication information. In essance, two SmbFile objects that refer to the same file should generate the same hashcode provided it is possible to make such a determination.
    
    オーバーライド:
    
    hashCode クラス内 Object
    
    戻り値:
    
    A hashcode for this abstract file
    
    例外:
    
    SmbException
  - pathNamesPossiblyEqual
```
protected boolean pathNamesPossiblyEqual(String path1,
                                         String path2)
```
  - equals
```
public boolean equals(Object obj)
```
    Tests to see if two SmbFile objects are equal. Two SmbFile objects are equal when they reference the same SMB resource. More specifically, two SmbFile objects are equals if their server IP addresses are equal and the canonicalized representation of their URLs, minus authentication parameters, are case insensitivly and lexographically equal.
    For example, assuming the server angus resolves to the 192.168.1.15 IP address, the below URLs would result in SmbFiles that are equal.
    smb://192.168.1.15/share/DIR/foo.txt smb://angus/share/data/../dir/foo.txt
    オーバーライド:
    
    equals クラス内 Object
    
    パラメータ:
    
    obj - Another SmbFile object to compare for equality
    
    戻り値:
    
    true if the two objects refer to the same SMB resource and false otherwise
    
    例外:
    
    SmbException
  - toString
```
public String toString()
```
    Returns the string representation of this SmbFile object. This will be the same as the URL used to construct this SmbFile. This method will return the same value as getPath.
    
    オーバーライド:
    
    toString クラス内 URLConnection
    
    戻り値:
    
    The original URL representation of this SMB resource
    
    例外:
    
    SmbException
  - getContentLength
```
public int getContentLength()
```
    This URLConnection method just returns the result of length().
    
    オーバーライド:
    
    getContentLength クラス内 URLConnection
    
    戻り値:
    
    the length of this file or 0 if it refers to a directory
  - getDate
```
public long getDate()
```
    This URLConnection method just returns the result of lastModified.
    
    オーバーライド:
    
    getDate クラス内 URLConnection
    
    戻り値:
    
    the last modified data as milliseconds since Jan 1, 1970
  - getLastModified
```
public long getLastModified()
```
    This URLConnection method just returns the result of lastModified.
    
    オーバーライド:
    
    getLastModified クラス内 URLConnection
    
    戻り値:
    
    the last modified data as milliseconds since Jan 1, 1970
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    This URLConnection method just returns a new SmbFileInputStream created with this file.
    
    オーバーライド:
    
    getInputStream クラス内 URLConnection
    
    例外:
    
    IOException - thrown by SmbFileInputStream constructor
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    This URLConnection method just returns a new SmbFileOutputStream created with this file.
    
    オーバーライド:
    
    getOutputStream クラス内 URLConnection
    
    例外:
    
    IOException - thrown by SmbFileOutputStream constructor
  - getSecurity
```
public ACE[] getSecurity(boolean resolveSids)
                  throws IOException
```
    Return an array of Access Control Entry (ACE) objects representing the security descriptor associated with this file or directory. If no DACL is present, null is returned. If the DACL is empty, an array with 0 elements is returned.
    
    パラメータ:
    
    resolveSids - Attempt to resolve the SIDs within each ACE form their numeric representation to their corresponding account names.
    
    例外:
    
    IOException
  - getShareSecurity
```
public ACE[] getShareSecurity(boolean resolveSids)
                       throws IOException
```
    Return an array of Access Control Entry (ACE) objects representing the share permissions on the share exporting this file or directory. If no DACL is present, null is returned. If the DACL is empty, an array with 0 elements is returned.
    Note that this is different from calling getSecurity on a share. There are actually two different ACLs for shares - the ACL on the share and the ACL on the folder being shared. Go to Computer Management > System Tools > Shared Folders > Shares and look at the Properties for a share. You will see two tabs - one for "Share Permissions" and another for "Security". These correspond to the ACLs returned by getShareSecurity and getSecurity respectively.
    
    パラメータ:
    
    resolveSids - Attempt to resolve the SIDs within each ACE form their numeric representation to their corresponding account names.
    
    例外:
    
    IOException
  - getSecurity
```
public ACE[] getSecurity()
                  throws IOException
```
    Return an array of Access Control Entry (ACE) objects representing the security descriptor associated with this file or directory.
    Initially, the SIDs within each ACE will not be resolved however when getType(), getDomainName(), getAccountName(), or toString() is called, the names will attempt to be resolved. If the names cannot be resolved (e.g. due to temporary network failure), the said methods will return default values (usually S-X-Y-Z strings of fragments of).
    Alternatively getSecurity(true) may be used to resolve all SIDs together and detect network failures.
    
    例外:
    
    IOException
  - getOwnerUser
```
public SID getOwnerUser()
                 throws IOException
```
    例外:
    
    IOException
  - getOwnerGroup
```
public SID getOwnerGroup()
                  throws IOException
```
    例外:
    
    IOException

クラス SmbFile

フィールドのサマリー

クラスから継承されたフィールド java.net.URLConnection

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.net.URLConnection

クラスから継承されたメソッド java.lang.Object

フィールドの詳細

FILE_NO_SHARE

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

ATTR_READONLY

ATTR_HIDDEN

ATTR_SYSTEM

ATTR_VOLUME

ATTR_DIRECTORY

ATTR_ARCHIVE

TYPE_FILESYSTEM

TYPE_WORKGROUP

TYPE_SERVER

TYPE_SHARE

TYPE_NAMED_PIPE

TYPE_PRINTER

TYPE_COMM

dfs

DEFAULT_PORT

DEFAULT_MAX_MPX_COUNT

DEFAULT_RESPONSE_TIMEOUT

DEFAULT_SO_TIMEOUT

DEFAULT_RCV_BUF_SIZE

DEFAULT_SND_BUF_SIZE

DEFAULT_SSN_LIMIT

DEFAULT_CONN_TIMEOUT

LADDR

LPORT

MAX_MPX_COUNT

SND_BUF_SIZE

RCV_BUF_SIZE

USE_UNICODE

FORCE_UNICODE

USE_NTSTATUS

SIGNPREF

USE_NTSMBS

USE_EXTSEC

NETBIOS_HOSTNAME

LM_COMPATIBILITY

FLAGS_NONE

FLAGS_LOCK_AND_READ_WRITE_AND_UNLOCK

FLAGS_RECEIVE_BUFFER_POSTED

FLAGS_PATH_NAMES_CASELESS

FLAGS_PATH_NAMES_CANONICALIZED

FLAGS_OPLOCK_REQUESTED_OR_GRANTED

FLAGS_NOTIFY_OF_MODIFY_ACTION

FLAGS_RESPONSE

FLAGS2_NONE

FLAGS2_LONG_FILENAMES

FLAGS2_EXTENDED_ATTRIBUTES

FLAGS2_SECURITY_SIGNATURES

FLAGS2_EXTENDED_SECURITY_NEGOTIATION

FLAGS2_RESOLVE_PATHS_IN_DFS

FLAGS2_PERMIT_READ_IF_EXECUTE_PERM

FLAGS2_STATUS32

FLAGS2_UNICODE

CAP_NONE

CAP_RAW_MODE

CAP_MPX_MODE

CAP_UNICODE

CAP_LARGE_FILES

CAP_NT_SMBS

CAP_RPC_REMOTE_APIS

CAP_STATUS32

CAP_LEVEL_II_OPLOCKS

CAP_LOCK_AND_READ

CAP_NT_FIND

CAP_DFS

CAP_EXTENDED_SECURITY

FILE_READ_DATA

FILE_WRITE_DATA

FILE_APPEND_DATA