Examples of org.kiji.schema.KijiURI

org.kiji.schema.KijiURI
efault/mytable/col").build();
Alternatively, {@code KijiURI} objects can be constructed from components by using a builder:
```
 final KijiURI uri = KijiURI.newBuilder() .withInstanceName("default") .withTableName("mytable") .addColumnName(KijiColumnName.create(col)) .build(); 
```
Syntax
A KijiURI is composed of multiple components: a {@code scheme}, a {@code cluster-identifier}, and optionally, an {@code instance-name}, a {@code table-name}, and {@code column-names}. The text format of a {@code KijiURI} must be of the form:
```
 scheme://cluster-identifier[/instance-name[/table-name[/column-names]]] 
```
where square brackets indicate optional components.
Scheme
The scheme of all {@code KijiURI}s is a identifier prefixed with the string " {@code kiji}", and followed by any combination of letters, digits, plus ("+"), period ("."), or hyphen ("-").
The scheme is specific to the type of cluster identified, and determines how the remaining components will be parsed.
The default {@code KijiURI} scheme is "{@value #KIJI_SCHEME}". When this scheme is parsed an {@link org.kiji.schema.hbase.HBaseKijiURI} will be created.
Cluster Identifier
The cluster identifier contains the information necessary for Kiji to identify the host cluster. The exact form of the cluster identifier is specific to the cluster type (which is identified by the scheme). At a minimum, the cluster identifier includes ZooKeeper ensemble information for connecting to the ZooKeeper service hosting Kiji. The ZooKeeper Ensemble address is located in the 'authority' position as defined in RFC3986, and may take one of the following host/port forms, depending on whether one or more hosts is specified, and whether a port is specified:
{@code .env}
{@code host}
{@code host:port}
{@code host1,host2}
{@code (host1,host2):port}The {@value #ENV_URI_STRING} value will resolve at runtime to a ZooKeeper ensemble addresstaken from the environment. Specifics of how the address is resolved is scheme-specific.
Note that, depending on the scheme, the cluster identifier may contain path segments, and thus is potentially larger than just the URI authority.
Instance Name
The instance name component is optional. Identifies a Kiji instance hosted on the cluster. Only valid Kiji instance names may be used.
Table Name
The table name component is optional, and may only be used if the instance name is defined. The table name identifies a Kiji table in the identified instance. Only a valid Kiji table name may be used.
Column Names
The column names component is optional, and may only be used if the table name is defined. The column names identify a set of Kiji column names in the specified table. The column names are comma separated with no spaces, and may contain only valid Kiji column names.
Examples
The following are valid {@code KijiURI}s:
{@code kiji://zkHost}
{@code kiji://zkHost/instance}
{@code kiji://zkHost/instance/table}
{@code kiji://zkHost:zkPort/instance/table}
{@code kiji://zkHost1,zkHost2/instance/table}
{@code kiji://(zkHost1,zkHost2):zkPort/instance/table}
{@code kiji://zkHost/instance/table/col}
{@code kiji://zkHost/instance/table/col1,col2}
{@code kiji://.env/instance/table}
Usage
The {@link KijiURI} class is not directly instantiable (it is effectively {@code abstract}). The builder will instead return a concrete subclass based on the scheme of the provided URI or URI string. If no URI or URI string is provided to create the builder, then the default {@link org.kiji.schema.hbase.HBaseKijiURI} will be assumed.All {@link KijiURI} implementations are immutable and thread-safe.

  private static final Logger LOG = LoggerFactory.getLogger(TestGetTool.class);


  @Test
  public void testUnderspecified() throws Exception {
    final Kiji kiji = getKiji();
    final KijiURI hbaseURI = KijiURI.newBuilder(kiji.getURI()).withInstanceName(null).build();


    assertEquals(BaseTool.FAILURE, runTool(new GetTool(), hbaseURI.toString()));
    assertTrue(mToolOutputLines[0].startsWith("Specify a cluster"));
    assertEquals(BaseTool.FAILURE, runTool(new GetTool()));
    assertTrue(mToolOutputLines[0].startsWith("URI must be specified"));
    assertEquals(BaseTool.FAILURE, runTool(new GetTool(),
        hbaseURI.toString() + "instance/table",
        "--max-versions=0"));
    assertTrue(mToolOutputLines[0].startsWith("--max-versions must be positive"));
  }

    final KijiTableLayout layout =
            KijiTableLayouts.getTableLayout(KijiTableLayouts.FOO_TEST_LEGACY);
    getKiji().createTable(layout.getDesc());


    final File newLayoutFile = getTempLayoutFile(KijiTableLayouts.getFooChangeHashingTestLayout());
    final KijiURI tableURI =
        KijiURI.newBuilder(getKiji().getURI()).withTableName(layout.getName()).build();


    try {
      runTool(new LayoutTool(),
        "--table=" + tableURI,

  public final void setupTable() throws IOException {
    // This will install a new Kiji instance.
    final Kiji kiji = getKiji();


    // Get an admin and create a table for this instance.
    KijiURI kijiURI = kiji.getURI();
    //mAdmin = CassandraFactory
        //.Provider
        //.get()
        //.getCassandraAdminFactory(kijiURI)
        //.create(kijiURI);

  public void createTable(final TableLayoutDesc tableLayout) throws IOException {
    final State state = mState.get();
    Preconditions.checkState(state == State.OPEN,
        "Cannot create table in Kiji instance %s in state %s.", this, state);


    final KijiURI tableURI = KijiURI.newBuilder(mURI).withTableName(tableLayout.getName()).build();
    LOG.debug("Creating Kiji table '{}'.", tableURI);


    ensureValidationCompatibility(tableLayout);


    // If security is enabled, apply the permissions to the new table.


    final String tableName = update.getName();
    // Throws a KijiTableNotFoundException if there is no table.
    metaTable.getTableLayout(tableName);


    final KijiURI tableURI = KijiURI.newBuilder(mURI).withTableName(tableName).build();
    LOG.debug("Applying layout update {} on table {}", update, tableURI);


    KijiTableLayout newLayout = null;


    if (dryRun) {

  public void deleteTable(String tableName) throws IOException {
    final State state = mState.get();
    Preconditions.checkState(state == State.OPEN,
        "Cannot delete table in Kiji instance %s in state %s.", this, state);
    // Delete from Cassandra.
    final KijiURI tableURI = KijiURI.newBuilder(mURI).withTableName(tableName).build();


    final KijiTableLayout layout = mMetaTable.getTableLayout(tableName);
    final List<ResultSetFuture> futures =
        Lists.newArrayListWithCapacity(layout.getLocalityGroups().size());
    for (LocalityGroupLayout localityGroup : layout.getLocalityGroups()) {

   * @param tableLayout The initial layout of the table (with unassigned column ids).
   * @throws IOException on I/O error.
   * @throws KijiAlreadyExistsException if the table already exists.
   */
  private void createTableUnchecked(TableLayoutDesc tableLayout) throws IOException {
    final KijiURI tableURI = KijiURI.newBuilder(mURI).withTableName(tableLayout.getName()).build();
    CassandraTableLayoutUpdater.validateCassandraTableLayout(tableLayout);


    // This will validate the layout and may throw an InvalidLayoutException.
    final KijiTableLayout layout = KijiTableLayout.newLayout(tableLayout);

    } else if (nonFlagArgs.size() > 1) {
      getPrintStream().printf("Too many arguments: %s%n", nonFlagArgs);
      return FAILURE;
    }


    final KijiURI argURI = KijiURI.newBuilder(nonFlagArgs.get(0)).build();


    if ((null == argURI.getZookeeperQuorum())
        || (null == argURI.getInstance())
        || (null == argURI.getTable())) {
      // TODO: Send this error to a future getErrorStream()
      getPrintStream().printf("Specify a cluster, instance, and "
          + "table with argument kiji://zkhost/instance/table%n");
      return FAILURE;
    }


    if (mMaxVersions < 1) {
      // TODO: Send this error to a future getErrorStream()
      getPrintStream().printf("--max-versions must be positive, got %d%n", mMaxVersions);
      return FAILURE;
    }


    if (mEntityIdFlag == null) {
      // TODO: Send this error to a future getErrorStream()
      getPrintStream().printf("Specify entity with --entity-id=eid%n");
      return FAILURE;
    }


    final Pattern timestampPattern = Pattern.compile("([0-9]*)\\.\\.([0-9]*)");
    final Matcher timestampMatcher = timestampPattern.matcher(mTimestamp);
    if (timestampMatcher.matches()) {
      mMinTimestamp = ("".equals(timestampMatcher.group(1))) ? 0
          : Long.parseLong(timestampMatcher.group(1));
      final String rightEndpoint = timestampMatcher.group(2);
      mMaxTimestamp = ("".equals(rightEndpoint)) ? Long.MAX_VALUE : Long.parseLong(rightEndpoint);
    } else {
      // TODO: Send this error to a future getErrorStream()
      getPrintStream().printf("--timestamp must be like [0-9]*..[0-9]*, instead got %s%n",
          mTimestamp);
      return FAILURE;
    }


    final Kiji kiji = Kiji.Factory.open(argURI, getConf());
    try {
      final KijiTable table = kiji.openTable(argURI.getTable());
      try {
        final KijiTableLayout tableLayout = table.getLayout();


        final Map<FamilyLayout, List<String>> mapTypeFamilies =
            ToolUtils.getMapTypeFamilies(argURI.getColumns(), tableLayout);


        final Map<FamilyLayout, List<ColumnLayout>> groupTypeColumns =
            ToolUtils.getGroupTypeColumns(argURI.getColumns(), tableLayout);


        final KijiDataRequest request = ToolUtils.getDataRequest(
            mapTypeFamilies, groupTypeColumns, mMaxVersions, mMinTimestamp, mMaxTimestamp);


        final KijiTableReader reader = table.openTableReader();

      final long timestamp, T value
  ) throws IOException {
    synchronized (mMonitor) {
      Preconditions.checkState(mState == State.OPEN,
          "Cannot write to BufferedWriter instance in state %s.", mState);
      final KijiURI tableURI = mTable.getURI();


      final FamilyLayout familyLayout = mCapsule.getLayout().getFamilyMap().get(family);
      if (familyLayout == null) {
        throw new IllegalArgumentException(
            String.format("Unknown family '%s' in table %s.", family, tableURI));

  public void deleteColumn(
      final EntityId entityId,
      final String family,
      final String qualifier
  ) throws IOException {
    final KijiURI tableURI = mTable.getURI();
    synchronized (mMonitor) {
      final KijiTableLayout layout = mCapsule.getLayout();
      final FamilyLayout familyLayout = layout.getFamilyMap().get(family);
      if (familyLayout == null) {
        throw new IllegalArgumentException(

Examples of org.kiji.schema.KijiURI

Syntax

Scheme

Cluster Identifier

Instance Name

Table Name

Column Names

Examples

Usage

Related Classes of org.kiji.schema.KijiURI