* Basic usage: *
* *
* InputStream input = new FileInputStream("file.xml");
* MarcReader reader = new MarcXmlReader(input);
* while (reader.hasNext()) {
* Record record = reader.next();
* // Process record
* }
*
* * Check the {@link org.marc4j.marc} package for examples about the use of the {@link org.marc4j.marc.Record} * object model. *
** You can also pre-process the source to create MARC XML from a different format using an XSLT stylesheet. The * following example creates an iterator over a collection of MARC records in MARC XML format from a MODS source and * outputs MARC records in MARC21 format: *
* *
* InputStream in = new FileInputStream("modsfile.xml");
*
* MarcStreamWriter writer = new MarcStreamWriter(System.out, Constants.MARC8);
* MarcXmlReader reader =
* new MarcXmlReader(in, "http://www.loc.gov/standards/marcxml/xslt/MODS2MARC21slim.xsl");
* while (reader.hasNext()) {
* Record record = reader.next();
* writer.write(record);
* }
* writer.close();
*
*
* @author Bas Peters
*/
public class MarcXmlReader implements MarcReader {
private final RecordStack queue;
/**
* Constructs an instance with the specified input stream.
*
* @param input the input stream
*/
public MarcXmlReader(final InputStream input) {
this(new InputSource(input));
}
/**
* Constructs an instance with the specified input source.
*
* @param input the input source
*/
public MarcXmlReader(final InputSource input) {
this.queue = new RecordStack();
final MarcXmlParserThread producer = new MarcXmlParserThread(queue, input);
producer.start();
}
/**
* Constructs an instance with the specified input stream and stylesheet
* location.
*
* The stylesheet is used to transform the source file and should produce
* valid MARC XML records. The result is then used to create
* Record objects.
*
* @param input the input stream
* @param stylesheetUrl the stylesheet location
*/
public MarcXmlReader(final InputStream input, final String stylesheetUrl) {
this(new InputSource(input), new StreamSource(stylesheetUrl));
}
/**
* Constructs an instance with the specified input stream and stylesheet
* source.
*
* The stylesheet is used to transform the source file and should produce
* valid MARCXML records. The result is then used to create
* Record objects.
*
* @param input the input stream
* @param stylesheet the stylesheet source
*/
public MarcXmlReader(final InputStream input, final Source stylesheet) {
this(new InputSource(input), stylesheet);
}
/**
* Constructs an instance with the specified input source and stylesheet
* source.
*
* The stylesheet is used to transform the source file and should produce
* valid MARCXML records. The result is then used to create
* Record objects.
*
* @param input the input source
* @param stylesheet the stylesheet source
*/
public MarcXmlReader(final InputSource input, final Source stylesheet) {
this.queue = new RecordStack();
final MarcXmlParserThread producer = new MarcXmlParserThread(queue, input);
final TransformerFactory factory = TransformerFactory.newInstance();
final SAXTransformerFactory stf = (SAXTransformerFactory) factory;
TransformerHandler th = null;
try {
th = stf.newTransformerHandler(stylesheet);
} catch (final TransformerConfigurationException e) {
throw new MarcException("Error creating TransformerHandler", e);
}
producer.setTransformerHandler(th);
producer.start();
}
/**
* Constructs an instance with the specified input stream and transformer
* handler.
*
* The {@link javax.xml.transform.sax.TransformerHandler} is used to
* transform the source file and should produce valid MARCXML records. The
* result is then used to create Record objects. A
* TransformerHandler can be obtained from a
* SAXTransformerFactory with either a
* {@link javax.xml.transform.Source} or
* {@link javax.xml.transform.Templates} object.
*
* @param input the input stream
* @param th the transformation content handler
*/
public MarcXmlReader(final InputStream input, final TransformerHandler th) {
this(new InputSource(input), th);
}
/**
* Constructs an instance with the specified input source and transformer
* handler.
*
* The {@link javax.xml.transform.sax.TransformerHandler} is used to
* transform the source file and should produce valid MARCXML records. The
* result is then used to create Record objects. A
* TransformerHandler can be obtained from a
* SAXTransformerFactory with either a
* {@link javax.xml.transform.Source} or
* {@link javax.xml.transform.Templates} object.
*
* @param input the input source
* @param th the transformation content handler
*/
public MarcXmlReader(final InputSource input, final TransformerHandler th) {
this.queue = new RecordStack();
final MarcXmlParserThread producer = new MarcXmlParserThread(queue, input);
producer.setTransformerHandler(th);
producer.start();
}
/**
* Returns true if the iteration has more records, false otherwise.
*
* @return boolean - true if the iteration has more records, false otherwise
*/
@Override
public boolean hasNext() {
return queue.hasNext();
}
/**
* Returns the next record in the iteration.
*
* @return Record - the record object
*/
@Override
public Record next() {
return queue.pop();
}
}