/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ package org.apache.tools.ant.taskdefs.optional.clearcase; import org.apache.tools.ant.BuildException; import org.apache.tools.ant.Project; import org.apache.tools.ant.taskdefs.Execute; import org.apache.tools.ant.types.Commandline; /** * TODO: * comment field doesn't include all options yet */ /** * Performs a ClearCase Unlock command. * *
* The following attributes are interpreted: *
Attribute | *Values | *Required | *
---|---|---|
comment | *Specifies how to populate comments fields | *No | *
pname | *Specifies the object pathname to be unlocked. | *No | *
objselect | *This variable is obsolete. Should use objsel instead. | *no | *
objsel | *Specifies the object(s) to be unlocked. | *No | *
failonerr | *Throw an exception if the command fails. Default is true | *No | *
* Builds a command line to execute cleartool and then calls Exec's run method * to execute the command line. * @throws BuildException if the command fails and failonerr is set to true */ public void execute() throws BuildException { Commandline commandLine = new Commandline(); Project aProj = getProject(); int result = 0; // Default the viewpath to basedir if it is not specified if (getViewPath() == null) { setViewPath(aProj.getBaseDir().getPath()); } // build the command line from what we got the format is // cleartool lock [options...] // as specified in the CLEARTOOL.EXE help commandLine.setExecutable(getClearToolCommand()); commandLine.createArgument().setValue(COMMAND_UNLOCK); // Check the command line options checkOptions(commandLine); // For debugging // System.out.println(commandLine.toString()); if (!getFailOnErr()) { getProject().log("Ignoring any errors that occur for: " + getOpType(), Project.MSG_VERBOSE); } result = run(commandLine); if (Execute.isFailure(result) && getFailOnErr()) { String msg = "Failed executing: " + commandLine.toString(); throw new BuildException(msg, getLocation()); } } /** * Check the command line options. */ private void checkOptions(Commandline cmd) { // ClearCase items getCommentCommand(cmd); if (getObjSelect() == null && getPname() == null) { throw new BuildException("Should select either an element " + "(pname) or an object (objselect)"); } getPnameCommand(cmd); // object selector if (getObjSelect() != null) { cmd.createArgument().setValue(getObjSelect()); } } /** * Sets how comments should be written * for the event record(s) * * @param comment comment method to use */ public void setComment(String comment) { mComment = comment; } /** * Get comment method * * @return String containing the desired comment method */ public String getComment() { return mComment; } /** * Sets the pathname to be locked * * @param pname pathname to be locked */ public void setPname(String pname) { mPname = pname; } /** * Get the pathname to be locked * * @return String containing the pathname to be locked */ public String getPname() { return mPname; } /** * Sets the object(s) to be locked * * @param objselect objects to be locked */ public void setObjselect(String objselect) { setObjSelect(objselect); } /** * Sets the object(s) to be locked * * @param objsel objects to be locked * @since ant 1.6.1 */ public void setObjSel(String objsel) { setObjSelect(objsel); } /** * Get list of objects to be locked * * @return String containing the objects to be locked */ public String getObjselect() { return getObjSelect(); } /** * Get the 'comment' command * * @param cmd containing the command line string with or without the * comment flag and value appended */ private void getCommentCommand(Commandline cmd) { if (getComment() == null) { return; } else { /* Had to make two separate commands here because if a space is inserted between the flag and the value, it is treated as a Windows filename with a space and it is enclosed in double quotes ("). This breaks clearcase. */ cmd.createArgument().setValue(FLAG_COMMENT); cmd.createArgument().setValue(getComment()); } } /** * Get the 'pname' command * * @param cmd containing the command line string with or without the * pname flag and value appended */ private void getPnameCommand(Commandline cmd) { if (getPname() == null) { return; } else { /* Had to make two separate commands here because if a space is inserted between the flag and the value, it is treated as a Windows filename with a space and it is enclosed in double quotes ("). This breaks clearcase. */ cmd.createArgument().setValue(FLAG_PNAME); cmd.createArgument().setValue(getPname()); } } /** * Return which object/pname is being operated on * * @return String containing the object/pname being worked on */ private String getOpType() { if (getPname() != null) { return getPname(); } else { return getObjSelect(); } } /** * -comment flag -- method to use for commenting events */ public static final String FLAG_COMMENT = "-comment"; /** * -pname flag -- pathname to lock */ public static final String FLAG_PNAME = "-pname"; }