org.apache.inlong.sort.filesystem.shaded.software.amazon.ion.impl.lite.IonContext Maven / Gradle / Ivy
/*
* Copyright 2010-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at:
*
* http://aws.amazon.com/apache2.0/
*
* or in the "license" file accompanying this file. This file 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 software.amazon.ion.impl.lite;
import software.amazon.ion.IonContainer;
import software.amazon.ion.SymbolTable;
/**
* Provides the parent, system and symbol table definitions that are shared
* by one or more hierarchies of IonValues.
*
* The type of context used by a value depends on its position.
*
* - Top-level values have either a {@link TopLevelContext} or an
* {@link IonSystemLite} for a context.
*
- Non-top-level values have their {@link IonContainer} for a context.
*
- Datagrams have their {@link IonSystemLite} for a context.
*
*
* Concrete
* contexts simply return the correct values (and
* own them). Containers return themselves as the
* parent and delegate to their parent for the
* system and symbol table values. Note that values
* contained directly by a datagram may store a
* symbol table locally as there may be more than
* one symbol table in a datagram.
*/
interface IonContext
{
/**
* Return the container of values associated with this context.
* If this context is an {@link IonContainerLite} it returns itself.
*
* @return the container of the value;
* null for stand-alone top level values.
*/
abstract IonContainerLite getContextContainer();
/**
* Get the IonSystem concrete object that created
* the IonValue that is associated with this context.
* Generally this delegates to the parent.
*
* @return not null
*/
abstract IonSystemLite getSystem();
/**
* Returns the symbol table that is directly assigned to this context.
* For {@link TopLevelContext} it is the symbol table member.
* For {@link IonContainerLite} and {@link IonSystemLite} it is null.
*
* @return the directly assigned symbol table, with no recursive lookup.
*/
abstract SymbolTable getContextSymbolTable();
}