jackcess/src/main/java/com/healthmarketscience/jackcess/impl/TableDefinitionImpl.java

/*
Copyright (c) 2022 James Ahlborn

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.healthmarketscience.jackcess.impl;

import java.io.IOException;
import java.nio.ByteBuffer;
import java.util.List;

/**
 * A database table definition which does not allow any actual data
 * interaction (read or write).
 * <p>
 * Note, in an ideal world, TableImpl would extend TableDefinitionImpl.
 * However, since TableDefinitionImpl came later, it was easier to do it this
 * way and avoid a lot of unnecessary code shuffling.
 * <p>
 * Is not thread-safe.
 *
 * @author James Ahlborn
 * @usage _advanced_class_
 */
public class TableDefinitionImpl extends TableImpl
{
  protected TableDefinitionImpl(DatabaseImpl database, ByteBuffer tableBuffer,
                                int pageNumber, String name, int flags)
    throws IOException {
    super(database, tableBuffer, pageNumber, name, flags);
  }

  @Override
  protected List<? extends Object[]> addRows(List<? extends Object[]> rows,
                                             final boolean isBatchWrite)
    throws IOException {
    // all row additions eventually flow through this method
    throw new UnsupportedOperationException(
        withErrorContext("TableDefinition has no data access"));
  }

  @Override
  public RowState createRowState() {
    // RowState is needed for all traversal operations, so this kills any data
    // reading as well as update/delete methods
    throw new UnsupportedOperationException(
        withErrorContext("TableDefinition has no data access"));
  }
}