buildframework/helium/sf/java/signaling/src/com/nokia/helium/signal/ant/types/SignalInput.java
author wbernard
Fri, 13 Aug 2010 14:59:05 +0300
changeset 628 7c4a911dc066
parent 587 85df38eb4012
child 645 b8d81fa19e7d
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.signal.ant.types;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    20
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    21
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    22
import java.util.Vector;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    23
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    24
import org.apache.log4j.Logger;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    25
import org.apache.tools.ant.BuildException;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    26
import org.apache.tools.ant.types.DataType;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    27
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    28
import com.nokia.helium.core.ant.types.ReferenceType;
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    29
import com.nokia.helium.signal.Notifier;
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
 * SignalInput class which is a type to store input for signals
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    33
 * Signals..
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    34
 *   
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    35
 * <pre>
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    36
 *   &lt;hlm:signalInput id=&quot;testDeferredSignalInput&quot;&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    37
 *      &lt;/hlm:notifierList refid=&quot;defaultNotiferList&quot; &gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    38
 *   &lt;/hlm:signalInput&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    39
 *   
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    40
 *   &lt;hlm:signal name=&quot;compileSignal&quot; result=&quot;${result}&quot;&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    41
 *       &lt;-- Let's refer to some existing signal input configuration --&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    42
 *       &lt;hlm:signalInput refid=&quot;testDeferredSignalInput&quot; /&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    43
 *   &lt;/hlm:signal&gt;
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    44
 * </pre>
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    45
 * 
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    46
 * @ant.type name="signalInput" category="Signaling"
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    47
 */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    48
public class SignalInput extends DataType
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    49
{
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    50
    private Vector<ReferenceType> notifierListRef = new Vector<ReferenceType>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    51
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    52
    private Vector<NotifierInput> notifierInputList = new Vector<NotifierInput>();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    53
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    54
    // By default it is configured to fail the build.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    55
    private String failBuild = "now";
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    56
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    57
    private Logger log = Logger.getLogger(SignalInput.class);
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
    /**
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    61
     * Defines how the signal framework should handle the error, either
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    62
     * fail "now", at the end of the build "defer", or ignore the failure
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    63
     * with "never".
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    64
     * @param failBuild type of failure for this input.
628
7c4a911dc066 helium_11.0.0-e00f171ca185
wbernard
parents: 587
diff changeset
    65
     * @ant.not-required Default is now.
587
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    66
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    67
    public void setFailBuild(FailBuildEnum failInput) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    68
        failBuild = failInput.getValue();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    69
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    70
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    71
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    72
     * Helper function called by ant to set the failbuild type
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    73
     * @param failBuild type of failure for this input.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    74
     */
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    75
    public String getFailBuild() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    76
        return failBuild;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    77
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    78
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    79
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    80
     * Helper function called by ant to create a new notifier for
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    81
     * this input.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    82
     * @return ReferenceType created ReferenceType.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    83
     */    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    84
    public NotifierInput createNotifierInput() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    85
        NotifierInput notifierInput =  new NotifierInput();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    86
        add(notifierInput);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    87
        return notifierInput;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    88
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    89
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    90
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    91
     * Adds the created notifier to the list
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    92
     * @param ReferenceType notifier to be added to the list.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    93
     */    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    94
    public void add(NotifierInput notifierInput) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    95
        if (notifierInput != null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    96
            notifierInputList.add(notifierInput);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    97
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
    98
    }
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
     * Helper function called by ant to create a new notifier for
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   102
     * this input.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   103
     * @return ReferenceType created ReferenceType.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   104
     */    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   105
    public ReferenceType createNotifierListRef() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   106
        ReferenceType notifierRef =  new ReferenceType();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   107
        add(notifierRef);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   108
        return notifierRef;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   109
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   110
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   111
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   112
     * Adds the created notifier to the list
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   113
     * @param ReferenceType notifier to be added to the list.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   114
     */    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   115
    public void add(ReferenceType notifier) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   116
        if (notifier != null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   117
            notifierListRef.add(notifier);
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   118
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   119
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   120
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   121
    public Vector<NotifierInput> getNotifierInput() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   122
        return notifierInputList;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   123
    }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   124
    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   125
    /**
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   126
     * Gets the NotifierList associated with this input. If the
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   127
     * notifier list reference is empty then it throws exception. 
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   128
     * @return List of notifier associated with this input.
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   129
     */    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   130
    public Vector<Notifier> getSignalNotifierList() {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   131
        Vector<Notifier> notifierList = null;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   132
        if (notifierListRef != null) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   133
            log.debug("getSignalNotifierList:list.size:" + notifierListRef.size());
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   134
            for (ReferenceType notifierRef : notifierListRef) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   135
                Object obj = notifierRef.getReferencedObject();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   136
                if (obj instanceof SignalNotifierList) {
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   137
                    notifierList = ((SignalNotifierList)obj).getNotifierList();
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   138
                    break;
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
            return notifierList;
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   142
        }
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   143
        throw new BuildException("No signal notifierlist reference defined.");
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   144
    }    
85df38eb4012 helium_9.0-a7879c935424
wbernard
parents:
diff changeset
   145
}