com.tectonica.jonix.onix2.SenderIdentifier Maven / Gradle / Ivy
Show all versions of jonix-onix2 Show documentation
/*
* 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.onix2;
import com.tectonica.jonix.common.JPU;
import com.tectonica.jonix.common.OnixComposite.OnixDataCompositeWithKey;
import com.tectonica.jonix.common.codelist.Languages;
import com.tectonica.jonix.common.codelist.NameIdentifierTypes;
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 com.tectonica.jonix.common.struct.JonixSenderIdentifier;
import java.io.Serializable;
import java.util.function.Consumer;
/*
* NOTE: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT MANUALLY
*/
/**
* Sender identifier composite
*
* A group of data elements which together define the identifier of the sender within a specified namespace, used here
* to allow different party identifiers to be included without defining additional data elements. In particular the
* composite allows a proprietary identifier to be used by mutual agreement between parties to an exchange. The
* composite is optional and repeatable; but either the <FromCompany> element or a sender identifier using one or
* more elements from MH.1 to MH.5 must be included.
*
*
*
* Reference name
* <SenderIdentifier>
*
*
* Short tag
* <senderidentifier>
*
*
*
* This tag may be included in the following composites:
*
* - <{@link Header}>
*
* Possible placements within ONIX message:
*
* - {@link Header} ⯈ {@link SenderIdentifier}
*
*/
public class SenderIdentifier
implements OnixDataCompositeWithKey, Serializable {
private static final long serialVersionUID = 1L;
public static final String refname = "SenderIdentifier";
public static final String shortname = "senderidentifier";
/////////////////////////////////////////////////////////////////////////////////
// ATTRIBUTES
/////////////////////////////////////////////////////////////////////////////////
public TextFormats textformat;
public TextCaseFlags textcase;
public Languages language;
public TransliterationSchemes transliteration;
/**
* (type: DateOrDateTime)
*/
public String datestamp;
public RecordSourceTypes sourcetype;
public String sourcename;
/////////////////////////////////////////////////////////////////////////////////
// CONSTRUCTION
/////////////////////////////////////////////////////////////////////////////////
private boolean initialized;
private final boolean exists;
private final org.w3c.dom.Element element;
public static final SenderIdentifier EMPTY = new SenderIdentifier();
public SenderIdentifier() {
exists = false;
element = null;
initialized = true; // so that no further processing will be done on this intentionally-empty object
}
public SenderIdentifier(org.w3c.dom.Element element) {
exists = true;
initialized = false;
this.element = element;
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");
}
@Override
public void _initialize() {
if (initialized) {
return;
}
initialized = true;
JPU.forElementsOf(element, e -> {
final String name = e.getNodeName();
switch (name) {
case SenderIDType.refname:
case SenderIDType.shortname:
senderIDType = new SenderIDType(e);
break;
case IDValue.refname:
case IDValue.shortname:
idValue = new IDValue(e);
break;
case IDTypeName.refname:
case IDTypeName.shortname:
idTypeName = new IDTypeName(e);
break;
default:
break;
}
});
}
/**
* @return whether this tag (<SenderIdentifier> or <senderidentifier>) is explicitly provided in the
* ONIX XML
*/
@Override
public boolean exists() {
return exists;
}
public void ifExists(Consumer action) {
if (exists) {
action.accept(this);
}
}
@Override
public org.w3c.dom.Element getXmlElement() {
return element;
}
/////////////////////////////////////////////////////////////////////////////////
// MEMBERS
/////////////////////////////////////////////////////////////////////////////////
private SenderIDType senderIDType = SenderIDType.EMPTY;
/**
*
* An ONIX code identifying the namespace from which the identifier in the <IDValue> element is taken.
* Mandatory in any occurrence of the <SenderIdentifier> composite, and non-repeating.
*
* JONIX adds: this field is required
*/
public SenderIDType senderIDType() {
_initialize();
return senderIDType;
}
private IDValue idValue = IDValue.EMPTY;
/**
*
* An identifier of the type specified in the <SenderIDType> element. Mandatory in any occurrence of the
* <SenderIdentifier> composite, and non-repeating.
*
* JONIX adds: this field is required
*/
public IDValue idValue() {
_initialize();
return idValue;
}
private IDTypeName idTypeName = IDTypeName.EMPTY;
/**
*
* A name which identifies a proprietary identifier type when, and only when, the code in the <SenderIDType>
* element indicates a proprietary scheme. Optional and non-repeating.
*
*
* The text is not limited to ASCII characters.
*
* JONIX adds: this field is optional
*/
public IDTypeName idTypeName() {
_initialize();
return idTypeName;
}
@Override
public JonixSenderIdentifier asStruct() {
_initialize();
JonixSenderIdentifier struct = new JonixSenderIdentifier();
struct.senderIDType = senderIDType.value;
struct.idTypeName = idTypeName.value;
struct.idValue = idValue.value;
return struct;
}
@Override
public NameIdentifierTypes structKey() {
return senderIDType().value;
}
}