Module jonix.onix3
Package com.tectonica.jonix.onix3

Class Contributor

java.lang.Object
com.tectonica.jonix.onix3.Contributor
All Implemented Interfaces:
OnixComposite, OnixComposite.OnixSuperComposite, OnixTag, Serializable
public class Contributor extends Object implements OnixComposite.OnixSuperComposite, Serializable

Contributor composite (collection)

A group of data elements which together describe a personal or corporate contributor to a collection. Optional, and repeatable to describe multiple contributors. The <Contributor> composite is included here for use only by those ONIX communities whose national practice requires contributors to the collection as a whole (eg Series editors) to be identified at collection level. In many countries, including the UK, USA, Canada and Spain, the required practice is to identify all contributors at product level in Group P.7.

Reference name <Contributor>
Short tag <contributor>
Cardinality 0…n

This tag may be included in the following composites:

Possible placements within ONIX message:

See Also:

  • Field Details

  • Constructor Details

    • Contributor

      public Contributor()

    • Contributor

      public Contributor(Element element)

  • Method Details

    • _initialize

      public void _initialize()
      Description copied from interface: OnixComposite
      This is an internal API. Since Jonix 8.0, composite objects are being populated lazily. This method initiates the population process, and is invoked internally by the accessor APIs of the composites
      Specified by:
      _initialize in interface OnixComposite

    • exists

      public boolean exists()
      Description copied from interface: OnixTag
      indicates whether this tag exists in the ONIX record
      Specified by:
      exists in interface OnixTag
      Returns:
      whether this tag (<Contributor> or <contributor>) is explicitly provided in the ONIX XML

    • ifExists

      public void ifExists(Consumer<Contributor> action)

    • getXmlElement

      public Element getXmlElement()
      Description copied from interface: OnixComposite
      For advanced use-cases only.
      Specified by:
      getXmlElement in interface OnixComposite
      Returns:
      native representation of the XML element underlying to this tag

    • personName

      public PersonName personName()

      The name of a person who contributed to the creation of the product, unstructured, and presented in normal order. Optional and non-repeating: see Group P.7 introductory text for valid options.

      Jonix-Comment: this field is required

    • keyNames

      public KeyNames keyNames()

      The fourth part of a structured name of a person who contributed to the creation of the product: key name(s), ie the name elements normally used to open an entry in an alphabetical list, eg ‘Smith’ or ‘Garcia Marquez’ or ‘Madonna’ or ‘Francis de Sales’ (in Saint Francis de Sales). Non-repeating. Required if name part elements P.7.11 to P.7.18 are used.

      Jonix-Comment: this field is required

    • contributorRoles

      public ListOfOnixCodelist<ContributorRole,ContributorRoles> contributorRoles()

      An ONIX code indicating the role played by a person or corporate body in the creation of the product. Mandatory in each occurrence of a <Contributor> composite, and may be repeated if the same person or corporate body has more than one role in relation to the product.

      Jonix-Comment: this list is required to contain at least one item

    • nameIdentifiers

      public ListOfOnixDataCompositeWithKey<NameIdentifier,JonixNameIdentifier,NameIdentifierTypes> nameIdentifiers()

      A group of data elements which together specify a name identifier, used here to carry an identifier for a person or organization name given in an occurrence of the <Contributor> composite. Optional: see Group P.7 introductory text for valid options. Repeatable to specify name identifiers of different types for the same person or organization name.

      Jonix-Comment: this list is required to contain at least one item

    • corporateNames

      public ListOfOnixElement<CorporateName,String> corporateNames()

      The name of a corporate body which contributed to the creation of the product, unstructured, and presented in normal order. Optional: see Group P.7 introductory text for valid options. Repeatable, to provide parallel names for a single organization in multiple languages (eg ‘World Health Organization’ and « Organisation mondiale de la santé »).The language attribute is optional for a single instance of <CorporateName>, but must be included in each instance if <CorporateName> is repeated.

      Jonix-Comment: this list is required to contain at least one item

    • sequenceNumber

      public SequenceNumber sequenceNumber()

      A number which specifies a single overall sequence of contributor names (across the contributors in Groups P.7 and P.5). Optional and non-repeating. It is strongly recommended that each occurrence of the <Contributor> composite should carry a <SequenceNumber>.

      Jonix-Comment: this field is optional

    • nameType

      public NameType nameType()

      An ONIX code indicating the type of a primary name. Optional, and non-repeating. If omitted, the default is ‘unspecified’ (ie the name as it is presented on the book).

      Jonix-Comment: this field is optional

    • personNameInverted

      public PersonNameInverted personNameInverted()

      The name of a person who contributed to the creation of the product, presented with the element used for alphabetical sorting placed first (‘inverted order’). Optional and non-repeating: see Group P.7 introductory text for valid options.

      Jonix-Comment: this field is optional

    • titlesBeforeNames

      public TitlesBeforeNames titlesBeforeNames()

      The first part of a structured name of a person who contributed to the creation of the product: qualifications and/or titles preceding a person’s names, eg ‘Professor’ or ‘HRH Prince’ or ‘Saint’. Optional and non-repeating: see Group P.7 introductory text for valid options.

      Jonix-Comment: this field is optional

    • namesBeforeKey

      public NamesBeforeKey namesBeforeKey()

      The second part of a structured name of a person who contributed to the creation of the product: name(s) and/or initial(s) preceding a person’s key name(s), eg James J. Optional and non-repeating.

      Jonix-Comment: this field is optional

    • prefixToKey

      public PrefixToKey prefixToKey()

      The third part of a structured name of a person who contributed to the creation of the product: a prefix which precedes the key name(s) but which is not to be treated as part of the key name, eg ‘van’ in Ludwig van Beethoven. This element may also be used for titles that appear after given names and before key names, eg ‘Lord’ in Alfred, Lord Tennyson. Optional and non-repeating.

      Jonix-Comment: this field is optional

    • namesAfterKey

      public NamesAfterKey namesAfterKey()

      The fifth part of a structured name of a person who contributed to the creation of the product: name suffix, or name(s) following a person’s key name(s), eg ‘Ibrahim’ (in Anwar Ibrahim). Optional and non-repeating.

      Jonix-Comment: this field is optional

    • suffixToKey

      public SuffixToKey suffixToKey()

      The sixth part of a structured name of a person who contributed to the creation of the product: a suffix following a person’s key name(s), eg ‘Jr’ or ‘III’. Optional and non-repeating.

      Jonix-Comment: this field is optional

    • lettersAfterNames

      public LettersAfterNames lettersAfterNames()

      The seventh part of a structured name of a person who contributed to the creation of the product: qualifications and honors following a person’s names, eg ‘CBE FRS’. Optional and non-repeating.

      Jonix-Comment: this field is optional

    • titlesAfterNames

      public TitlesAfterNames titlesAfterNames()

      The eighth part of a structured name of a person who contributed to the creation of the product: titles following a person’s names, eg ‘Duke of Edinburgh’. Optional and non-repeating.

      Jonix-Comment: this field is optional

    • unnamedPersons

      public UnnamedPersons unnamedPersons()

      An ONIX code allowing a positive indication to be given when authorship is unknown or anonymous, or when as a matter of editorial policy only a limited number of contributors are named. Optional and non-repeating: see Group P.7 introductory text for valid options.

      Jonix-Comment: this field is optional

    • fromLanguages

      public ListOfOnixCodelist<FromLanguage,Languages> fromLanguages()

      Used only when the <ContributorRole> code value is B06, B08 or B10 indicating a translator, to specify the source language from which the translation was made. This element makes it possible to specify a translator’s exact responsibility when a work involves translation from two or more languages. Optional, and repeatable in the event that a single person has been responsible for translation from two or more languages.

      Jonix-Comment: this list may be empty

    • toLanguages

      public ListOfOnixCodelist<ToLanguage,Languages> toLanguages()

      Used only when the <ContributorRole> code value is B06, B08 or B10 indicating a translator, to specify the target language into which the translation was made. This element makes it possible to specify a translator’s exact responsibility when a work involves translation into two or more languages. Optional, and repeatable in the event that a single person has been responsible for translation to two or more languages.

      Jonix-Comment: this list may be empty

    • corporateNameInverteds

      public ListOfOnixElement<CorporateNameInverted,String> corporateNameInverteds()

      The name of a corporate body which contributed to the creation of the product, presented in inverted order, with the element used for alphabetical sorting placed first. Optional: see Group P.7 introductory text for valid options. Repeatable, to provide parallel names for a single organization in multiple languages (eg ‘Polar Research Foundation, The’ and ‚Polarforschungsinstitut, Das‘).The language attribute is optional for a single instance of <CorporateNameInverted>, but must be included in each instance if <CorporateNameInverted> is repeated.

      Jonix-Comment: this list may be empty

    • alternativeNames

      public ListOfOnixComposite<AlternativeName> alternativeNames()

      A group of data elements which together represent an alternative name of a contributor, and specify its type. The <AlternativeName> composite is optional, and is repeatable to give multiple alternative names for the contributor. It may be used to send a pseudonym as well as a real name, where both names are on the product, eg to handle such cases as ‘Ian Rankin writing as Jack Harvey’; or to send an authority-controlled form of a name; or to identify the real name of the contributor where the book is written under a pseudonym (and the real identity need not be kept private) or is anonymous. Note that in all cases, the primary name is that used on the product, and the alternative name merely provides additional information.

      Each instance of the composite must contain the <NameType> element with either:

      • one or more of the forms of representation of a person name, with or without an occurrence of the <NameIdentifier> composite; or
      • one or more of the forms of representation of a corporate name, with or without an occurrence of the <NameIdentifier> composite; or
      • an occurrence of the <NameIdentifier> composite without any accompanying name element(s).
      Jonix-Comment: this list may be empty

    • contributorDates

      public ListOfOnixDataCompositeWithKey<ContributorDate,JonixContributorDate,PersonOrganizationDateRoles> contributorDates()

      A group of data elements which together specify a date associated with the person or organization identified in an occurrence of the <Contributor> composite, eg birth or death. Optional, and repeatable to allow multiple dates to be specified.

      Jonix-Comment: this list may be empty

    • professionalAffiliations

      public ListOfOnixComposite<ProfessionalAffiliation> professionalAffiliations()

      An optional group of data elements which together identify a contributor’s professional position and/or affiliation, repeatable to allow multiple positions and affiliations to be specified.

      Jonix-Comment: this list may be empty

    • prizes

      public ListOfOnixComposite<Prize> prizes()

      An optional group of data elements which together describe a prize or award won by the contributor for a body of work (rather than for this or other specific works or products). Repeatable to describe multiple prizes or awards.

      Jonix-Comment: this list may be empty

    • biographicalNotes

      public ListOfOnixElement<BiographicalNote,String> biographicalNotes()

      A biographical note about a contributor to the product. (See the <TextContent> composite in Group P.14 for a biographical note covering all contributors to a product in a single text.) Optional, and repeatable to provide parallel biographical notes in multiple languages. The language attribute is optional for a single instance of <BiographicalNote>, but must be included in each instance if <BiographicalNote> is repeated. 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 below.

      Jonix-Comment: this list may be empty

    • websites

      public ListOfOnixDataComposite<Website,JonixWebsite> websites()

      An optional group of data elements which together identify and provide a pointer to a website which is related to the person or organization identified in an occurrence of the <Contributor> composite. Repeatable to provide links to multiple websites.

      Jonix-Comment: this list may be empty

    • contributorDescriptions

      public ListOfOnixElement<ContributorDescription,String> contributorDescriptions()

      Brief text describing a contributor to the product, at the publisher’s discretion. Optional, and repeatable to provide parallel descriptions in multiple languages. The language attribute is optional for a single instance of <ContributorDescription>, but must be included in each instance if <ContributorDescription> is repeated. It may be used with either a person or corporate name, to draw attention to any aspect of a contributor’s background which supports the promotion of the book.

      Jonix-Comment: this list may be empty

    • contributorPlaces

      public ListOfOnixDataComposite<ContributorPlace,JonixContributorPlace> contributorPlaces()

      An optional group of data elements which together identify a geographical location with which a contributor is associated, used to support ‘local interest’ promotions. Repeatable to identify multiple geographical locations, each usually with a different relationship to the contributor.

      Jonix-Comment: this list may be empty