Examples of org.kiji.schema.KijiDataRequestBuilder

org.kiji.schema.KijiDataRequestBuilder
Builds a request for columns of data to read from a Kiji table.

You can instantiate a KijiDataRequestBuilder using the {@link KijiDataRequest#builder()} method.
{@link KijiDataRequest} objects are immutable; this object helps you constructthem. With a KijiDataRequest builder, you can set various properties that affect the data request as a whole (for example, the timestamp interval to retrieve). You can also use the {@link #newColumnsDef()} method of this object to get instances of{@link KijiDataRequestBuilder.ColumnsDef}, which allow you to define a set of columns that are part of a data request, and their retrieval properties.

A KijiDataRequestBuilder.ColumnsDef object has two types of methods: methods starting with with... define properties associated with some columns. The add() methods then attach specific columns to the data request being built, using the properties previously specified. You may call add() or addFamily() multiple times. You may not overwrite the value of a property like maxVersions once it's already been set.

It is an error to change properties within a column request (e.g., call {@link KijiDataRequestBuilder.ColumnsDef#withMaxVersions(int)}) after using the add() or addFamily() methods to add columns to the request.

The following behaviors are errors and are not allowed:
- Adding the same column multiple times. This includes definitions like info:name that conflict with requests for the entire info:* family.
- Calling a property-setting method (withTimeRange(), withMaxVersions(), etc) more than once on a given KijiDataRequestBuilder or {@link KijiDataRequestBuilder.ColumnsDef}. These methods will throw IllegalStateException.
- Changing any properties after calling build() to construct the KijiDataRequest.
- Calling build() more than once.
Usage example

For the common case of reading info:foo, info:bar, info:baz, and products:*:
```
 KijiDataRequestBuilder builder = KijiDataRequest.builder().withTimeRange(t1, t2); builder.newColumnsDef().withMaxVersions(42) .add("info", "foo") .add("info", "bar") .add("info", "baz") .addFamily("products"); KijiDataRequest request = builder.build(); 
```
This can also be written as:
```
 final KijiDataRequest request = KijiDataRequest.build() .addColumns(ColumnsDef.create() .withMaxVerions(42) .add("info", "foo") .add("info", "bar") .add("info", "baz") .addFamily("products")) .build(); 
```
To add fam1:col1, fam1:col2, and fam2:*, each with different retrieval properties to the same request, do the following:
```
 KijiDataRequestBuilder builder = KijiDataRequest.builder().withTimeRange(t1, t2); builder.newColumnsDef().withMaxVersions(10).withPageSize(p).add("fam1", "col1"); builder.newColumnsDef().add("fam1", "col2"); builder.newColumnsDef().withMaxVersions(42).addFamily("fam2"); KijiDataRequest request = builder.build(); 
```

    testViewGet(request, column1Entries);
  }


  @Test
  public void testGetMatContents() throws Exception {
    KijiDataRequestBuilder builder = KijiDataRequest.builder().addColumns(ColumnsDef.create()
            .withMaxVersions(10)
            .add(PRIMITIVE_STRING, null)
            .add(STRING_MAP_1, null));
    KijiDataRequest request = builder.build();
    final EntityId eid = mTable.getEntityId(ROW);
    KijiResult<Object> view = mReader.getResult(eid, request);
    SortedMap<KijiColumnName, List<KijiCell<Object>>> map =
        KijiResult.Helpers.getMaterializedContents(view);
    for (KijiColumnName col: map.keySet()) {

View Full Code Here

        .create()
        .withFilter(mColumnRequest.getFilter())
        .withPageSize(KijiDataRequest.PAGING_DISABLED)
        .withMaxVersions(mColumnRequest.getMaxVersions())
        .add(column, mColumnRequest.getReaderSpec());
    final KijiDataRequestBuilder dataRequest = KijiDataRequest.builder();
    dataRequest.addColumns(columnDef);


    final List<KijiCell<Object>> cells =
        ImmutableList.copyOf(Iterators.limit(mCells, pageSize));
    final KijiResult<Object> result = MaterializedKijiResult.create(
        mResult.getEntityId(),
        dataRequest.build(),
        mLayout,
        ImmutableSortedMap.<KijiColumnName, List<KijiCell<Object>>>naturalOrder()
            .put(column, cells)
            .build());
    return new KijiResultRowData(mLayout, result);

View Full Code Here

  }


  @Test
  public void testDeleteMostRecentCellInColumnFromRow() throws Exception {
    setupTableAndReader();
    final KijiDataRequestBuilder kdrb = KijiDataRequest.builder();
    kdrb.newColumnsDef().withMaxVersions(HConstants.ALL_VERSIONS)
        .add("family", "column");
    final KijiDataRequest kdr = kdrb.build();
    final KijiRowData rowBefore =
        mReader.get(mTable.getEntityId("row-1"), kdr);
    assertEquals(3, rowBefore.getValues("family", "column").size());
    assertEquals(315L, (long) rowBefore.getValues("family", "column").firstKey());

View Full Code Here

  }


  @Test
  public void testDeleteExactTimestampCellInColumnFromRow() throws Exception {
    setupTableAndReader();
    final KijiDataRequestBuilder kdrb = KijiDataRequest.builder();
    kdrb.newColumnsDef().withMaxVersions(HConstants.ALL_VERSIONS)
        .add("family", "column");
    final KijiDataRequest kdr = kdrb.build();
    final KijiRowData rowBefore =
        mReader.get(mTable.getEntityId("row-1"), kdr);
    assertEquals(3, rowBefore.getValues("family", "column").size());
    assertEquals(315L, (long) rowBefore.getValues("family", "column").firstKey());

View Full Code Here

  }


  @Test
  public void testDeleteUpToTimestampCellInColumnFromRow() throws Exception {
    setupTableAndReader();
    final KijiDataRequestBuilder kdrb = KijiDataRequest.builder();
    kdrb.newColumnsDef().withMaxVersions(HConstants.ALL_VERSIONS)
        .add("family", "column");
    final KijiDataRequest kdr = kdrb.build();
    final KijiRowData rowBefore =
        mReader.get(mTable.getEntityId("row-1"), kdr);
    assertEquals(3, rowBefore.getValues("family", "column").size());
    assertEquals(315L, (long) rowBefore.getValues("family", "column").firstKey());

View Full Code Here

    writer.put(id, "info", "name", 3L, "me-three");
    writer.put(id, "info", "name", 4L, "me-four");
    writer.put(id, "info", "name", 5L, "me-five");
    ResourceUtils.closeOrLog(writer);
    final KijiColumnFilter columnFilter = new KijiPaginationFilter(1);
    final KijiDataRequestBuilder builder = KijiDataRequest.builder();
    builder.newColumnsDef().withMaxVersions(5).withFilter(columnFilter).add("info", "name");
    final KijiDataRequest dataRequest = builder.build();
    EntityId meId = mTable.getEntityId(Bytes.toBytes("me"));
    KijiRowData myRowData = mReader.get(meId, dataRequest);
    final NavigableMap<Long, CharSequence> resultMap = myRowData.getValues("info", "name");
    assertEquals("The number of returned values is incorrect:", 1, resultMap.size());
    assertTrue(null != resultMap.get(5L));

View Full Code Here

    writer.put(id, "info", "name", 3L, "me-three");
    writer.put(id, "info", "name", 4L, "me-four");
    writer.put(id, "info", "name", 5L, "me-five");
    ResourceUtils.closeOrLog(writer);
    final KijiColumnFilter columnFilter = new KijiPaginationFilter(1);
    final KijiDataRequestBuilder builder = KijiDataRequest.builder();
    builder.newColumnsDef().withMaxVersions(5).withFilter(columnFilter).add("info", "name");
    final KijiDataRequest dataRequest = builder.build();
    EntityId meId = mTable.getEntityId("me");
    KijiRowData myRowData = mReader.get(meId, dataRequest);
    final NavigableMap<Long, CharSequence> resultMap = myRowData.getValues("info", "name");
    assertEquals("The number of returned values is incorrect:", 1, resultMap.size());
    assertTrue(null != resultMap.get(5L));

View Full Code Here

    writer.put(id, "jobs", "c", 3L, "always coming in 3rd");
    writer.put(id, "jobs", "b", 4L, "always coming in 2nd");
    writer.put(id, "jobs", "a", 5L, "always coming in 1st");
    ResourceUtils.closeOrLog(writer);
    final KijiColumnFilter columnFilter = new KijiPaginationFilter(1);
    final KijiDataRequestBuilder builder = KijiDataRequest.builder();
    builder.newColumnsDef().withMaxVersions(5).withFilter(columnFilter).addFamily("jobs");
    final KijiDataRequest dataRequest = builder.build();
    EntityId meId = mTable.getEntityId(Bytes.toBytes("me"));
    KijiRowData myRowData = mReader.get(meId, dataRequest);
    final NavigableMap<String, NavigableMap<Long, CharSequence>> resultMap
        = myRowData.<CharSequence>getValues("jobs");
    assertEquals("The number of returned values is incorrect:", 1, resultMap.size());

View Full Code Here

    writer.put(id, "jobs", "a", 4L, "always coming in 2nd");
    writer.put(id, "jobs", "a", 5L, "always coming in 1st");
    ResourceUtils.closeOrLog(writer);
    final KijiColumnFilter columnFilter =
        new KijiPaginationFilter(new RegexQualifierColumnFilter("b"), 1);
    final KijiDataRequestBuilder builder = KijiDataRequest.builder();
    builder.newColumnsDef().withMaxVersions(5).withFilter(columnFilter).addFamily("jobs");
    final KijiDataRequest dataRequest = builder.build();
    EntityId meId = mTable.getEntityId(Bytes.toBytes("me"));
    KijiRowData myRowData = mReader.get(meId, dataRequest);
    final NavigableMap<String, NavigableMap<Long, CharSequence>> resultMap
        = myRowData.<CharSequence>getValues("jobs");
    assertEquals("The number of returned values is incorrect: ", 1, resultMap.get("b").size());

View Full Code Here

      final KijiTableLayout layout,
      final HBaseColumnNameTranslator columnTranslator,
      final CellDecoderProvider decoderProvider
  ) throws IOException {
    final Collection<Column> columnRequests = dataRequest.getColumns();
    final KijiDataRequestBuilder unpagedRequestBuilder = KijiDataRequest.builder();
    final KijiDataRequestBuilder pagedRequestBuilder = KijiDataRequest.builder();
    unpagedRequestBuilder.withTimeRange(
        dataRequest.getMinTimestamp(),
        dataRequest.getMaxTimestamp());
    pagedRequestBuilder.withTimeRange(dataRequest.getMinTimestamp(), dataRequest.getMaxTimestamp());


    for (Column columnRequest : columnRequests) {
      if (columnRequest.isPagingEnabled()) {
        pagedRequestBuilder.newColumnsDef(columnRequest);
      } else {
        unpagedRequestBuilder.newColumnsDef(columnRequest);
      }
    }


    final CellDecoderProvider requestDecoderProvider =
        decoderProvider.getDecoderProviderForRequest(dataRequest);


    final KijiDataRequest unpagedRequest = unpagedRequestBuilder.build();
    final KijiDataRequest pagedRequest = pagedRequestBuilder.build();


    if (unpagedRequest.isEmpty() && pagedRequest.isEmpty()) {
      return new EmptyKijiResult<T>(entityId, dataRequest);
    }

View Full Code Here

0 1

TOP

Related Classes of org.kiji.schema.KijiDataRequestBuilder

org.kiji.schema.cassandra.TestCassandraKijiRowData

org.kiji.schema.filter.HasColumnDataRowFilter

org.kiji.schema.impl.cassandra.CassandraKijiResult

org.kiji.schema.impl.cassandra.TestCassandraKijiResult

org.kiji.schema.impl.DefaultKijiResult

org.kiji.schema.impl.hbase.HBaseKijiResult

org.kiji.schema.impl.hbase.HBaseVersionPager

org.kiji.schema.impl.hbase.TestHBaseDataRequestAdapter

org.kiji.schema.impl.hbase.TestHBaseKijiResult

org.kiji.schema.impl.KijiResultPager

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of org.kiji.schema.KijiDataRequestBuilder

Usage example

Related Classes of org.kiji.schema.KijiDataRequestBuilder