com.tectonica.jonix.onix3.ResourceLink Maven / Gradle / Ivy
/*
* Copyright (C) 2012-2024 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.onix3;
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 java.io.Serializable;
import java.util.function.Consumer;
/*
* NOTE: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT MANUALLY
*/
/**
* Resource link
*
* A URL which provides a link to cited content which is accessible in digital form. Optional, and repeatable if the
* resource can be linked in more than one way, eg by URL or DOI, or where a cited resource is available in
* multiple parallel languages. Where multiple languages are used, all repeats must carry the language attribute.
*
*
*
* Format
* Uniform Resource Locator, expressed in full URI syntax in accordance with W3C standards, suggested maximum length
* 300 characters. Note that non-ASCII characters, spaces and a handful of other special characters should be
* 'URL-encoded'
*
*
* Reference name
* <ResourceLink>
*
*
* Short tag
* <x435>
*
*
* Cardinality
* 0…n
*
*
* Attributes
* language
*
*
* Example
* <x435>https://www.zzzzzzzz.com/resource.htm</x435>
*
*
*
* This tag may be included in the following composites:
*
* - <{@link CitedContent}>
* - <{@link ResourceVersion}>
*
*
* Possible placements within ONIX message:
*
* - {@link Product} ⯈ {@link ContentDetail} ⯈ {@link ContentItem} ⯈ {@link CitedContent} ⯈ {@link ResourceLink}
* - {@link Product} ⯈ {@link CollateralDetail} ⯈ {@link CitedContent} ⯈ {@link ResourceLink}
* - {@link Product} ⯈ {@link ContentDetail} ⯈ {@link ContentItem} ⯈ {@link SupportingResource} ⯈
* {@link ResourceVersion} ⯈ {@link ResourceLink}
* - {@link Product} ⯈ {@link CollateralDetail} ⯈ {@link SupportingResource} ⯈ {@link ResourceVersion} ⯈
* {@link ResourceLink}
* - {@link Product} ⯈ {@link ProductSupply} ⯈ {@link SupplyDetail} ⯈ {@link Reissue} ⯈ {@link SupportingResource} ⯈
* {@link ResourceVersion} ⯈ {@link ResourceLink}
* - {@link Product} ⯈ {@link PromotionDetail} ⯈ {@link PromotionalEvent} ⯈ {@link EventOccurrence} ⯈
* {@link SupportingResource} ⯈ {@link ResourceVersion} ⯈ {@link ResourceLink}
* - {@link Product} ⯈ {@link PromotionDetail} ⯈ {@link PromotionalEvent} ⯈ {@link SupportingResource} ⯈
* {@link ResourceVersion} ⯈ {@link ResourceLink}
*
*/
public class ResourceLink implements OnixElement, Serializable {
private static final long serialVersionUID = 1L;
public static final String refname = "ResourceLink";
public static final String shortname = "x435";
/////////////////////////////////////////////////////////////////////////////////
// ATTRIBUTES
/////////////////////////////////////////////////////////////////////////////////
/**
* (type: dt.DateOrDateTime)
*/
public String datestamp;
/**
* (type: dt.NonEmptyString)
*/
public String sourcename;
public RecordSourceTypes sourcetype;
public Languages language;
/////////////////////////////////////////////////////////////////////////////////
// VALUE MEMBER
/////////////////////////////////////////////////////////////////////////////////
/**
* This is the raw content of ResourceLink. 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: Uniform Resource Locator, expressed in full URI syntax in accordance with W3C standards, suggested
* maximum length 300 characters. Note that non-ASCII characters, spaces and a handful of other special characters
* should be 'URL-encoded'
*
* (type: dt.NonEmptyURI)
*/
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 ResourceLink EMPTY = new ResourceLink();
public ResourceLink() {
exists = false;
}
public ResourceLink(org.w3c.dom.Element element) {
exists = true;
datestamp = JPU.getAttribute(element, "datestamp");
sourcename = JPU.getAttribute(element, "sourcename");
sourcetype = RecordSourceTypes.byCode(JPU.getAttribute(element, "sourcetype"));
language = Languages.byCode(JPU.getAttribute(element, "language"));
value = JPU.getContentAsString(element);
}
/**
* @return whether this tag (<ResourceLink> or <x435>) is explicitly provided in the ONIX XML
*/
@Override
public boolean exists() {
return exists;
}
public void ifExists(Consumer action) {
if (exists) {
action.accept(this);
}
}
}