|
Glassfish example source code file (VersioningUtils.java)
The Glassfish VersioningUtils.java source code/* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. * * Copyright (c) 2008-2010 Oracle and/or its affiliates. All rights reserved. * * The contents of this file are subject to the terms of either the GNU * General Public License Version 2 only ("GPL") or the Common Development * and Distribution License("CDDL") (collectively, the "License"). You * may not use this file except in compliance with the License. You can * obtain a copy of the License at * https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html * or packager/legal/LICENSE.txt. See the License for the specific * language governing permissions and limitations under the License. * * When distributing the software, include this License Header Notice in each * file and include the License file at packager/legal/LICENSE.txt. * * GPL Classpath Exception: * Oracle designates this particular file as subject to the "Classpath" * exception as provided by Oracle in the GPL Version 2 section of the License * file that accompanied this code. * * Modifications: * If applicable, add the following below the License Header, with the fields * enclosed by brackets [] replaced by your own identifying information: * "Portions Copyright [year] [name of copyright owner]" * * Contributor(s): * If you wish your version of this file to be governed by only the CDDL or * only the GPL Version 2, indicate your decision by adding "[Contributor] * elects to include this software in this distribution under the [CDDL or GPL * Version 2] license." If you don't indicate a single choice of license, a * recipient has the option to distribute your version of this file under * either the CDDL, the GPL Version 2 or to extend the choice of license to * its licensees as provided above. However, if you add GPL Version 2 code * and therefore, elected the GPL Version 2 license, then the option applies * only if the new code is made subject to such option by the copyright * holder. */ package org.glassfish.deployment.versioning; import com.sun.enterprise.config.serverbeans.Application; import com.sun.enterprise.util.LocalStringManagerImpl; import java.util.ArrayList; import java.util.Collections; import java.util.Iterator; import java.util.List; import java.util.StringTokenizer; /** * This class provides utility methods to handle application names * in the versioning context * * @author Romain GRECOURT - SERLI (romain.grecourt@serli.com) */ public class VersioningUtils { public static final LocalStringManagerImpl LOCALSTRINGS = new LocalStringManagerImpl(VersioningUtils.class); public static final String EXPRESSION_SEPARATOR = ":"; public static final String EXPRESSION_WILDCARD = "*"; public static final String REPOSITORY_DASH = "~"; /** * Extract the untagged name for a given application name that complies * with versioning rules (version identifier / expression) or not. * * If the application name is using versioning rules, the method will split * the application names with the colon character and retrieve the * untagged name from the first token. * * Else the given application name is an untagged name. * * @param appName the application name * @return the untagged version name * @throws VersioningSyntaxException if the given application name had some * critical patterns. */ public static final String getUntaggedName(String appName) throws VersioningSyntaxException { if(appName != null && !appName.isEmpty()){ int colonIndex = appName.indexOf(EXPRESSION_SEPARATOR); // if the appname contains a EXPRESSION_SEPARATOR if (colonIndex >= 0){ if (colonIndex == 0) { // if appName is starting with a colon throw new VersioningSyntaxException( LOCALSTRINGS.getLocalString("versioning.deployment.invalid.appname1", "excepted application name before colon: {0}", appName)); } else if (colonIndex == (appName.length() - 1)) { // if appName is ending with a colon throw new VersioningSyntaxException( LOCALSTRINGS.getLocalString("versioning.deployment.invalid.appname2", "excepted version identifier after colon: {0}", appName)); } // versioned return appName.substring(0, colonIndex); } } // not versioned return appName; } /** * Extract the version identifier / expression for a given application name * that complies with versioning rules. * * The method splits the application name with the colon character * and retrieve the 2nd token. * * @param appName the application name * @return the version identifier / expression extracted from application name * @throws VersioningSyntaxException if the given application name had some * critical patterns. */ public static final String getExpression(String appName) throws VersioningSyntaxException { if(appName != null && !appName.isEmpty()) { int colonIndex = appName.indexOf(EXPRESSION_SEPARATOR); // if the appname contains a EXPRESSION_SEPARATOR if (colonIndex >= 0){ if (colonIndex == 0) { // if appName is starting with a colon throw new VersioningSyntaxException( LOCALSTRINGS.getLocalString("versioning.deployment.invalid.appname1", "excepted application name before colon: {0}", appName)); } else if (colonIndex == (appName.length() - 1)) { // if appName is ending with a colon throw new VersioningSyntaxException( LOCALSTRINGS.getLocalString("versioning.deployment.invalid.appname2", "excepted version identifier after colon: {0}", appName)); } // versioned return appName.substring(colonIndex + 1, appName.length()); } } // not versioned return null; } /** * Check a versionned application name. * * This method is used to provide consistant error messages for identifier * aware operations. * * @param appName the application name * @throws VersioningSyntaxException if the given application name had some * critical patterns. * @throws VersioningException if the given application name had some * wildcard character(s) in its identifier part. */ public static final void checkIdentifier(String appName) throws VersioningException { String identifier = getExpression(appName); if (identifier != null && identifier.contains(EXPRESSION_WILDCARD)) { throw new VersioningWildcardException( LOCALSTRINGS.getLocalString("versioning.deployment.wildcard.not.allowed", "Wildcard character(s) are not allowed in a version identifier.")); } } /** * Extract the set of version(s) of the given application from a set of * applications. This method is used by unit tests. * * @param untaggedName the application name as an untagged version : an * application name without version identifier * @param allApplications the set of applications * @return all the version(s) of the given application in the given set of * applications */ public static final List<String> getVersions(String untaggedName, List<Application> allApplications) { List<String> allVersions = new ArrayList Other Glassfish examples (source code examples)Here is a short list of links related to this Glassfish VersioningUtils.java source code file: |
... this post is sponsored by my books ... | |
#1 New Release! |
FP Best Seller |
Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.
A percentage of advertising revenue from
pages under the /java/jwarehouse
URI on this website is
paid back to open source projects.