enhancer/generic/nlp/src/main/java/org/apache/stanbol/enhancer/nlp/morpho/NumberTag.java

/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements.  See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License.  You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.stanbol.enhancer.nlp.morpho;

import org.apache.stanbol.enhancer.nlp.model.Token;
import org.apache.stanbol.enhancer.nlp.model.tag.Tag;
import org.apache.stanbol.enhancer.nlp.model.tag.TagSet;
import org.apache.stanbol.enhancer.servicesapi.EnhancementEngine;

/**
 * An Number tag typically assigned by a Morphological Analyzer (an
 * NLP component) to a {@link Token} <p>
 * @author Alessio Bosca
 */
public class NumberTag extends Tag<NumberTag>{
    private final NumberFeature numberCategory;
    /**
     * Creates a new Number tag for the parsed tag. The created Tag is not
     * assigned to any {@link NumberFeature}.<p> This constructor can be used
     * by {@link EnhancementEngine}s that encounter an Tag they do not know 
     * (e.g. that is not defined by the configured {@link TagSet}).<p>
     * @param tag the Tag
     * @throws IllegalArgumentException if the parsed tag is <code>null</code>
     * or empty.
     */
    public NumberTag(String tag){
        this(tag,null);
    }
    /**
     * Creates a NumberFeature tag that is assigned to a {@link NumberFeature}
     * @param tag the tag
     * @param numberCategory the lexical Number  or <code>null</code> if not known
     * @throws IllegalArgumentException if the parsed tag is <code>null</code>
     * or empty.
     */
    public NumberTag(String tag, NumberFeature numberCategory){
        super(tag);
        this.numberCategory = numberCategory;
    }
    /**
     * Get the Number of this tag (if known)
     * @return the NumberFeature or <code>null</code> if not mapped to any
     */
    public NumberFeature getNumber(){
       return this.numberCategory; 
    }
    
    @Override
    public String toString() {
        return String.format("NUMBER %s (%s)", tag,
        	numberCategory == null ? "none" : numberCategory.name());
    }
    
    @Override
    public int hashCode() {
        return tag.hashCode();
    }
    
    @Override
    public boolean equals(Object obj) {
        return super.equals(obj) && obj instanceof NumberTag &&
            (numberCategory == null && ((NumberTag)obj).numberCategory == null) ||
                    (numberCategory != null && numberCategory.equals(((NumberTag)obj).numberCategory));
    }
    
}