buildframework/helium/sf/java/legacy/src/com/nokia/ant/Antlib.java
author wbernard
Fri, 13 Aug 2010 14:59:05 +0300
changeset 628 7c4a911dc066
parent 588 c7c26511138f
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
 *  Licensed to the Apache Software Foundation (ASF) under one or more
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     3
 *  contributor license agreements.  See the NOTICE file distributed with
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     4
 *  this work for additional information regarding copyright ownership.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     5
 *  The ASF licenses this file to You under the Apache License, Version 2.0
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     6
 *  (the "License"); you may not use this file except in compliance with
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     7
 *  the License.  You may obtain a copy of the License at
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     8
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
     9
 *      http://www.apache.org/licenses/LICENSE-2.0
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    10
 *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    11
 *  Unless required by applicable law or agreed to in writing, software
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    12
 *  distributed under the License is distributed on an "AS IS" BASIS,
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    13
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    14
 *  See the License for the specific language governing permissions and
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    15
 *  limitations under the License.
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
/* * Portion Copyright (c) 2007-2008 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.*/
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    20
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    21
package com.nokia.ant;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    22
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    23
import java.io.IOException;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    24
import java.net.URL;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    25
import java.util.ArrayList;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    26
import java.util.List;
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.ComponentHelper;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    30
import org.apache.tools.ant.Project;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    31
import org.apache.tools.ant.Task;
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 588
diff changeset
    32
import org.apache.tools.ant.TaskContainer;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    33
import org.apache.tools.ant.UnknownElement;
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 588
diff changeset
    34
import org.apache.tools.ant.helper.ProjectHelper2;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 588
diff changeset
    35
import org.apache.tools.ant.taskdefs.AntlibDefinition;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    36
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    37
/**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    38
 * Antlib task. It does not
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    39
 * occur in an ant build file. It is the root element
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    40
 * an antlib xml file.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    41
 * @ant.task ignore="true"
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    42
 * @since Ant 1.6
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    43
 */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    44
public class Antlib extends Task implements TaskContainer {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    45
    //
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    46
    // Static
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
    /** The name of this task */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    50
    public static final String TAG = "antlib";
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    51
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    52
    //
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    53
    // Instance
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    54
    //
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    55
    private ClassLoader classLoader;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    56
    private String      uri = "";
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    57
    private List<Task>  tasks = new ArrayList<Task>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    58
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    59
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    60
     * Static method to read an ant lib definition from
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    61
     * a url.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    62
     *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    63
     * @param project   the current project
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    64
     * @param antlibUrl the url to read the definitions from
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    65
     * @param uri       the uri that the antlib is to be placed in
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    66
     * @return   the ant lib task
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    67
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    68
    public static Antlib createAntlib(final Project project, final URL antlibUrl,
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    69
                                      final String uri) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    70
        // Check if we can contact the URL
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    71
        try {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    72
            antlibUrl.openConnection().connect();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    73
        } catch (IOException ex) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    74
            throw new BuildException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    75
                "Unable to find " + antlibUrl, ex);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    76
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    77
        ComponentHelper helper =
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    78
            ComponentHelper.getComponentHelper(project);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    79
        helper.enterAntLib(uri);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    80
        try {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    81
            // Should be safe to parse
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    82
            ProjectHelper2 parser = new ProjectHelper2();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    83
            UnknownElement ue =
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    84
                parser.parseUnknownElement(project, antlibUrl);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    85
            // Check name is "antlib"
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    86
            if (!(ue.getTag().equals(TAG))) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    87
                throw new BuildException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    88
                    "Unexpected tag " + ue.getTag() + " expecting "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    89
                    + TAG, ue.getLocation());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    90
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    91
            Antlib antlib = new Antlib();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    92
            antlib.setProject(project);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    93
            antlib.setLocation(ue.getLocation());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    94
            antlib.setTaskName("antlib");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    95
            antlib.init();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    96
            ue.configure(antlib);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    97
            return antlib;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    98
        } finally {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    99
            helper.exitAntLib();
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
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   103
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   104
     * Set the class loader for this antlib.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   105
     * This class loader is used for any tasks that
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   106
     * derive from Definer.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   107
     *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   108
     * @param classLoader the class loader
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   109
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   110
    protected final void setClassLoader(final ClassLoader classLoader) 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   111
    {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   112
        this.classLoader = classLoader;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   113
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   114
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   115
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   116
     * Set the URI for this antlib.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   117
     * @param uri the namespace uri
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   118
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   119
    protected final void  setURI(final String uri) 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   120
    {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   121
        this.uri = uri;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   122
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   123
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   124
    private ClassLoader getClassLoader() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   125
        if (classLoader == null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   126
            classLoader = Antlib.class.getClassLoader();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   127
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   128
        return classLoader;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   129
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   130
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   131
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   132
     * add a task to the list of tasks
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   133
     *
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   134
     * @param nestedTask Nested task to execute in antlib
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   135
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   136
    public final void addTask(final Task nestedTask) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   137
        tasks.add(nestedTask);
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
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   141
     * Execute the nested tasks, setting the classloader for
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   142
     * any tasks that derive from Definer.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   143
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   144
    public final void execute() {
588
c7c26511138f helium-10.0.0-bc45d50958fe
wbernard
parents: 587
diff changeset
   145
        for (Task task : tasks) {
c7c26511138f helium-10.0.0-bc45d50958fe
wbernard
parents: 587
diff changeset
   146
            if (task instanceof UnknownElement) {
c7c26511138f helium-10.0.0-bc45d50958fe
wbernard
parents: 587
diff changeset
   147
                UnknownElement ue = (UnknownElement)task;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   148
                setLocation(ue.getLocation());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   149
                ue.maybeConfigure();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   150
                Object configuredObject = ue.getRealThing();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   151
                if (configuredObject == null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   152
                    continue;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   153
                }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   154
                if (!(configuredObject instanceof AntlibDefinition)) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   155
                    throw new BuildException(
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   156
                            "Invalid task in antlib " + ue.getTag()
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   157
                            + " " + configuredObject.getClass() + " does not "
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   158
                            + "extend org.apache.tools.ant.taskdefs.AntlibDefinition");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   159
                }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   160
                AntlibDefinition def = (AntlibDefinition) configuredObject;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   161
                def.setURI(uri);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   162
                def.setAntlibClassLoader(getClassLoader());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   163
                def.init();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   164
                def.execute();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   165
            }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   166
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   167
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   168
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   169
}