com.tectonica.jonix.onix2.BiographicalNote Maven / Gradle / Ivy
Show all versions of jonix-onix2 Show documentation
/*
* Copyright (C) 2012-2023 Zach Melamed
*
* Latest version available online at https://github.com/zach-m/jonix
* Contact me at [email protected]
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.tectonica.jonix.onix2;
import com.tectonica.jonix.common.JPU;
import com.tectonica.jonix.common.OnixElement;
import com.tectonica.jonix.common.codelist.Languages;
import com.tectonica.jonix.common.codelist.RecordSourceTypes;
import com.tectonica.jonix.common.codelist.TextCaseFlags;
import com.tectonica.jonix.common.codelist.TextFormats;
import com.tectonica.jonix.common.codelist.TransliterationSchemes;
import java.io.Serializable;
import java.util.function.Consumer;
/*
* NOTE: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT MANUALLY
*/
/**
* Biographical note
*
* A biographical note about a contributor to the product. (See the <OtherText> composite in Group PR.15 for
* a biographical note covering all contributors to a product in a single text.) Optional and non-repeating. May occur
* with a person name or with a corporate name. A biographical note in ONIX should always contain the name of the person
* or body concerned, and it should always be presented as a piece of continuous text consisting of full sentences. Some
* recipients of ONIX data feeds will not accept text which has embedded URLs. A contributor website link can be sent
* using the <Website> composite on the next page.
*
*
* The <BiographicalNote> element may carry any of the following ONIX attributes: textformat, language,
* transliteration, textcase.
*
*
*
* Format
* Variable-length text, suggested maximum length 500 characters (XHTML is enabled in this element - see ONIX for
* Books - Product Information Message - XML Message Specification, Section 7)
*
*
* Reference name
* <BiographicalNote>
*
*
* Short tag
* <b044>
*
*
* Example
* <BiographicalNote>Umberto Eco, professor of semiotics at the University of Bologna, and author of “The Name Of The Rose” and “Foucault's Pendulum”, is one of the world's bestselling novelists.</BiographicalNote>
*
*
*
* This tag may be included in the following composites:
*
* - <{@link Contributor}>
*
*
* Possible placements within ONIX message:
*
* - {@link Product} ⯈ {@link Contributor} ⯈ {@link BiographicalNote}
* - {@link Product} ⯈ {@link ContentItem} ⯈ {@link Contributor} ⯈ {@link BiographicalNote}
* - {@link SubSeriesRecord} ⯈ {@link Contributor} ⯈ {@link BiographicalNote}
* - {@link MainSeriesRecord} ⯈ {@link Contributor} ⯈ {@link BiographicalNote}
* - {@link Product} ⯈ {@link Series} ⯈ {@link Contributor} ⯈ {@link BiographicalNote}
*
*/
public class BiographicalNote implements OnixElement, Serializable {
private static final long serialVersionUID = 1L;
public static final String refname = "BiographicalNote";
public static final String shortname = "b044";
/////////////////////////////////////////////////////////////////////////////////
// ATTRIBUTES
/////////////////////////////////////////////////////////////////////////////////
public TextFormats textformat;
public TextCaseFlags textcase;
public Languages language;
public TransliterationSchemes transliteration;
/**
* (type: DateOrDateTime)
*/
public String datestamp;
public RecordSourceTypes sourcetype;
public String sourcename;
/////////////////////////////////////////////////////////////////////////////////
// VALUE MEMBER
/////////////////////////////////////////////////////////////////////////////////
/**
* This is the raw content of BiographicalNote. Could be null if {@code exists() == false}. Use {@link #value()}
* instead if you want to get this as an {@link java.util.Optional}.
*
* Raw Format: Variable-length text, suggested maximum length 500 characters (XHTML is enabled in this element - see
* ONIX for Books - Product Information Message - XML Message Specification, Section 7)
*
* (type: XHTML)
*/
public String value;
/**
* Internal API, use the {@link #value()} method or the {@link #value} field instead
*/
@Override
public String __v() {
return value;
}
/////////////////////////////////////////////////////////////////////////////////
// SERVICES
/////////////////////////////////////////////////////////////////////////////////
private final boolean exists;
public static final BiographicalNote EMPTY = new BiographicalNote();
public BiographicalNote() {
exists = false;
}
public BiographicalNote(org.w3c.dom.Element element) {
exists = true;
textformat = TextFormats.byCode(JPU.getAttribute(element, "textformat"));
textcase = TextCaseFlags.byCode(JPU.getAttribute(element, "textcase"));
language = Languages.byCode(JPU.getAttribute(element, "language"));
transliteration = TransliterationSchemes.byCode(JPU.getAttribute(element, "transliteration"));
datestamp = JPU.getAttribute(element, "datestamp");
sourcetype = RecordSourceTypes.byCode(JPU.getAttribute(element, "sourcetype"));
sourcename = JPU.getAttribute(element, "sourcename");
value = JPU.getChildXHTML(element, true);
}
/**
* @return whether this tag (<BiographicalNote> or <b044>) is explicitly provided in the ONIX XML
*/
@Override
public boolean exists() {
return exists;
}
public void ifExists(Consumer action) {
if (exists) {
action.accept(this);
}
}
}