#22 | Add getOrCreateIndex functionality (#45)

* Add getOrCreateIndex functionality

Author: arjunrc143

src/main/java/com/meilisearch/sdk/Client.java

@@ -106,4 +106,34 @@ public String updateIndex(String uid, String primaryKey) throws Exception {
 	public String deleteIndex(String uid) throws Exception {
 		return this.indexesHandler.delete(uid);
 	}
+
+	/**
+	 * Get single index by uid or if it does not exists, Create index
+	 *
+	 * @param uid        Unique identifier for the index to create
+	 * @param primaryKey The primary key of the documents in that index
+	 * @return Index instance
+	 * @throws Exception If an error occurss
+	 */
+	public Index getOrCreateIndex(String uid, String primaryKey) throws Exception {
+		try {
+			return this.createIndex(uid, primaryKey);
+		} catch (MeiliSearchApiException e) {
+			if(e.getErrorCode().equals("index_already_exists")) {
+				return this.getIndex(uid);
+			}
+			throw e;
+		}
+	}
+
+	/**
+	 * Get single index by uid or if it does not exists, Create index
+	 *
+	 * @param uid        Unique identifier for the index to create
+	 * @return Index instance
+	 * @throws Exception If an error occurss
+	 */
+	public Index getOrCreateIndex(String uid) throws Exception {
+		return getOrCreateIndex(uid, null);
+	}
 }

src/test/java/com/meilisearch/integration/ClientTest.java

@@ -57,6 +57,42 @@ public void testCreateIndexWithPrimaryKey() throws Exception {
 		client.deleteIndex(index.getUid());
 	}
 
+	@Test
+	public void testCreateIndexWithPrimaryKeyIfIndexDoesNotExists() throws Exception {
+		String indexUid = "dummyIndexUid";
+		Index index = client.getOrCreateIndex(indexUid, this.primaryKey);
+		assertEquals(index.getUid(), indexUid);
+		assertEquals(index.getPrimaryKey(), this.primaryKey);
+		client.deleteIndex(index.getUid());
+	}
+
+	@Test
+	public void testGetIndexWithPrimaryKeyIfIndexAlreadyExists() throws Exception {
+		String indexUid = "dummyIndexUid";
+		Index createdIndex = client.getOrCreateIndex(indexUid, this.primaryKey);
+		assertEquals(createdIndex.getUid(), indexUid);
+
+		Index retrievedIndex = client.getOrCreateIndex(indexUid, this.primaryKey);
+		assertEquals(retrievedIndex.getUid(), indexUid);
+		assertEquals(createdIndex.getUid(), retrievedIndex.getUid());
+
+		client.deleteIndex(createdIndex.getUid());
+	}
+
+	@Test
+	public void testGetOrCreateIndexShouldNotThrowAnyException() throws Exception {
+		String indexUid = "dummyIndexUid";
+		Index createdIndex = null;
+		try {
+			createdIndex = client.getOrCreateIndex(indexUid, this.primaryKey);
+			Index retrievedIndex = client.getOrCreateIndex(indexUid, this.primaryKey);
+		} catch (Exception e) {
+			client.deleteIndex(createdIndex.getUid());
+			fail("Should Not Throw Any Exception");
+		}
+		client.deleteIndex(createdIndex.getUid());
+	}
+
 	/**
 	 * Test Index creation error: already exists
 	 */