org.protempa.dest.xml.XmlDestination Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of protempa-framework Show documentation
Protempa Framework is the core of Protempa.
There is a newer version: 4.3.2
package org.protempa.dest.xml;

/*
 * #%L
 * Protempa Framework
 * %%
 * Copyright (C) 2012 - 2013 Emory University
 * %%
 * Licensed 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.
 * #L%
 */

import java.io.Writer;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import org.protempa.DataSource;
import org.protempa.KnowledgeSource;
import org.protempa.dest.AbstractDestination;
import org.protempa.dest.QueryResultsHandler;
import org.protempa.dest.QueryResultsHandlerInitException;
import org.protempa.query.QueryMode;
import org.protempa.query.Query;

/**
 *
 * @author Andrew Post
 */
public final class XmlDestination extends AbstractDestination {
    private final String[] propIds;
    private final String initialPropId;
    private final Map propOrder;
    private final Writer writer;
    
    /**
     * Constructor
     *
     * @param writer The {@link Writer} object that will be used to write the
     * output.
     * @param propOrder A {@link Map} object that will be used to guide the
     * navigation between some propositions. If this results handler visits a
     * proposition, the ID of the proposition equals a key in the Map and the
     * value associated with the key is a name in a {@link Reference} associated
     * with the proposition, then the Reference is used to navigate from the
     * proposition. This has the effect of imposing a partial ordering on the
     * nesting of XML elements in the output.
     * @param initialPropId The ID of the proposition that will be the root of
     * the output.
     * @param propIds The IDs of propositions that are to be included in the
     * output. If a proposition's ID is not included in this array, it will not
     * be included in the output.
     */
    public XmlDestination(Writer writer, Map propOrder,
            String initialPropId, String[] propIds) {
        this.writer = writer;
        this.propOrder = propOrder;
        this.initialPropId = initialPropId;
        if (propIds == null) {
            this.propIds = new String[0];
        } else {
            this.propIds = propIds.clone();
        }
    }

    @Override
    public QueryResultsHandler getQueryResultsHandler(Query query, DataSource dataSource, KnowledgeSource knowledgeSource) throws QueryResultsHandlerInitException {
        if (query.getQueryMode() == QueryMode.UPDATE) {
            throw new QueryResultsHandlerInitException("Update mode not supported");
        }
        return new XmlQueryResultsHandler(this.writer, this.propOrder, this.initialPropId, this.propIds, knowledgeSource);
    }
    
    /**
     * Returns the proposition ids specified in the constructor.
     *
     * @return an array of proposition id {@link String}s. Guaranteed not
     * null.
     */
    @Override
    public String[] getSupportedPropositionIds(DataSource dataSource, KnowledgeSource knowledgeSource) {
        Set result = new HashSet<>();
        result.add(this.initialPropId);
        org.arp.javautil.arrays.Arrays.addAll(result, this.propIds);
        return result.toArray(new String[result.size()]);
    }

}