D-Net

package eu.dnetlib.rmi.data;

import java.util.List;

import javax.jws.WebParam;

import javax.jws.WebService;

import eu.dnetlib.rmi.common.BaseService;

import eu.dnetlib.rmi.common.ResultSet;

/** The Object Packaging Service is used to combine the records spread

 *  into one information package, namely an Object Record.

 */ 

@WebService(targetNamespace = "http://services.dnetlib.eu/")

public interface ObjectPackagingService extends BaseService {

	 /** Return the EPR of the resultSet containing the generated packages 

     * 

     * @param  eprs       A list of EPRs used to access the input resultSets. ResultSets MUST be ordered using an order key identified by xpath_ID 

     * @param  xpath_ID   A valid xpath, used to access the ordered ID of the elements of the input resultSets. 

     * @return            EPR of the generated resultset 

     */

	 ResultSet<String> generatePackages(@WebParam(name = "eprs") List<ResultSet<String>> eprs,

			 @WebParam(name="xpath_ID") String xpath_ID) throws ObjectPackagingException;

	/** Return the EPR of the resultSet containing the unpackaged element 

     * 

     * @param  epr       The epr used to access the resultset that contains input packages, packages are xml record in this format: <objectRecord><elem>REC1</elem><elem>REC2</elem><elem>REC3</elem></objectRecord>

     * @return           EPR of the generated resultset 

     */

	ResultSet<String> splitPackages(@WebParam(name = "epr") ResultSet<String> epr) throws ObjectPackagingException;

}