[core] Introduce withReadType in ReadBuilder

[Zouxxyy]

Purpose

To #4209

public API

 /**
   * Push row type to the reader, support nested row pruning.
   *
   * @param readType read row type, can be a subset of {@link Table#rowType()}
   * @since 1.0.0
   */
  ReadBuilder withReadType(RowType readType);

mark ReadBuilder withProjection(int[][] projection) and ReadBuilder withProjection(int[] projection) as Deprecated

how to use

RowType writeType =
        DataTypes.ROW(
                DataTypes.FIELD(0, "pt", DataTypes.INT()),
                DataTypes.FIELD(1, "a", DataTypes.INT()),
                DataTypes.FIELD(2, "f0", DataTypes.INT()),
                DataTypes.FIELD(
                        3,
                        "f1",
                        DataTypes.ROW(
                                DataTypes.FIELD(4, "f0", DataTypes.INT()),
                                DataTypes.FIELD(5, "f1", DataTypes.INT()),
                                DataTypes.FIELD(6, "f2", DataTypes.INT()))));
// write
// GenericRow.of(0, 0, 0, GenericRow.of(10, 11, 12))


RowType readType =
        DataTypes.ROW(
                DataTypes.FIELD(
                        3,
                        "f1",
                        DataTypes.ROW(
                                DataTypes.FIELD(4, "f0", DataTypes.INT()),
                                DataTypes.FIELD(6, "f2", DataTypes.INT()))));

ReadBuilder readBuilder = table.newReadBuilder().withReadType(readType);

// read
// GenericRow.of(GenericRow.of(10, 12))

[JingsongLi]

We just need a pruneColumns(RowType requiredSchema).

[Zouxxyy]

RowType contains all the information (field name, field id, nested structure ... ), it can replace projection

The final API will be modified to like this

    @Deprecated
    default ReadBuilder withProjection(int[] projection) {
        // projection -> requiredSchema
        return pruneColumns(RowType requiredSchema);
    }

    ReadBuilder pruneColumns(RowType requiredSchema);

[Zouxxyy]

@JingsongLi Thanks for review, updated

[JingsongLi]

+1