パッケージ jcifs.smb

クラス SmbFile

  • すべての実装されたインタフェース:
    AutoCloseable, SmbConstants, SmbResource
    直系の既知のサブクラス:
    SmbNamedPipe
    public class SmbFile
extends URLConnection
implements SmbResource, SmbConstants
    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 relatively 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://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://server/share/path/to/dir <-- ILLEGAL URLs that represent servers, shares, or directories require a trailing slash '/'.

    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 constructor 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/

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

    関連項目:
    File

    • フィールドの詳細

      • DEFAULT_ATTR_EXPIRATION_PERIOD

        protected static final int DEFAULT_ATTR_EXPIRATION_PERIOD
        関連項目:
        定数フィールド値

      • HASH_DOT

        protected static final int HASH_DOT

      • HASH_DOT_DOT

        protected static final int HASH_DOT_DOT

      • fileLocator

        protected final jcifs.smb.SmbResourceLocatorImpl fileLocator

    • コンストラクタの詳細

      • SmbFile

        @Deprecated
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

        @Deprecated
public SmbFile​(URL url)
        throws MalformedURLException
        推奨されていません。
        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
        例外:
        MalformedURLException

      • SmbFile

        public SmbFile​(SmbResource 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 parameter
        例外:
        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

    • メソッドの詳細

      • close

        public void close()
        Close/release the file This releases all resources that this file holds. If not using strict mode this is currently a no-op.
        定義:
        close インタフェース内 AutoCloseable
        定義:
        close インタフェース内 SmbResource
        関連項目:
        AutoCloseable.close()

      • setNonPooled

        protected void setNonPooled​(boolean nonPooled)
        パラメータ:
        nonPooled - whether this file will use an exclusive connection

      • getTransportContext

        @Deprecated
public CIFSContext getTransportContext()
        推奨されていません。
        戻り値:
        the transportContext

      • getContext

        public CIFSContext getContext()
        インタフェースからコピーされた説明: SmbResource
        The context this file was opened with
        定義:
        getContext インタフェース内 SmbResource
        戻り値:
        the context associated with this file

      • getLocator

        public SmbResourceLocator getLocator()
        インタフェースからコピーされた説明: SmbResource
        Gets the file locator for this file The file locator provides details about
        定義:
        getLocator インタフェース内 SmbResource
        戻り値:
        the fileLocator

      • getUncPath

        public String getUncPath()
        戻り値:
        this file's unc path below the share

      • exists

        public boolean exists()
               throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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 SmbResource refers to the root smb:// resource true is always returned. If this SmbResource is a traditional file or directory, it will be queried for on the specified server as expected.
        定義:
        exists インタフェース内 SmbResource
        戻り値:
        true if the resource exists or is alive or false otherwise
        例外:
        SmbException

      • getType

        public int getType()
            throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Returns type of of object this SmbResource represents.
        定義:
        getType インタフェース内 SmbResource
        戻り値:
        TYPE_FILESYSTEM, TYPE_WORKGROUP, TYPE_SERVER, TYPE_SHARE, TYPE_PRINTER, TYPE_NAMED_PIPE, or TYPE_COMM.
        例外:
        SmbException

      • getName

        public String getName()
        インタフェースからコピーされた説明: SmbResource
        Returns the last component of the target URL. This will effectively be the name of the file or directory represented by this SmbResource 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 SmbResource refers to a workgroup, server, share, or directory, the name will include a trailing slash '/' so that composing new SmbResources will maintain the trailing slash requirement.
        定義:
        getName インタフェース内 SmbResource
        戻り値:
        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 effectively 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 incidentally 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.

      • getCanonicalUncPath

        public String getCanonicalUncPath()
        Returns the Windows UNC style path with backslashes instead of forward slashes.
        戻り値:
        The UNC path.

      • 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.
        戻り値:
        URL to the DFS volume
        例外:
        SmbException

      • 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

      • getServerWithDfs

        public String getServerWithDfs()
        Retrieve the hostname of the server for this SMB resource. If the resources has been resolved by DFS this will return the target name.
        戻り値:
        The server name

      • 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.

      • watch

        public SmbWatchHandle watch​(int filter,
                            boolean recursive)
                     throws CIFSException
        インタフェースからコピーされた説明: SmbResource
        Creates a directory watch The server will notify the client when there are changes to the directories contents
        定義:
        watch インタフェース内 SmbResource
        パラメータ:
        filter - see constants in FileNotifyInformation
        recursive - whether to also watch subdirectories
        戻り値:
        watch context, needs to be closed when finished
        例外:
        CIFSException

      • canRead

        public boolean canRead()
                throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Tests to see if the file this SmbResource represents can be read. Because any file, directory, or other resource can be read if it exists, this method simply calls the exists method.
        定義:
        canRead インタフェース内 SmbResource
        戻り値:
        true if the file is read-only
        例外:
        SmbException

      • canWrite

        public boolean canWrite()
                 throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Tests to see if the file this SmbResource 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.
        定義:
        canWrite インタフェース内 SmbResource
        戻り値:
        true if the resource exists is not marked read-only
        例外:
        SmbException

      • isDirectory

        public boolean isDirectory()
                    throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Tests to see if the file this SmbResource represents is a directory.
        定義:
        isDirectory インタフェース内 SmbResource
        戻り値:
        true if this SmbResource is a directory
        例外:
        SmbException

      • isFile

        public boolean isFile()
               throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Tests to see if the file this SmbResource represents is not a directory.
        定義:
        isFile インタフェース内 SmbResource
        戻り値:
        true if this SmbResource is not a directory
        例外:
        SmbException

      • isHidden

        public boolean isHidden()
                 throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Tests to see if the file this SmbResource represents is marked as hidden. This method will also return true for shares with names that end with '$' such as IPC$ or C$.
        定義:
        isHidden インタフェース内 SmbResource
        戻り値:
        true if the SmbResource is marked as being hidden
        例外:
        SmbException

      • createTime

        public long createTime()
                throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Retrieve the time this SmbResource 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.
        定義:
        createTime インタフェース内 SmbResource
        戻り値:
        The number of milliseconds since the 00:00:00 GMT, January 1, 1970 as a long value
        例外:
        SmbException

      • lastModified

        public long lastModified()
                  throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Retrieve the last time the file represented by this SmbResource 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.
        定義:
        lastModified インタフェース内 SmbResource
        戻り値:
        The number of milliseconds since the 00:00:00 GMT, January 1, 1970 as a long value
        例外:
        SmbException

      • lastAccess

        public long lastAccess()
                throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Retrieve the last acces time of the file represented by this SmbResource
        定義:
        lastAccess インタフェース内 SmbResource
        戻り値:
        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
        戻り値:
        String[] array of matching files and directories, workgroups, servers, or shares depending on the context of the resource URL
        例外:
        SmbException - # @return An array of filenames

      • listFiles

        public SmbFile[] listFiles()
                    throws SmbException
        List the contents of this SMB resource as an array of SmbResource 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 SmbResources 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.
        If strict resource lifecycle is used, make sure you close the individual files after use.
        戻り値:
        An array of SmbResource 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
        If strict resource lifecycle is used, make sure you close the individual files after use.
        パラメータ:
        wildcard - a wildcard expression
        戻り値:
        An array of SmbResource 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. If strict resource lifecycle is used, make sure you close the individual files after use.
        パラメータ:
        filter - a filter to exclude files from the results
        戻り値:
        An array of SmbResource 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. If strict resource lifecycle is used, make sure you close the individual files after use.
        パラメータ:
        filter - a file filter to exclude files from the results
        戻り値:
        An array of SmbResource objects
        例外:
        SmbException

      • children

        public CloseableIterator<SmbResource> children​(String wildcard)
                                        throws CIFSException
        インタフェースからコピーされた説明: SmbResource
        Fetch children matching pattern, server-side filtering

        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.

        定義:
        children インタフェース内 SmbResource
        戻り値:
        an iterator over the child resources
        例外:
        CIFSException

      • renameTo

        public void renameTo​(SmbResource d)
              throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Changes the name of the file this SmbResource represents to the name designated by the SmbResource argument.
        Remember: SmbResources are immutable and therefore the path associated with this SmbResource object will not change). To access the renamed file it is necessary to construct a new SmbResource.
        定義:
        renameTo インタフェース内 SmbResource
        パラメータ:
        d - An SmbResource that represents the new pathname
        例外:
        SmbException

      • renameTo

        public void renameTo​(SmbResource d,
                     boolean replace)
              throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Changes the name of the file this SmbResource represents to the name designated by the SmbResource argument.
        Remember: SmbResources are immutable and therefore the path associated with this SmbResource object will not change). To access the renamed file it is necessary to construct a new SmbResource.
        定義:
        renameTo インタフェース内 SmbResource
        パラメータ:
        d - An SmbResource that represents the new pathname
        replace - Whether an existing destination file should be replaced (only supported with SMB2)
        例外:
        SmbException

      • copyTo

        public void copyTo​(SmbResource d)
            throws SmbException
        インタフェースからコピーされた説明: SmbResource
        This method will copy the file or directory represented by this SmbResource 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 attributes 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.
        定義:
        copyTo インタフェース内 SmbResource
        パラメータ:
        d - the destination file or directory
        例外:
        SmbException

      • delete

        public void delete()
            throws SmbException
        インタフェースからコピーされた説明: SmbResource
        This method will delete the file or directory specified by this SmbResource. 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. If the file has been opened before, it will be closed.
        定義:
        delete インタフェース内 SmbResource
        例外:
        SmbException

      • length

        public long length()
            throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Returns the length of this SmbResource 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.
        定義:
        length インタフェース内 SmbResource
        戻り値:
        The length of the file in bytes or 0 if this SmbResource is not a file.
        例外:
        SmbException

      • getDiskFreeSpace

        public long getDiskFreeSpace()
                      throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        getDiskFreeSpace インタフェース内 SmbResource
        戻り値:
        the free disk space in bytes of the drive on which this file or directory resides
        例外:
        SmbException

      • mkdir

        public void mkdir()
           throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Creates a directory with the path specified by this SmbResource. 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).
        定義:
        mkdir インタフェース内 SmbResource
        例外:
        SmbException

      • mkdirs

        public void mkdirs()
            throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Creates a directory with the path specified by this SmbResource 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).
        定義:
        mkdirs インタフェース内 SmbResource
        例外:
        SmbException

      • createNewFile

        public void createNewFile()
                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Create a new file but fail if it already exists. The check for existence of the file and it's creation are an atomic operation with respect to other filesystem activities.
        定義:
        createNewFile インタフェース内 SmbResource
        例外:
        SmbException

      • setCreateTime

        public void setCreateTime​(long time)
                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        setCreateTime インタフェース内 SmbResource
        パラメータ:
        time - the create time as milliseconds since Jan 1, 1970
        例外:
        SmbUnsupportedOperationException - if CAP_NT_SMBS is unavailable
        SmbException

      • setLastModified

        public void setLastModified​(long time)
                     throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        setLastModified インタフェース内 SmbResource
        パラメータ:
        time - the last modified time as milliseconds since Jan 1, 1970
        例外:
        SmbException

      • setLastAccess

        public void setLastAccess​(long time)
                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Set the last access 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.
        定義:
        setLastAccess インタフェース内 SmbResource
        パラメータ:
        time - the last access time as milliseconds since Jan 1, 1970
        例外:
        SmbUnsupportedOperationException - if CAP_NT_SMBS is unavailable
        SmbException

      • getAttributes

        public int getAttributes()
                  throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        getAttributes インタフェース内 SmbResource
        戻り値:
        the ATTR_* attributes associated with this file
        例外:
        SmbException

      • setAttributes

        public void setAttributes​(int attrs)
                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        setAttributes インタフェース内 SmbResource
        パラメータ:
        attrs - attribute flags
        例外:
        SmbException

      • setReadOnly

        public void setReadOnly()
                 throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Make this file read-only. This is shorthand for setAttributes( getAttributes() | ATTR_READ_ONLY ).
        定義:
        setReadOnly インタフェース内 SmbResource
        例外:
        SmbException

      • setReadWrite

        public void setReadWrite()
                  throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Turn off the read-only attribute of this file. This is shorthand for setAttributes( getAttributes() & ~ATTR_READONLY ).
        定義:
        setReadWrite インタフェース内 SmbResource
        例外:
        SmbException

      • toURL

        @Deprecated
public URL toURL()
        推奨されていません。
        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

      • 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 essence, 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

      • 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 insensitively 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

      • 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

      • getContentLength

        @Deprecated
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

      • openInputStream

        public SmbFileInputStream openInputStream​(int sharing)
                                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens an input stream reading the file (read only)
        定義:
        openInputStream インタフェース内 SmbResource
        パラメータ:
        sharing - flags indicating for which operations others may open the file (FILE_SHARING_*)
        戻り値:
        input stream, needs to be closed when finished
        例外:
        SmbException

      • openInputStream

        public SmbFileInputStream openInputStream​(int flags,
                                          int access,
                                          int sharing)
                                   throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens an input stream reading the file (read only)
        定義:
        openInputStream インタフェース内 SmbResource
        パラメータ:
        flags - open flags
        access - desired access flags
        sharing - flags indicating for which operations others may open the file (FILE_SHARING_*)
        戻り値:
        input stream, needs to be closed when finished
        例外:
        SmbException

      • openOutputStream

        public SmbFileOutputStream openOutputStream​(boolean append)
                                     throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens an output stream writing to the file (write only, read sharable)
        定義:
        openOutputStream インタフェース内 SmbResource
        パラメータ:
        append - whether to append to or truncate the input
        戻り値:
        output stream, needs to be closed when finished
        例外:
        SmbException

      • openOutputStream

        public SmbFileOutputStream openOutputStream​(boolean append,
                                            int sharing)
                                     throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens an output stream writing to the file (write only, exclusive write access)
        定義:
        openOutputStream インタフェース内 SmbResource
        パラメータ:
        append - whether to append to or truncate the input
        sharing - flags indicating for which operations others may open the file (FILE_SHARING_*)
        戻り値:
        output stream, needs to be closed when finished
        例外:
        SmbException

      • openOutputStream

        public SmbFileOutputStream openOutputStream​(boolean append,
                                            int openFlags,
                                            int access,
                                            int sharing)
                                     throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens an output stream writing to the file (write only, exclusive write access)
        定義:
        openOutputStream インタフェース内 SmbResource
        パラメータ:
        append - whether to append to or truncate the input
        openFlags - flags for open operation
        access - desired file access flags
        sharing - flags indicating for which operations others may open the file
        戻り値:
        output stream, needs to be closed when finished
        例外:
        SmbException

      • openRandomAccess

        public SmbRandomAccessFile openRandomAccess​(String mode,
                                            int sharing)
                                     throws SmbException
        インタフェースからコピーされた説明: SmbResource
        Opens the file for random access
        定義:
        openRandomAccess インタフェース内 SmbResource
        パラメータ:
        mode - access mode (r|rw)
        sharing - flags indicating for which operations others may concurrently open the file
        戻り値:
        random access file, needs to be closed when finished
        例外:
        SmbException

      • getSecurity

        public ACE[] getSecurity()
                  throws IOException
        インタフェースからコピーされた説明: SmbResource
        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.

        定義:
        getSecurity インタフェース内 SmbResource
        戻り値:
        array of ACEs
        例外:
        IOException

      • getSecurity

        public ACE[] getSecurity​(boolean resolveSids)
                  throws IOException
        インタフェースからコピーされた説明: SmbResource
        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.
        定義:
        getSecurity インタフェース内 SmbResource
        パラメータ:
        resolveSids - Attempt to resolve the SIDs within each ACE form their numeric representation to their corresponding account names.
        戻り値:
        array of ACEs
        例外:
        IOException

      • getOwnerUser

        public SID getOwnerUser()
                 throws IOException
        インタフェースからコピーされた説明: SmbResource
        Return the resolved owner user SID for this file or directory
        定義:
        getOwnerUser インタフェース内 SmbResource
        戻り値:
        the owner user SID, null if not present
        例外:
        IOException

      • getOwnerUser

        public SID getOwnerUser​(boolean resolve)
                 throws IOException
        インタフェースからコピーされた説明: SmbResource
        Return the owner user SID for this file or directory
        定義:
        getOwnerUser インタフェース内 SmbResource
        パラメータ:
        resolve - whether to resolve the user name
        戻り値:
        the owner user SID, null if not present
        例外:
        IOException

      • getOwnerGroup

        public SID getOwnerGroup()
                  throws IOException
        インタフェースからコピーされた説明: SmbResource
        Return the resolved owner group SID for this file or directory
        定義:
        getOwnerGroup インタフェース内 SmbResource
        戻り値:
        the owner group SID, null if not present
        例外:
        IOException

      • getOwnerGroup

        public SID getOwnerGroup​(boolean resolve)
                  throws IOException
        インタフェースからコピーされた説明: SmbResource
        Return the owner group SID for this file or directory
        定義:
        getOwnerGroup インタフェース内 SmbResource
        パラメータ:
        resolve - whether to resolve the group name
        戻り値:
        the owner group SID, null if not present
        例外:
        IOException

      • getShareSecurity

        public ACE[] getShareSecurity​(boolean resolveSids)
                       throws IOException
        インタフェースからコピーされた説明: SmbResource
        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.

        定義:
        getShareSecurity インタフェース内 SmbResource
        パラメータ:
        resolveSids - Attempt to resolve the SIDs within each ACE form their numeric representation to their corresponding account names.
        戻り値:
        array of ACEs
        例外:
        IOException