elaborating javadoc'

This commit is contained in:
Roeland
2016-04-13 13:27:00 +02:00
committed by Tim Donohue
parent 8eafa4b3f1
commit b3a67e716c
3 changed files with 11 additions and 5 deletions

View File

@@ -16,6 +16,7 @@ import org.dspace.content.Item;
import org.dspace.importer.external.MetadataSourceException;
import org.dspace.importer.external.Query;
import org.dspace.importer.external.datamodel.ImportRecord;
import org.dspace.importer.external.service.AbstractImportMetadataSourceService;
import org.jaxen.JaxenException;
import javax.ws.rs.client.Client;
@@ -33,7 +34,7 @@ import java.util.concurrent.Callable;
/**
* Implements a data source for querying pubmed central
*/
public class ImportMetadataSourceServiceImpl extends org.dspace.importer.external.service.AbstractImportMetadataSourceService {
public class ImportMetadataSourceServiceImpl extends AbstractImportMetadataSourceService<OMElement> {
private String baseAddress;
private WebTarget pubmedWebTarget;

View File

@@ -20,8 +20,11 @@ import org.springframework.beans.factory.annotation.Required;
import java.util.LinkedList;
/** AbstractImportSourceService has a generic type set 'RecordType'.
* In the importer implementation this type set should be the class of the records received from the remote source's response
/**
* This class is a partial implementaiton of {@link Imports}. It provides assistance with mapping metadata from source format to DSpace format.
* AbstractImportSourceService has a generic type set 'RecordType'.
* In the importer implementation this type set should be the class of the records received from the remote source's response.
*
* @author Roeland Dillen (roeland at atmire dot com)
*
*/
@@ -38,7 +41,7 @@ public abstract class AbstractImportMetadataSourceService<RecordType> extends Me
}
/**
* Set the {@link GenerateQueryService} used to create a {@link org.dspace.importer.external.Query}
* Set the {@link GenerateQueryService} used to create a {@link org.dspace.importer.external.Query} for a DSpace {@link org.dspace.content.Item}
* @param generateQueryForItem
*/
@Autowired

View File

@@ -21,7 +21,9 @@ import java.util.concurrent.Callable;
import java.util.concurrent.locks.ReentrantLock;
/**
* This class contains functionality to handle request timeouts and to retry requests.
* This class contains primitives to handle request timeouts and to retry requests.
* This is achieved by classifying exceptions as fatal or as non fatal/retryable.
* Evidently only subclasses can make the proper determination of what is retryable and what isn't.
* This is useful in case the service employs throttling and to deal with general network issues.
* @author: Antoine Snyers (antoine at atmire dot com)
*/