org.eclipse.persistence.internal.oxm.mappings.UnionField Maven / Gradle / Ivy
Show all versions of eclipselink Show documentation
/*
* Copyright (c) 2012, 2024 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0 which is available at
* http://www.eclipse.org/legal/epl-2.0,
* or the Eclipse Distribution License v. 1.0 which is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* SPDX-License-Identifier: EPL-2.0 OR BSD-3-Clause
*/
// Contributors:
// Blaise Doughan - 2.5 - initial implementation
package org.eclipse.persistence.internal.oxm.mappings;
import org.eclipse.persistence.internal.oxm.Constants;
import org.eclipse.persistence.internal.oxm.ConversionManager;
import org.eclipse.persistence.internal.oxm.NamespaceResolver;
import javax.xml.namespace.QName;
import java.util.List;
/**
* Subclass of Field for fields that are mapped to unions. Maintains a list
* of schema types instead of just one single schema type. Schema types can be
* added using the addSchemaType API.
*
* Constants has a list of useful constants including a list of QNames for
* built-in schema types that can be used when adding schema types.
*
*
When reading and writing an element that is mapped with an UnionField, a
* conversion to each of the schema types on the field (in the order they are
* specified ) is tried until a conversion is successful. The Java type to
* convert to is based on the list of schema type to Java conversion pairs
* specified on the field.
* @see Field
* @see Constants
*/
public interface UnionField<
CONVERSION_MANAGER extends ConversionManager,
NAMESPACE_RESOLVER extends NamespaceResolver> extends Field {
/**
* Adds the new type value to the list of types
* @param value QName to be added to the list of schema types
*/
void addSchemaType(QName value);
/**
* Return the list of schema types
* @return the list of types
*/
List getSchemaTypes();
}