org.lightcouch

Class CouchDbDesign

java.lang.Object

org.lightcouch.CouchDbDesign

public class CouchDbDesign
extends Object

Provides methods to create and save CouchDB design documents.

Usage Example:

 DesignDocument exampleDoc = dbClient.design().getFromDesk("example");
 Response response = dbClient.design().synchronizeWithDb(exampleDoc);
 DesignDocument documentFromDb = dbClient.design().getFromDb("_design/example");
 

Author:

Ahmed Yehia

See Also:

DesignDocument

Method Summary

Methods

Modifier and Type	Method and Description
List<DesignDocument>	getAllFromDesk() Gets all design documents from desk.
DesignDocument	getFromDb(String id) Gets a design document from the database.
DesignDocument	getFromDb(String id, String rev) Gets a design document from the database.
DesignDocument	getFromDesk(String id) Gets a design document from desk.
void	synchronizeAllWithDb() Synchronize all design documents on desk to the database.
Response	synchronizeWithDb(DesignDocument document) Synchronizes a design document to the Database.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

synchronizeWithDb

public Response synchronizeWithDb(DesignDocument document)

Synchronizes a design document to the Database.

This method will first try to find a document in the database with the same id as the given document, if it is not found then the given document will be saved to the database.

If the document was found in the database, it will be compared with the given document using equals(). If both documents are not equal, then the given document will be saved to the database and updates the existing document.

Parameters:

document - The design document to synchronize

Returns:

Response as a result of a document save or update, or returns null if no action was taken and the document in the database is up-to-date with the given document.

synchronizeAllWithDb

public void synchronizeAllWithDb()

Synchronize all design documents on desk to the database.

See Also:

synchronizeWithDb(DesignDocument), CouchDbClient.syncDesignDocsWithDb()

getFromDb

public DesignDocument getFromDb(String id)

Gets a design document from the database.

Parameters:

id - The document id

Returns:

DesignDocument

getFromDb

public DesignDocument getFromDb(String id,
                       String rev)

Gets a design document from the database.

Parameters:

id - The document id

rev - The document revision

Returns:

DesignDocument

getAllFromDesk

public List<DesignDocument> getAllFromDesk()

Gets all design documents from desk.

See Also:

getFromDesk(String)

getFromDesk

public DesignDocument getFromDesk(String id)

Gets a design document from desk.

Parameters:

id - The document id to get.

Returns:

DesignDocument