EpnTapController.java 4.07 KB
/*
 * This file is a part of EpnTAPClient.
 * This program aims to provide EPN-TAP support for software clients, like CASSIS spectrum analyzer.
 * See draft specifications: https://voparis-confluence.obspm.fr/pages/viewpage.action?pageId=559861
 * Copyright (C) 2016 Institut de Recherche en Astrophysique et Planétologie.
 *
 * This program is free software: you can
 * redistribute it and/or modify it under the terms of the GNU General Public License as published
 * by the Free Software Foundation, either version 3 of the License, or (at your option) any later
 * version. This program is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE. See the GNU General Public License for more details. You should have received a copy of
 * the GNU General Public License along with this program. If not, see
 * <http://www.gnu.org/licenses/>.
 */

package eu.omp.irap.vespa.epntapclient.epntap;

import java.util.List;
import java.util.logging.Logger;

import eu.omp.irap.vespa.epntapclient.epntap.request.RequestCtrl;
import eu.omp.irap.vespa.epntapclient.epntap.service.Queries;
import eu.omp.irap.vespa.epntapclient.epntap.service.ServiceCore;
import eu.omp.irap.vespa.epntapclient.epntap.service.ServicesList;
import eu.omp.irap.vespa.votable.Consts;
import eu.omp.irap.vespa.votable.utils.StringJoiner;
import eu.omp.irap.vespa.votable.votable.VOTableCtrl;
import eu.omp.irap.vespa.votable.votable.VOTableException;

/**
 * The main controller which manage views and controllers.
 *
 * @author N. Jourdane
 */
public abstract class EpnTapController {

	/** The logger for the class EpnTapController. */
	private static final Logger LOGGER = Logger.getLogger(EpnTapController.class.getName());

	/** The request controller, to manage requests. */
	private RequestCtrl requestCtrl;

	/** The controller of the VOTable displaying the result. */
	private VOTableCtrl resultsCtrl;

	/** The controller of the VOTable displaying the list of services. */
	private VOTableCtrl servicesCtrl;

	/**
	 * The path of the VOTable to parse. Will be affected to a temporary folder if not assigned
	 * through the controller.
	 */
	private String voTablePath;


	/**
	 * @return The request controller.
	 */
	public RequestCtrl getRequestCtrl() {
		return requestCtrl;
	}

	/**
	 * @return The controller of the VOTable which displays the result of the query.
	 */
	public VOTableCtrl getResultsCtrl() {
		return resultsCtrl;
	}

	/**
	 * @return The controller of the VOTable which displays the list of services.
	 */
	public VOTableCtrl getServicesCtrl() {
		return servicesCtrl;
	}

	/**
	 * @return the path of the XML VOTable file.
	 */
	public String getVOTablePath() {
		return voTablePath;
	}

	/**
	 * Get the services from the XML path or the targetURL / query.
	 *
	 * @throws VOTableException Can not read the services.
	 */
	public void readServices() throws VOTableException {
		// Here getServicesCtrl() is used instead of class field servicesCtrl to get the
		// subclass field, since subclasses overrides getServicesCtrl().
		String query = String.format(Queries.SELECT_ALL_TAP_SERVICES_WHERE_CORE,
				ServiceCore.EPNCORE);
		getServicesCtrl().newVOTable(Consts.DEFAULT_REGISTRY_URL, query);
	}

	/**
	 * ...
	 *
	 * @param services The services to send the queries.
	 * @throws VOTableException Can not update the VOTable.
	 */
	public void sendQueries(ServicesList services) throws VOTableException {
		// Here getRequestCtrl() and getResultsCtrl() are used instead of class fields requestCtrl
		// and resultCtrl to get the subclass field, since subclasses overrides getRequestCtrl() and
		// getResultsCtrl().
		List<String> servicesUrls = services.getTargetUrls();
		LOGGER.info("Sending query(ies) on " + StringJoiner.join(servicesUrls));
		for (int i = 0; i < servicesUrls.size(); i++) {
			String query = getRequestCtrl().getQuery(services.getTableNames().get(i));
			if (i == 0) {
				getResultsCtrl().newVOTable(servicesUrls.get(i), query);
			} else {
				getResultsCtrl().appendVOTable(servicesUrls.get(i), query);
			}
		}

	}
}