Perforce SCM.
- * For example, generate the following command line:
- * p4 -H hostname -p port -u username -P password path
- *p4 -H hostname -p port -u username -P password path submit -c changement
- * - * @param perforceRepo - * @see http://www.perforce.com/perforce/doc.051/manuals/cmdref/index.html - */ - public String developerAccessPerforce( String devConnection ) - { - StringBuffer command = new StringBuffer(); - char delim = getSCMConnectionSeparator( devConnection ).charAt( 0 ); + /** + * Get svn connection string. Used in + * xdocs/src/plugin-resources/templates/scm/svn.xml. It removes the first + * two elements (scm:svn:) + * + * @param conn + * the repository connection + * @return CVS root. + */ + public String getSvnConnection(String conn) { + if (conn != null && conn.length() > 8 + && "svn".equals(conn.substring(4, 7))) + return conn.substring(8); + else { + System.err + .println("Your subversion connection does not seem to be valid: " + + conn); + return ""; + } + } - PerforceScmProvider perforceProvider= new PerforceScmProvider(); - PerforceScmProviderRepository perforceRepo; + /** + * Create the documentation to provide an developer access with a + *Perforce SCM. For example, generate the following command
+ * line:
+ * + * p4 -H hostname -p port -u username -P password path + *
+ *+ * p4 -H hostname -p port -u username -P password path submit -c changement + *
+ * + * @param devConnection + * @see http://www.perforce.com/perforce/doc.051/manuals/cmdref/index.html + */ + public String developerAccessPerforce(String devConnection) { + StringBuffer command = new StringBuffer(); + char delim = getSCMConnectionSeparator(devConnection).charAt(0); - String scmSpecificUrl = devConnection.substring( 13 ); + PerforceScmProvider perforceProvider = new PerforceScmProvider(); + PerforceScmProviderRepository perforceRepo; - try - { - perforceRepo = (PerforceScmProviderRepository) - perforceProvider.makeProviderScmRepository( scmSpecificUrl, delim ); - } - catch (ScmRepositoryException e) - { - System.err.println( "Your developerConnection does not seem to be valid: " + e.getMessage() ); - return ""; - } + String scmSpecificUrl = devConnection.substring(13); + try { + perforceRepo = (PerforceScmProviderRepository) perforceProvider + .makeProviderScmRepository(scmSpecificUrl, delim); + } catch (ScmRepositoryException e) { + System.err + .println("Your developerConnection does not seem to be valid: " + + e.getMessage()); + return ""; + } - command.append( "p4" ); - if ( !StringUtils.isEmpty( perforceRepo.getHost() ) ) - { - command.append( " -H " ).append( perforceRepo.getHost() ); - } - if ( perforceRepo.getPort() > 0 ) - { - command.append( " -p " + perforceRepo.getPort() ); - } - command.append( " -u username" ); - command.append( " -P password" ); - command.append( " " ); - command.append( perforceRepo.getPath() ); - command.append( "\n" ); - command.append( "p4 submit -c \"A comment\"" ); + command.append("p4"); + if (!StringUtils.isEmpty(perforceRepo.getHost())) { + command.append(" -H ").append(perforceRepo.getHost()); + } + if (perforceRepo.getPort() > 0) { + command.append(" -p " + perforceRepo.getPort()); + } + command.append(" -u username"); + command.append(" -P password"); + command.append(" "); + command.append(perforceRepo.getPath()); + command.append("\n"); + command.append("p4 submit -c \"A comment\""); - return command.toString(); - } + return command.toString(); + } - // Starteam + // Starteam - /** - * Create the documentation to provide an developer access with aStarteam SCM.
- * For example, generate the following command line:
- * stcmd co -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl -is
- *stcmd ci -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl -f NCI -is
- * - * @param starteamRepo - */ - public String developerAccessStarteam( String devConnection ) - { + /** + * Create the documentation to provide an developer access with a + *Starteam SCM. For example, generate the following command
+ * line:
+ * + * stcmd co -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl + * -is + *
+ *+ * stcmd ci -x -nologo -stop -p myusername:mypassword@myhost:1234/projecturl + * -f NCI -is + *
+ * + * @param devConnection + */ + public String developerAccessStarteam(String devConnection) { - StringBuffer command = new StringBuffer(); - char delim = getSCMConnectionSeparator( devConnection ).charAt( 0 ); + StringBuffer command = new StringBuffer(); + char delim = getSCMConnectionSeparator(devConnection).charAt(0); - StarteamScmProvider starteamProvider= new StarteamScmProvider(); - StarteamScmProviderRepository starteamRepo; + StarteamScmProvider starteamProvider = new StarteamScmProvider(); + StarteamScmProviderRepository starteamRepo; - String scmSpecificUrl = devConnection.substring( 13 ); + String scmSpecificUrl = devConnection.substring(13); - try - { - starteamRepo = (StarteamScmProviderRepository) - starteamProvider.makeProviderScmRepository( scmSpecificUrl, delim ); - } - catch (ScmRepositoryException e) - { - System.err.println( "Your developerConnection does not seem to be valid: " + e.getMessage() ); - return ""; - } + try { + starteamRepo = (StarteamScmProviderRepository) starteamProvider + .makeProviderScmRepository(scmSpecificUrl, delim); + } catch (ScmRepositoryException e) { + System.err + .println("Your developerConnection does not seem to be valid: " + + e.getMessage()); + return ""; + } - // Safety: remove the username/password if present - String fullUrl = StringUtils.replace( starteamRepo.getFullUrl(), starteamRepo.getUser(), "username" ); - fullUrl = StringUtils.replace( fullUrl, starteamRepo.getPassword(), "password" ); + // Safety: remove the username/password if present + String fullUrl = StringUtils.replace(starteamRepo.getFullUrl(), + starteamRepo.getUser(), "username"); + fullUrl = StringUtils.replace(fullUrl, starteamRepo.getPassword(), + "password"); - command.append( "stcmd co -x -nologo -stop -p " ); - command.append( fullUrl ); - command.append( " -is" ); - command.append( "\n" ); - command.append( "stcmd ci -x -nologo -stop -p " ); - command.append( fullUrl ); - command.append( " -f NCI -is" ); + command.append("stcmd co -x -nologo -stop -p "); + command.append(fullUrl); + command.append(" -is"); + command.append("\n"); + command.append("stcmd ci -x -nologo -stop -p "); + command.append(fullUrl); + command.append(" -f NCI -is"); - return command.toString(); - } + return command.toString(); + } + /** + * Create the documentation to provide an developer access with a + *Clearcase SCM. For example, generate the following command
+ * line:
+ * + * cleartool checkout module + *
+ * + * @param devConnection + */ + public String developerAccessClearCase(String devConnection) { - /** - * Create the documentation to provide an developer access with aClearcase SCM.
- * For example, generate the following command line:
- * cleartool checkout module
- * - * @param clearCaseRepo - */ - public String developerAccessClearCase( String devConnection ) - { + StringBuffer command = new StringBuffer(); + char delim = getSCMConnectionSeparator(devConnection).charAt(0); - StringBuffer command = new StringBuffer(); - char delim = getSCMConnectionSeparator( devConnection ).charAt( 0 ); + ClearCaseScmProvider clearCaseProvider = new ClearCaseScmProvider(); + ClearCaseScmProviderRepository clearCaseRepo; - ClearCaseScmProvider clearCaseProvider= new ClearCaseScmProvider(); - ClearCaseScmProviderRepository clearCaseRepo; + String scmSpecificUrl = devConnection.substring(14); - String scmSpecificUrl = devConnection.substring( 14 ); + try { + clearCaseRepo = (ClearCaseScmProviderRepository) clearCaseProvider + .makeProviderScmRepository(scmSpecificUrl, delim); + } catch (ScmRepositoryException e) { + System.err + .println("Your developerConnection does not seem to be valid: " + + e.getMessage()); + return ""; + } - try - { - clearCaseRepo = (ClearCaseScmProviderRepository) - clearCaseProvider.makeProviderScmRepository( scmSpecificUrl, delim ); - } - catch (ScmRepositoryException e) - { - System.err.println( "Your developerConnection does not seem to be valid: " + e.getMessage() ); - return ""; - } + command.append("cleartool checkout ").append( + clearCaseRepo.getViewName("id")); - command.append( "cleartool checkout " ).append( clearCaseRepo.getViewName( "id" ) ); + return command.toString(); + } - return command.toString(); - } + /** + * Splits an SCM string into parts. + * + * @param connection + * @return A string array of SCM parts + */ + public String[] splitSCMConnection(String connection) { + if (connection == null) { + throw new NullPointerException("repository connection is null"); + } + if (connection.length() < 5) { + throw new IllegalArgumentException( + "repository connection is too short"); + } - /** - * Splits an SCM string into parts. - * - * @param connection - * @return A string array of SCM parts - */ - public String[] splitSCMConnection( String connection ) - { - if ( connection == null ) - { - throw new NullPointerException( "repository connection is null" ); - } + if (!connection.startsWith("scm:")) { + throw new IllegalArgumentException( + "repository connection must start with scm:"); + } - if ( connection.length() < 5 ) - { - throw new IllegalArgumentException( - "repository connection is too short" ); - } + String delimiter = getSCMConnectionSeparator(connection); - if ( !connection.startsWith( "scm:" ) ) - { - throw new IllegalArgumentException( - "repository connection must start with scm:" ); - } + // If the tokenizer is going to work correctly then the character + // following "scm" must be the same as the delimiter, which is not + // always the case. Therefor we give it a modified connection. + String modifiedConnection = "scm" + delimiter + connection.substring(4); - String delimiter = getSCMConnectionSeparator( connection ); + EnhancedStringTokenizer tok = new EnhancedStringTokenizer( + modifiedConnection, delimiter); - // If the tokenizer is going to work correctly then the character - // following "scm" must be the same as the delimiter, which is not - // always the case. Therefor we give it a modified connection. - String modifiedConnection = - "scm" + delimiter + connection.substring( 4 ); + String[] tokens = tokenizerToArray(tok); - EnhancedStringTokenizer tok = - new EnhancedStringTokenizer( modifiedConnection, delimiter ); + // for a valid repository, it should be scm: