buildframework/helium/sf/java/scm/src/com/nokia/helium/scm/ant/types/LatestTag.java
author wbernard
Fri, 13 Aug 2010 14:59:05 +0300
changeset 628 7c4a911dc066
parent 587 85df38eb4012
permissions -rw-r--r--
helium_11.0.0-e00f171ca185
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     1
/*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     2
* Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies).
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     3
* All rights reserved.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     4
* This component and the accompanying materials are made available
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     5
* under the terms of the License "Eclipse Public License v1.0"
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     6
* which accompanies this distribution, and is available
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     8
*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     9
* Initial Contributors:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    11
*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    12
* Contributors:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    13
*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    14
* Description:  
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    15
*
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    16
*/
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    17
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    18
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    19
package com.nokia.helium.scm.ant.types;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    20
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    21
import java.util.ArrayList;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    22
import java.util.Collections;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    23
import java.util.Comparator;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    24
import java.util.List;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    25
import java.util.regex.Matcher;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    26
import java.util.regex.Pattern;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    27
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    28
import org.apache.tools.ant.BuildException;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    29
import org.apache.tools.ant.Project;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    30
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    31
/**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    32
 * The latestTag element will help you to find the latest revision based
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    33
 * on a pattern.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    34
 * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    35
 *  <pre>
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    36
 *  &lt;latestTag name="1.0.*"&gt;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    37
 *     &lt;tagSet id="set.of.tags"/&gt;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    38
 *  latestTag
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    39
 *  </pre>
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    40
 * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    41
 * @ant.type name="latestTag" category="SCM"
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    42
 */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    43
public class LatestTag extends Tag {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    44
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    45
    private String pattern;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    46
    private List<TagSet> tagSets = new ArrayList<TagSet>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    47
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    48
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    49
     * Defines the pattern.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    50
     * @ant.required
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    51
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    52
    public void setPattern(String pattern) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    53
        this.pattern = pattern;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    54
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    55
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    56
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    57
     * Add a set of release to search the latest release in.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    58
     * @param tagSet
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    59
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    60
    public void add(TagSet tagSet) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    61
        tagSets.add(tagSet);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    62
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    63
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    64
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    65
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    66
     * {@inheritDoc}
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    67
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    68
    @Override
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    69
    public String getName() {
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    70
        if (pattern == null) {
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    71
            throw new BuildException("'pattern' attribute has not been defined.");
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    72
        }
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    73
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    74
        List<Tag> tags = getCleanedList();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    75
        Collections.sort(tags, new TagComparator<Tag>(getPattern()));
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    76
        
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    77
        if (tags.isEmpty()) {
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    78
            throw new BuildException("No tag found.");
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    79
        }
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    80
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    81
        getProject().log("Latest tag: " + tags.get(0).getName());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    82
        return tags.get(0).getName();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    83
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    84
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    85
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    86
     * Get a reduce set of tags, only tag matching the pattern will be
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    87
     * included.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    88
     * @return the reduce list of tags.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    89
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    90
    protected List<Tag> getCleanedList() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    91
        Pattern pVer = getPattern();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    92
        List<Tag> tags = new ArrayList<Tag>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    93
        for (Tag tag : getTags()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    94
            if (pVer.matcher(tag.getName()).matches()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    95
                tags.add(tag);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    96
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    97
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    98
        return tags;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    99
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   100
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   101
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   102
     * Get the pattern as a regular expression.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   103
     * '*' will be transformed into (\d+) (which means only numbers
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   104
     *  will be considered). Other character will be quoted.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   105
     * For example:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   106
     * 1.0.* => 1\.0\.(\d+)
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   107
     * 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   108
     * @return the transformed pattern.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   109
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   110
    protected Pattern getPattern() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   111
        // Quoting the current pattern
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   112
        getProject().log("pattern: " + pattern, Project.MSG_DEBUG);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   113
        String qVer = pattern.replaceAll("([.\\:_()])", "\\\\$1");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   114
        getProject().log("quoted: " + qVer, Project.MSG_DEBUG);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   115
        // Replacing quoted \* into \d+
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   116
        qVer = qVer.replaceAll("\\*", "(\\\\d+)");        
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   117
        qVer = "^" + qVer + "$";
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   118
        getProject().log("final: " + qVer, Project.MSG_DEBUG);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   119
        return Pattern.compile(qVer);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   120
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   121
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   122
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   123
     * Get the list of tags, from the tagSets. 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   124
     * @return a list of Tags objects.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   125
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   126
    protected List<Tag> getTags() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   127
        List<Tag> tags = new ArrayList<Tag>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   128
        for (TagSet ts : tagSets) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   129
            if (ts.isReference()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   130
                ts = (TagSet)ts.getRefid().getReferencedObject(getProject());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   131
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   132
            for (Tag tag : ts.getTags()) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   133
                tags.add(tag);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   134
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   135
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   136
        return tags;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   137
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   138
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   139
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   140
     * This class implements the comparator interface, which will help to
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   141
     * order the tag compare to the pattern. For example:
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   142
     * 1.0.2 > 1.0.1 (for pattern 1.0.*)
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   143
     * 1.1.1 > 1.0.2 (for pattern 1.*.*)
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   144
     *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   145
     * @param <T> A Tag kind of class.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   146
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   147
    public class TagComparator<T extends Tag> implements Comparator<T> {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   148
        
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   149
        // Pattern to match for the comparison
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   150
        private Pattern pVer;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   151
        
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   152
        /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   153
         * Configure the Comparator with the pattern.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   154
         * @param pattern
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   155
         */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   156
        public TagComparator(Pattern pattern) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   157
            pVer = pattern;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   158
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   159
        
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   160
        /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   161
         * {@inheritDoc}
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   162
         */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   163
        @Override
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   164
        public int compare(T o1, T o2) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   165
            getProject().log("Comparing: " + o1.getName() + ">" + o2.getName(), Project.MSG_DEBUG);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   166
            
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
   167
            if (o1.getName().equals(o2.getName())) {
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   168
                return 0;
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
   169
            }
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   170
            Matcher m1 = pVer.matcher(o1.getName());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   171
            Matcher m2 = pVer.matcher(o2.getName());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   172
            m1.matches();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   173
            m2.matches();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   174
            int max = (m1.groupCount() > m2.groupCount()) ? m2.groupCount() : m1.groupCount();            
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   175
            int i = 1;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   176
            while (i <= max) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   177
                int i1 = Integer.decode(m1.group(i)).intValue();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   178
                int i2 = Integer.decode(m2.group(i)).intValue();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   179
                getProject().log("Comparing index " + i + ": " + i1 + " < " + i2, Project.MSG_DEBUG);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   180
                if (i1 != i2) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   181
                    return i2 - i1;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   182
                }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   183
                i++;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   184
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   185
            return 0;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   186
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   187
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   188
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   189
}