package eu.dnetlib.rmi.soap;

import java.util.List;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

import eu.dnetlib.rmi.objects.resultSet.ResultSet;
import eu.dnetlib.rmi.soap.exceptions.DocumentNotFoundException;
import eu.dnetlib.rmi.soap.exceptions.MDStoreServiceException;

@WebService(targetNamespace = "http://services.dnetlib.eu/")
public interface MDStoreService extends BaseService {

	/**
	 * Returns ResultSet EPR for delivered mdstore records.
	 * 
	 * @param mdId
	 * @param from
	 * @param until
	 * @param recordFilter
	 *            REGEX on the metadata record
	 * @return ResultSet EPR
	 * @throws MDStoreServiceException
	 */
	public ResultSet<String> deliverMDRecords(@WebParam(name = "mdId") final String mdId,
			@WebParam(name = "from") final String from,
			@WebParam(name = "until") final String until,
			@WebParam(name = "recordsFilter") final String recordFilter) throws MDStoreServiceException;

	/**
	 * Deliver single record from selected mdstore.
	 * 
	 * @param mdId
	 * @param recordId
	 * @return record
	 * @throws MDStoreServiceException
	 */
	public String deliverRecord(@WebParam(name = "mdId") final String mdId, @WebParam(name = "recordId") final String recordId) throws MDStoreServiceException,
			DocumentNotFoundException;

	/**
	 * Returns list of all stored indices.
	 * 
	 * @return list of all stored indices
	 */
	public List<String> getListOfMDStores() throws MDStoreServiceException;

	public List<String> listMDStores(@WebParam(name = "format") final String format,
			@WebParam(name = "layout") final String layout,
			@WebParam(name = "interpretation") final String interpretation) throws MDStoreServiceException;

	public ResultSet<String> bulkDeliverMDRecords(@WebParam(name = "format") final String format,
			@WebParam(name = "layout") final String layout,
			@WebParam(name = "interpretation") final String interpretation) throws MDStoreServiceException;

	/**
	 * Gets the size of the mdstore with the given identifier.
	 * 
	 * @param mdId
	 *            identifier of an mdstore
	 * @return the number of records in the store
	 */
	@WebMethod(operationName = "size")
	public int size(@WebParam(name = "mdId") final String mdId) throws MDStoreServiceException;

	/**
	 * Gets the sum of records stored in all mdstore with the given format, layout , interpretation
	 * 
	 * @param format
	 *            format
	 * @param layout
	 *            layout
	 * @param interpretation
	 *            interpretation
	 * @return the total number of records in the mdstores of the given type
	 */
	@WebMethod(operationName = "sizeByFormat")
	public int size(@WebParam(name = "format") final String format,
			@WebParam(name = "layout") final String layout,
			@WebParam(name = "interpretation") final String interpretation) throws MDStoreServiceException;
}