All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.ibm.cloud.objectstorage.thirdparty.ion.impl.bin._Private_IonManagedBinaryWriterBuilder Maven / Gradle / Ivy

Go to download

A single bundled dependency that includes all service and dependent JARs with third-party libraries relocated to different namespaces.

There is a newer version: 2.13.4
Show newest version
/*
 * Copyright 2007-2019 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://www.apache.org/licenses/LICENSE-2.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.bin;

import static software.amazon.ion.impl.bin.IonManagedBinaryWriter.ONLY_SYSTEM_IMPORTS;

import software.amazon.ion.IonBinaryWriter;
import software.amazon.ion.IonCatalog;
import software.amazon.ion.IonException;
import software.amazon.ion.IonWriter;
import software.amazon.ion.SubstituteSymbolTableException;
import software.amazon.ion.SymbolTable;
import software.amazon.ion.SystemSymbols;
import software.amazon.ion.impl.bin.AbstractIonWriter.WriteValueOptimization;
import software.amazon.ion.impl.bin.IonBinaryWriterAdapter.Factory;
import software.amazon.ion.impl.bin.IonManagedBinaryWriter.ImportedSymbolContext;
import software.amazon.ion.impl.bin.IonManagedBinaryWriter.ImportedSymbolResolverMode;
import software.amazon.ion.impl.bin.IonRawBinaryWriter.PreallocationMode;
import software.amazon.ion.system.SimpleCatalog;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;
import java.util.List;

// TODO unify this with the IonWriter builder APIs

/**
 * Constructs instances of binary {@link IonWriter}.
 * 

* This class is thread-safe. */ @SuppressWarnings("deprecation") public final class _Private_IonManagedBinaryWriterBuilder { public enum AllocatorMode { POOLED { @Override BlockAllocatorProvider createAllocatorProvider() { return new PooledBlockAllocatorProvider(); } }, BASIC { @Override BlockAllocatorProvider createAllocatorProvider() { return BlockAllocatorProviders.basicProvider(); } }; /*package*/ abstract BlockAllocatorProvider createAllocatorProvider(); } public static final int DEFAULT_BLOCK_SIZE = 32768; /*package*/ final BlockAllocatorProvider provider; /*package*/ volatile int symbolsBlockSize; /*package*/ volatile int userBlockSize; /*package*/ volatile PreallocationMode preallocationMode; /*package*/ volatile ImportedSymbolContext imports; /*package*/ volatile IonCatalog catalog; /*package*/ volatile WriteValueOptimization optimization; /*package*/ volatile SymbolTable initialSymbolTable; /*package*/ volatile boolean isFloatBinary32Enabled; private _Private_IonManagedBinaryWriterBuilder(final BlockAllocatorProvider provider) { this.provider = provider; this.symbolsBlockSize = DEFAULT_BLOCK_SIZE; this.userBlockSize = DEFAULT_BLOCK_SIZE; this.imports = ONLY_SYSTEM_IMPORTS; this.preallocationMode = PreallocationMode.PREALLOCATE_2; this.catalog = new SimpleCatalog(); this.optimization = WriteValueOptimization.NONE; this.isFloatBinary32Enabled = false; } private _Private_IonManagedBinaryWriterBuilder(final _Private_IonManagedBinaryWriterBuilder other) { this.provider = other.provider; this.symbolsBlockSize = other.symbolsBlockSize; this.userBlockSize = other.userBlockSize; this.preallocationMode = other.preallocationMode; this.imports = other.imports; this.catalog = other.catalog; this.optimization = other.optimization; this.initialSymbolTable = other.initialSymbolTable; this.isFloatBinary32Enabled = other.isFloatBinary32Enabled; } public _Private_IonManagedBinaryWriterBuilder copy() { return new _Private_IonManagedBinaryWriterBuilder(this); } // Parameter Setting Methods public _Private_IonManagedBinaryWriterBuilder withSymbolsBlockSize(final int blockSize) { if (blockSize < 1) { throw new IllegalArgumentException("Block size cannot be less than 1: " + blockSize); } symbolsBlockSize = blockSize; return this; } public _Private_IonManagedBinaryWriterBuilder withUserBlockSize(final int blockSize) { if (blockSize < 1) { throw new IllegalArgumentException("Block size cannot be less than 1: " + blockSize); } userBlockSize = blockSize; return this; } public _Private_IonManagedBinaryWriterBuilder withImports(final SymbolTable... tables) { if (tables != null) { return withImports(Arrays.asList(tables)); } return this; } public _Private_IonManagedBinaryWriterBuilder withImports(final List tables) { return withImports(ImportedSymbolResolverMode.DELEGATE, tables); } /** * Adds imports, flattening them to make lookup more efficient. This is particularly useful * when a builder instance is long lived. */ public _Private_IonManagedBinaryWriterBuilder withFlatImports(final SymbolTable... tables) { if (tables != null) { return withFlatImports(Arrays.asList(tables)); } return this; } /** @see #withFlatImports(SymbolTable...) */ public _Private_IonManagedBinaryWriterBuilder withFlatImports(final List tables) { return withImports(ImportedSymbolResolverMode.FLAT, tables); } /*package*/ _Private_IonManagedBinaryWriterBuilder withImports(final ImportedSymbolResolverMode mode, final List tables) { imports = new ImportedSymbolContext(mode, tables); return this; } /*package*/ _Private_IonManagedBinaryWriterBuilder withPreallocationMode(final PreallocationMode preallocationMode) { this.preallocationMode = preallocationMode; return this; } public _Private_IonManagedBinaryWriterBuilder withPaddedLengthPreallocation(final int pad) { this.preallocationMode = PreallocationMode.withPadSize(pad); return this; } public _Private_IonManagedBinaryWriterBuilder withCatalog(final IonCatalog catalog) { this.catalog = catalog; return this; } public _Private_IonManagedBinaryWriterBuilder withStreamCopyOptimization(boolean optimized) { this.optimization = optimized ? WriteValueOptimization.COPY_OPTIMIZED : WriteValueOptimization.NONE; return this; } public _Private_IonManagedBinaryWriterBuilder withFloatBinary32Enabled() { isFloatBinary32Enabled = true; return this; } public _Private_IonManagedBinaryWriterBuilder withFloatBinary32Disabled() { isFloatBinary32Enabled = false; return this; } public _Private_IonManagedBinaryWriterBuilder withInitialSymbolTable(SymbolTable symbolTable) { if (symbolTable != null) { if (!symbolTable.isLocalTable() && !symbolTable.isSystemTable()) { throw new IllegalArgumentException("Initial symbol table must be local or system"); } if (symbolTable.isSystemTable()) { if (symbolTable.getMaxId() != SystemSymbols.ION_1_0_MAX_ID) { throw new IllegalArgumentException("Unsupported system symbol table"); } // don't need to set an explicit symbol table for system 1.0 symbolTable = null; } else { // initial symbol table is local for (final SymbolTable st : symbolTable.getImportedTables()) { if (st.isSubstitute()) { throw new SubstituteSymbolTableException( "Cannot use initial symbol table with imported substitutes"); } } } } this.initialSymbolTable = symbolTable; return this; } // Construction public IonWriter newWriter(final OutputStream out) throws IOException { return new IonManagedBinaryWriter(this, out); } public IonBinaryWriter newLegacyWriter() { try { return new IonBinaryWriterAdapter( new Factory() { public IonWriter create(final OutputStream out) throws IOException { return newWriter(out); } } ); } catch (final IOException e) { throw new IonException("I/O error", e); } } // Static Factories /** * Constructs a new builder. *

* Builders generally bind to an allocation pool as defined by {@link AllocatorMode}, so applications should reuse * them as much as possible. */ public static _Private_IonManagedBinaryWriterBuilder create(final AllocatorMode allocatorMode) { return new _Private_IonManagedBinaryWriterBuilder(allocatorMode.createAllocatorProvider()); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy