Class DocStoreConfig

java.lang.Object
io.ebean.config.DocStoreConfig

public class DocStoreConfig
extends Object
Configuration for the Document store integration (e.g. ElasticSearch).
  • Constructor Summary

    Constructors
    Constructor Description
    DocStoreConfig()  
  • Method Summary

    Modifier and Type Method Description
    int getBulkBatchSize()
    Return the default batch size to use for calls to the Bulk API.
    String getMappingPath()
    Return the mapping path.
    String getMappingSuffix()
    Return the mapping suffix.
    String getPassword()
    Return the password credential for connecting to the document store.
    String getPathToResources()
    Return the relative file system path to resources when generating mapping files.
    io.ebean.annotation.DocStoreMode getPersist()
    Return the default behavior for when Insert, Update and Delete events occur on beans that have an associated Document store.
    String getUrl()
    Return the URL to the Document store.
    String getUsername()
    Return the user credential for connecting to the document store.
    boolean isActive()
    Return true if the Document store (ElasticSearch) integration is active.
    boolean isAllowAllCertificates()
    Return true if the client allows connections to invalid/self signed SSL certificates.
    boolean isCreate()
    Create true if the document store should create mapped indexes that don't yet exist.
    boolean isDropCreate()
    Return true if the document store should recreate mapped indexes.
    boolean isGenerateMapping()
    Return true if Ebean should generate mapping files on server startup.
    void loadSettings​(PropertiesWrapper properties)
    Load settings specified in properties files.
    void setActive​(boolean active)
    Set to true to make the Document store (ElasticSearch) integration active.
    void setAllowAllCertificates​(boolean allowAllCertificates)
    Set to true such that the client allows connections to invalid/self signed SSL certificates.
    void setBulkBatchSize​(int bulkBatchSize)
    Set the default batch size to use for calls to the Bulk API.
    void setCreate​(boolean create)
    Set to true if the document store should create mapped indexes that don't yet exist.
    void setDropCreate​(boolean dropCreate)
    Set to true if the document store should recreate mapped indexes.
    void setGenerateMapping​(boolean generateMapping)
    Set to true if Ebean should generate mapping files on server startup.
    void setMappingPath​(String mappingPath)
    Set the mapping path.
    void setMappingSuffix​(String mappingSuffix)
    Set the mapping suffix.
    void setPassword​(String password)
    Set the password credential for connecting to the document store.
    void setPathToResources​(String pathToResources)
    Set the relative file system path to resources when generating mapping files.
    void setPersist​(io.ebean.annotation.DocStoreMode persist)
    Set the default behavior for when Insert, Update and Delete events occur on beans that have an associated Document store.
    void setUrl​(String url)
    Set the URL to the Document store.
    void setUsername​(String username)
    Set the user credential for connecting to the document store.

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

  • Method Details

    • isActive

      public boolean isActive()
      Return true if the Document store (ElasticSearch) integration is active.
    • setActive

      public void setActive​(boolean active)
      Set to true to make the Document store (ElasticSearch) integration active.
    • getUrl

      public String getUrl()
      Return the URL to the Document store.
    • getUsername

      public String getUsername()
      Return the user credential for connecting to the document store.
    • setUsername

      public void setUsername​(String username)
      Set the user credential for connecting to the document store.
    • getPassword

      public String getPassword()
      Return the password credential for connecting to the document store.
    • setPassword

      public void setPassword​(String password)
      Set the password credential for connecting to the document store.
    • setUrl

      public void setUrl​(String url)
      Set the URL to the Document store.

      For a local ElasticSearch server this would be: http://localhost:9200

    • isGenerateMapping

      public boolean isGenerateMapping()
      Return true if Ebean should generate mapping files on server startup.
    • setGenerateMapping

      public void setGenerateMapping​(boolean generateMapping)
      Set to true if Ebean should generate mapping files on server startup.
    • isDropCreate

      public boolean isDropCreate()
      Return true if the document store should recreate mapped indexes.
    • setDropCreate

      public void setDropCreate​(boolean dropCreate)
      Set to true if the document store should recreate mapped indexes.
    • isCreate

      public boolean isCreate()
      Create true if the document store should create mapped indexes that don't yet exist. This is only used if dropCreate is false.
    • setCreate

      public void setCreate​(boolean create)
      Set to true if the document store should create mapped indexes that don't yet exist. This is only used if dropCreate is false.
    • isAllowAllCertificates

      public boolean isAllowAllCertificates()
      Return true if the client allows connections to invalid/self signed SSL certificates.
    • setAllowAllCertificates

      public void setAllowAllCertificates​(boolean allowAllCertificates)
      Set to true such that the client allows connections to invalid/self signed SSL certificates.
    • getBulkBatchSize

      public int getBulkBatchSize()
      Return the default batch size to use for calls to the Bulk API.
    • setBulkBatchSize

      public void setBulkBatchSize​(int bulkBatchSize)
      Set the default batch size to use for calls to the Bulk API.

      The batch size can be set on a transaction via Transaction.setDocStoreBatchSize(int).

    • getMappingPath

      Return the mapping path.
    • setMappingPath

      public void setMappingPath​(String mappingPath)
      Set the mapping path.
    • getMappingSuffix

      Return the mapping suffix.
    • setMappingSuffix

      public void setMappingSuffix​(String mappingSuffix)
      Set the mapping suffix.
    • getPathToResources

      Return the relative file system path to resources when generating mapping files.
    • setPathToResources

      public void setPathToResources​(String pathToResources)
      Set the relative file system path to resources when generating mapping files.
    • getPersist

      public io.ebean.annotation.DocStoreMode getPersist()
      Return the default behavior for when Insert, Update and Delete events occur on beans that have an associated Document store.
    • setPersist

      public void setPersist​(io.ebean.annotation.DocStoreMode persist)
      Set the default behavior for when Insert, Update and Delete events occur on beans that have an associated Document store.
      • DocStoreEvent.UPDATE - build and send message to Bulk API
      • DocStoreEvent.QUEUE - add an entry with the index type and id only into a queue for later processing
      • DocStoreEvent.IGNORE - ignore. Most likely used when some scheduled batch job handles updating the index

      You might choose to use QUEUE if that particular index data is updating very frequently or the cost of indexing is expensive. Setting it to QUEUE can mean many changes can be batched together potentially coalescing multiple updates for an index entry into a single update.

      You might choose to use IGNORE when you have your own external process for updating the indexes. In this case you don't want Ebean to do anything when the data changes.

    • loadSettings

      public void loadSettings​(PropertiesWrapper properties)
      Load settings specified in properties files.