/*
* Copyright 2014-2014 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://aws.amazon.com/apache2.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 com.amazonaws.services.dynamodbv2.document.quickstart;
import org.junit.Test;
import com.amazonaws.services.dynamodbv2.document.Table;
import com.amazonaws.services.dynamodbv2.document.utils.AbstractQuickStart;
import com.amazonaws.services.dynamodbv2.model.AttributeDefinition;
import com.amazonaws.services.dynamodbv2.model.CreateTableRequest;
import com.amazonaws.services.dynamodbv2.model.GlobalSecondaryIndex;
import com.amazonaws.services.dynamodbv2.model.KeySchemaElement;
import com.amazonaws.services.dynamodbv2.model.KeyType;
import com.amazonaws.services.dynamodbv2.model.LocalSecondaryIndex;
import com.amazonaws.services.dynamodbv2.model.Projection;
import com.amazonaws.services.dynamodbv2.model.ProjectionType;
import com.amazonaws.services.dynamodbv2.model.ProvisionedThroughput;
import com.amazonaws.services.dynamodbv2.model.ScalarAttributeType;
import com.amazonaws.services.dynamodbv2.model.TableDescription;
/**
* Sample code to create a DynamoDB table.
*/
public class A_CreateTableTest extends AbstractQuickStart {
private final ProvisionedThroughput THRUPUT = new ProvisionedThroughput(1L, 2L);
private final Projection PROJECTION = new Projection().withProjectionType(ProjectionType.ALL);
/**
* Sample request to create a DynamoDB table with an LSI and GSI that
* can be accessed via a combination of hash keys and range keys.
*/
@Test
public void howToCreateTable() throws InterruptedException {
String TABLE_NAME = "myTableForMidLevelApi";
Table table = dynamo.getTable(TABLE_NAME);
// check if table already exists, and if so wait for it to become active
TableDescription desc = table.waitForActiveOrDelete();
if (desc != null) {
System.out.println("Skip creating table which already exists and ready for use: "
+ desc);
return;
}
// Table doesn't exist. Let's create it.
table = dynamo.createTable(newCreateTableRequest(TABLE_NAME));
// Wait for the table to become active
desc = table.waitForActive();
System.out.println("Table is ready for use! " + desc);
}
private CreateTableRequest newCreateTableRequest(String tableName) {
// primary keys
String HASH_KEY_NAME = "myHashKey";
String RANGE_KEY_NAME = "myRangeKey";
// local secondary index
String LSI_NAME = "myLSI";
String LSI_RANGE_KEY_NAME = "myLsiRangeKey";
// global secondary index
String RANGE_GSI_NAME = "myRangeGSI";
String GSI_HASH_KEY_NAME = "myGsiHashKey";
String GSI_RANGE_KEY_NAME = "myGsiRangeKey";
CreateTableRequest req = new CreateTableRequest()
.withTableName(tableName)
.withAttributeDefinitions(
new AttributeDefinition(HASH_KEY_NAME, ScalarAttributeType.S),
new AttributeDefinition(RANGE_KEY_NAME, ScalarAttributeType.N),
new AttributeDefinition(LSI_RANGE_KEY_NAME, ScalarAttributeType.N),
new AttributeDefinition(GSI_HASH_KEY_NAME, ScalarAttributeType.S),
new AttributeDefinition(GSI_RANGE_KEY_NAME, ScalarAttributeType.N))
.withKeySchema(
new KeySchemaElement(HASH_KEY_NAME, KeyType.HASH),
new KeySchemaElement(RANGE_KEY_NAME, KeyType.RANGE))
.withProvisionedThroughput(THRUPUT)
.withGlobalSecondaryIndexes(
new GlobalSecondaryIndex()
.withIndexName(RANGE_GSI_NAME)
.withKeySchema(
new KeySchemaElement(GSI_HASH_KEY_NAME, KeyType.HASH),
new KeySchemaElement(GSI_RANGE_KEY_NAME, KeyType.RANGE))
.withProjection(PROJECTION)
.withProvisionedThroughput(THRUPUT))
.withLocalSecondaryIndexes(
new LocalSecondaryIndex()
.withIndexName(LSI_NAME)
.withKeySchema(
new KeySchemaElement(HASH_KEY_NAME, KeyType.HASH),
new KeySchemaElement(LSI_RANGE_KEY_NAME, KeyType.RANGE))
.withProjection(PROJECTION))
;
return req;
}
}