org.jasig.services.persondir.support.rule.StringFormatAttributeRule.java Source code

Introduction

Here is the source code for org.jasig.services.persondir.support.rule.StringFormatAttributeRule.java

Source

/**
 * Licensed to Jasig under one or more contributor license
 * agreements. See the NOTICE file distributed with this work
 * for additional information regarding copyright ownership.
 * Jasig 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.jasig.services.persondir.support.rule;

import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.jasig.services.persondir.IPersonAttributes;
import org.jasig.services.persondir.support.IUsernameAttributeProvider;
import org.jasig.services.persondir.support.NamedPersonImpl;
import org.jasig.services.persondir.support.rule.AttributeRule;
import org.springframework.beans.factory.annotation.Required;

/**
 * Creates a new user attribute by passing a formatString and the values of 
 * existing attributes to <code>String.format()</code>
 * 
 * @author awills
 */
public final class StringFormatAttributeRule implements AttributeRule {

    private String formatString;
    private List<String> formatArguments;
    private String outputAttribute;
    private IUsernameAttributeProvider usernameAttributeProvider;

    @Required
    public void setFormatString(final String formatString) {
        this.formatString = formatString;
    }

    public void setFormatArguments(final List<String> formatArguments) {
        this.formatArguments = formatArguments;
    }

    @Required
    public void setOutputAttribute(final String outputAttribute) {
        this.outputAttribute = outputAttribute;
    }

    @Required
    public void setUsernameAttributeProvider(final IUsernameAttributeProvider usernameAttributeProvider) {
        this.usernameAttributeProvider = usernameAttributeProvider;
    }

    @Override
    public boolean appliesTo(final Map<String, List<Object>> userInfo) {

        // Assertions.
        if (userInfo == null) {
            final String msg = "Argument 'userInfo' cannot be null.";
            throw new IllegalArgumentException(msg);
        }

        boolean rslt = true; // default
        for (final String attributeName : formatArguments) {
            if (!userInfo.containsKey(attributeName)) {
                rslt = false;
                break;
            }
        }

        return rslt;

    }

    @Override
    public Set<IPersonAttributes> evaluate(final Map<String, List<Object>> userInfo) {

        // Assertions.
        if (userInfo == null) {
            final String msg = "Argument 'userInfo' cannot be null.";
            throw new IllegalArgumentException(msg);
        }
        if (!appliesTo(userInfo)) {
            final String msg = "May not evaluate.  This rule does not apply.";
            throw new IllegalArgumentException(msg);
        }

        final Object[] args = new Object[formatArguments.size()];
        for (int i = 0; i < formatArguments.size(); i++) {
            final String key = formatArguments.get(i);
            final List<Object> values = userInfo.get(key);
            args[i] = values.isEmpty() ? null : values.get(0);
        }

        final String outputAttributeValue = String.format(this.formatString, args);

        final Map<String, List<Object>> rslt = new HashMap<String, List<Object>>();
        rslt.put(this.outputAttribute, Arrays.asList(new Object[] { outputAttributeValue }));

        final String username = this.usernameAttributeProvider.getUsernameFromQuery(userInfo);
        final IPersonAttributes person = new NamedPersonImpl(username, rslt);
        return Collections.singleton(person);

    }

    @Override
    public Set<String> getAvailableQueryAttributes() {
        return new HashSet<String>(formatArguments);
    }

    @Override
    public Set<String> getPossibleUserAttributeNames() {
        return Collections.singleton(outputAttribute);
    }

}