Support for writing multiple documents

[Hajime]

@darkfrog26 do you think this syntax will be possible for batch writing multiple documents ?

lucene.docs().fields(
    (id("id1"), email("[e-mail]")),
    (id("id2"), email("[e-mail]"))
  ).index()

From lucene documentation

public long addDocuments(Iterable<? extends Iterable<? extends IndexableField>> docs)
                  throws IOException

[Matt Hicks]

What is the reasoning behind this? From what I've seen, as long as you don't have autoCommit enabled, the performance is quite fast even if inserting millions of documents.

[Hajime]

The documentation says

Atomically adds a block of documents with sequentially assigned document IDs, such that an external reader will see all or none of the documents.

I'm assuming that it's similar to LevelDB's batch write operation where all succeed or none incase there is a bad shutdown.

[Matt Hicks]

Ah, okay. That's a reasonable request then. :)

[Matt Hicks]

What do you think about syntax like:

lucene.index(
  lucene.doc().fields(id("id1"), email("[e-mail]")),
  lucene.doc().fields(id("id2"), email("[e-mail]"))
)

This would allow you to create multiple documents and batch index them allowing for additional functionality like facet support per document.

[Hajime]

Yep. That's much better :)

[Matt Hicks]

Okay, any other suggestions before I push a release? :)

[Hajime]

That's it. Thank you very much :)