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