info.freelibrary.marc4j.impl.DataFieldImpl Maven / Gradle / Ivy
Show all versions of freelib-marc4j Show documentation
/**
* Copyright (C) 2004 Bas Peters
*
* This file is part of MARC4J
*
* MARC4J is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* MARC4J 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with MARC4J; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
package info.freelibrary.marc4j.impl;
import org.marc4j.marc.InvalidMARCException;
import org.marc4j.marc.IllegalAddException;
import org.marc4j.marc.DataField;
import org.marc4j.marc.Subfield;
import java.util.ArrayList;
import java.util.List;
/**
* DataField defines behavior for a data field (tag 010-999).
*
* Data fields are variable fields identified by tags beginning with ASCII
* numeric values other than two zero's. Data fields contain indicators,
* subfield codes, data and a field terminator.
*
* @author Bas Peters
* @author Kevin S. Clarke
*/
public class DataFieldImpl extends VariableFieldImpl implements DataField {
private static final long serialVersionUID = -1804044736102463060L;
private char myFirstInd;
private char mySecondInd;
private List mySubfields = new ArrayList();
/**
* Creates a new DataField.
*/
DataFieldImpl() {
}
/**
* Creates a new DataField and sets the tag name and the first
* and second indicator.
*
* @param aTag The tag name
* @param aFirstInd The first indicator
* @param aSecondInd The second indicator
*/
DataFieldImpl(String aTag, char aFirstInd, char aSecondInd) {
setTag(aTag);
setIndicator1(aFirstInd);
setIndicator2(aSecondInd);
}
/**
* Sets the tag of a DataField.
*
* @param aTag The tag of a DataField
*/
public void setTag(String aTag) {
super.setTag(aTag);
if (aTag.length() == 3) {
try {
if (Integer.parseInt(aTag) < 10) {
throw new InvalidMARCException(aTag +
" is not a valid DataField tag");
}
} catch (NumberFormatException details) {
throw new InvalidMARCException(aTag + " is not a number");
}
} else {
throw new InvalidMARCException(aTag + " is not a three digit tag");
}
}
/**
* Sets the field's first indicator.
*
* @param aFirstInd The first indicator
*/
public void setIndicator1(char aFirstInd) {
myFirstInd = aFirstInd;
}
/**
* Returns the field's first indicator.
*
* @return The field's first indicator
*/
public char getIndicator1() {
return myFirstInd;
}
/**
* Sets the field's second indicator.
*
* @param aSecondInd The field's second indicator
*/
public void setIndicator2(char aSecondInd) {
mySecondInd = aSecondInd;
}
/**
* Returns the field's second indicator
*
* @return The field's second indicator
*/
public char getIndicator2() {
return mySecondInd;
}
/**
* Adds a Subfield.
*
* @param aSubfield The Subfield of a DataField
* @throws IllegalAddException when the parameter is not an instance of
* SubfieldImpl
*/
public void addSubfield(Subfield aSubfield) {
if (aSubfield instanceof SubfieldImpl) {
mySubfields.add(aSubfield);
} else {
throw new IllegalAddException(
"Supplied Subfield isn't an instance of SubfieldImpl");
}
}
/**
* Inserts a Subfield at the specified position.
*
* @param aIndex The subfield's position within the list
* @param aSubfield The Subfield object
* @throws IllegalAddException when supplied Subfield isn't an instance of
* SubfieldImpl
*/
public void addSubfield(int aIndex, Subfield aSubfield) {
mySubfields.add(aIndex, aSubfield);
}
/**
* Removes a Subfield from the field.
*
* @param aSubfield The subfield to remove from the field.
*/
public void removeSubfield(Subfield aSubfield) {
mySubfields.remove(aSubfield);
}
/**
* Returns the list of Subfield objects.
*
* @return The list of Subfield objects
*/
public List getSubfields() {
// TODO: consistent result/expectation as getSubfields(char)?
return mySubfields;
}
/**
* Returns the {@link Subfield}s with the supplied char code.
*
* @param aCode A subfield code
* @return A {@link List} of {@link Subfield}s
*/
public List getSubfields(char aCode) {
List subfields = new ArrayList();
for (Subfield subfield : mySubfields) {
if (subfield.getCode() == aCode) {
subfields.add(subfield);
}
}
return subfields;
}
/**
* Returns the number of subfields in this DataField.
*
* @return The number of subfields in this DataField
*/
public int countSubfields() {
return mySubfields != null ? mySubfields.size() : 0;
}
/**
* Returns the first {@link Subfield} matching the supplied
* char code.
*
* @param aCode A code for the subfield to be returned
*/
public Subfield getSubfield(char aCode) {
for (Subfield subfield : mySubfields) {
if (subfield.getCode() == aCode) {
return subfield;
}
}
return null;
}
/**
* Returns true if a match is found for the supplied regular
* expression pattern; else, false.
*
* @param aPattern A regular expression pattern to find in the subfields
*/
public boolean find(String aPattern) {
for (Subfield subfield : mySubfields) {
if (subfield.find(aPattern)) {
return true;
}
}
return false;
}
/**
* Returns a string representation of this data field.
*
* Example:
*
*
* 245 10$aSummerland /$cMichael Chabon.
*
*
* @return A string representation of this data field
*/
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append(super.toString());
sb.append(' ');
sb.append(getIndicator1());
sb.append(getIndicator2());
for (Subfield subfield : mySubfields) {
sb.append(subfield.toString());
}
return sb.toString();
}
}