Sets
propName
to
propValue
on
path
. A
propValue
of
null will delete the property.
If
depth
is {@link org.tmatesoft.svn.core.SVNDepth#EMPTY}, set the property on
path
only; if {@link SVNDepth#FILES}, set it on
path
and its file children (if any); if {@link SVNDepth#IMMEDIATES}, on
path
and all of its immediate children (both files and directories); if {@link SVNDepth#INFINITY}, on
path
and everything beneath it.
If
propName
is an svn-controlled property (i.e. prefixed with
"svn:"), then the caller is responsible for ensuring that the value uses LF line-endings.
If
skipChecks
is
true, this method does no validity checking. But if
skipChecks
is
false, and
propName
is not a valid property for
path
, it throws an exception, either with an error code {@link org.tmatesoft.svn.core.SVNErrorCode#ILLEGAL_TARGET} (if the property is not appropriate for
path
), or with {@link org.tmatesoft.svn.core.SVNErrorCode#BAD_MIME_TYPE} (if
propName
is
"svn:mime-type", but
propVal
is not a valid mime-type).
changeLists
is a collection of
String
changelist names, used as a restrictive filter on items whose properties are set; that is, don't set properties on any item unless it's a member of one of those changelists. If
changelists
is empty (or
null), no changelist filtering occurs.
This method operates only on working copies and does not open any network connection.
@param path working copy path
@param propName property name
@param propValue property value
@param skipChecks true toforce the operation to run without validity checking
@param depth working copy tree depth to process
@param handler a caller's property handler
@param changeLists changelist names
@throws SVNException
path
does not exist - exception with {@link SVNErrorCode#CLIENT_PROPERTY_NAME} error code - if
propName
is a revision property name or not a valid property name or not a regular property name (one starting with a "svn:entry" or "svn:wc" prefix)
@see #doSetProperty(SVNURL,String,SVNPropertyValue,SVNRevision,String,SVNProperties,boolean,ISVNPropertyHandler)
@since 1.2, SVN 1.5