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
java.io.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 and renameTo 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.
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
ATTR_DIRECTORY
public static final int ATTR_DIRECTORY
A file with this bit on as returned by getAttributes() is
a directory
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_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_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
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_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.
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.
TYPE_COMM
public static final int TYPE_COMM
Returned by
getType()
if the resource this
SmbFile
represents is a communications device.
TYPE_FILESYSTEM
public static final int TYPE_FILESYSTEM
Returned by
getType()
if the resource this
SmbFile
represents is a regular file or directory.
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_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_WORKGROUP
public static final int TYPE_WORKGROUP
Returned by
getType()
if the resource this
SmbFile
represents is a workgroup.
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.
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 stringname
- A path string relative to the context
paremeter
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 stringname
- A path string relative to the context
paremeterauth
- The credentials the client should use for authentication
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 stringname
- A path string relative to the context
paremeterauth
- The credentials the client should use for authenticationshareAccess
- Specifies what access other clients have while this file is open.
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 stringauth
- The credentials the client should use for authentication
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 stringauth
- The credentials the client should use for authenticationshareAccess
- Specifies what access other clients have while this file is open.
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 resourceauth
- The credentials the client should use for authentication
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
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 pathshareAccess
- Specifies what access other clients have while this file is open.
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
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
connect
public void connect()
throws IOException
It is not necessary to call this method directly. This is the
URLConnection implementation of connect().
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
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.
createTime
public long createTime()
throws SmbException
Retrieve the time this SmbFile
was created. The value
returned is suitable for constructing a java.util.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
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.
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
SmbFile
s that are equal.
smb://192.168.1.15/share/DIR/foo.txt
smb://angus/share/data/../dir/foo.txt
obj
- Another SmbFile
object to compare for equality
true
if the two objects refer to the same SMB resource
and false
otherwise
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
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
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.
getContentLength
public int getContentLength()
This URLConnection method just returns the result of length().
- 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.
- the last modified data as milliseconds since Jan 1, 1970
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.
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
getInputStream
public InputStream getInputStream()
throws IOException
This URLConnection method just returns a new SmbFileInputStream created with this file.
getLastModified
public long getLastModified()
This URLConnection method just returns the result of lastModified.
- the last modified data as milliseconds since Jan 1, 1970
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.
getOutputStream
public OutputStream getOutputStream()
throws IOException
This URLConnection method just returns a new SmbFileOutputStream created with this file.
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.
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).
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.
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
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.
getUncPath
public String getUncPath()
Retuns the Windows UNC style path with backslashs intead of forward slashes.
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.
- A hashcode for this abstract file
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
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
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
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 java.util.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
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.
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
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
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
SmbFile
s 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
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
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
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
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).
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).
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: SmbFile
s 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
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.
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
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
setReadOnly
public void setReadOnly()
throws SmbException
Make this file read-only. This is shorthand for setAttributes(
getAttributes() | ATTR_READ_ONLY ).
setReadWrite
public void setReadWrite()
throws SmbException
Turn off the read-only attribute of this file. This is shorthand for
setAttributes( getAttributes() & ~ATTR_READONLY ).
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
.
- The original URL representation of this SMB resource
toURL
public URL toURL()
throws MalformedURLException
Use getURL() instead
Returns a java.net.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
java.net.URL
for this SmbFile