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

Class Publisher

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

Publisher composite (content item)

A group of data elements which together identify an entity which is associated with the publishing of a content item, included here to allow roles such as Funder, Sponsor to be associated with a specific content item rather than the product as a whole. The composite allows additional publishing roles to be introduced without adding new fields. Each occurrence of the composite must carry a publishing role code and either a name identifier or a name or both. Optional, and repeatable in order to identify multiple entities.

Reference name <Publisher>
Short tag <publisher>
Cardinality 0…n

This tag may be included in the following composites:

Possible placements within ONIX message:

Since:
Onix-3.10
See Also:

  • Field Details

  • Constructor Details

    • Publisher

      public Publisher()

    • Publisher

      public Publisher(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 (<Publisher> or <publisher>) is explicitly provided in the ONIX XML

    • ifExists

      public void ifExists(Consumer<Publisher> 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

    • publishingRole

      public PublishingRole publishingRole()

      An ONIX code which identifies a role played by an entity in the publishing of a product. Mandatory in each occurrence of the <Publisher> composite, and non-repeating.

      Jonix-Comment: this field is required

    • publisherIdentifiers

      public ListOfOnixDataCompositeWithKey<PublisherIdentifier,JonixPublisherIdentifier,NameIdentifierTypes> publisherIdentifiers()

      An optional group of data elements which together define the identifier of a publisher name. Optional, but mandatory if the <Publisher> composite does not carry a <PublisherName>. The composite is repeatable in order to specify multiple identifiers for the same publisher.

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

    • publisherNames

      public ListOfOnixElement<PublisherName,String> publisherNames()

      The name of an entity associated with the publishing of a product. Mandatory if there is no publisher identifier in an occurrence of the <Publisher> composite, and optional if a publisher identifier is included. Repeatable if the entity is officially known by names in multiple languages. The language attribute is optional for a single instance of <PublisherName>, but must be included in each instance if <PublisherName> is repeated.

      Jonix-Comment: this list may be empty

    • fundings

      public ListOfOnixComposite<Funding> fundings()

      An optional group of data elements which together identify a grant or award provided by the entity specified as a funder in an occurrence of the <Publisher> composite, to subsidize research or publication. Repeatable when the funder provides multiple grants or awards. Used only when <PublishingRole> indicates the role of a funder.

      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 publisher identified in an occurrence of the <Publisher> composite. Repeatable in order to provide links to multiple websites.

      Jonix-Comment: this list may be empty