Package org.lightcouch

Class CouchDbDesign

java.lang.Object

org.lightcouch.CouchDbDesign

public class CouchDbDesign
extends Object

Provides API to work with design documents.

Usage Example:

 // read from system files
 DesignDocument design1 = dbClient.design().getFromDesk("example");
 
 // sync with the database
 dbClient.design().synchronizeWithDb(design1);
 
 // sync all with the database
 dbClient.syncDesignDocsWithDb();
 
 // read from the database
 DesignDocument design2 = dbClient.design().getFromDb("_design/example");
 

Since:

0.0.2

See Also:

• DesignDocument

Field Summary

Fields

Modifier and Type	Field	Description
private CouchDbClientBase	dbc
private static final String	DESIGN_DOCS_DIR
private static final String	DESIGN_PREFIX
private static final String	FILTERS
private static final String	FULLTEXT
private static final String	INDEXES
private static final String	JAVASCRIPT
private static final String	LISTS
private static final String	MAP_JS
private static final String	REDUCE_JS
private static final String	REWRITES
private static final String	SHOWS
private static final String	UPDATES
private static final String	VALIDATE_DOC
private static final String	VIEWS

Constructor Summary

Constructors

Constructor	Description
CouchDbDesign(CouchDbClientBase dbc)

Method Summary

Modifier and Type	Method	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.
private Map<String,String>	populateMap(String rootPath, List<String> elements, String element)
String	readContent(List<String> elements, String rootPath, String element)
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

Field Details

DESIGN_DOCS_DIR

private static final String DESIGN_DOCS_DIR

See Also:

• Constant Field Values

JAVASCRIPT

private static final String JAVASCRIPT

See Also:

• Constant Field Values

DESIGN_PREFIX

private static final String DESIGN_PREFIX

See Also:

• Constant Field Values

VALIDATE_DOC

private static final String VALIDATE_DOC

See Also:

• Constant Field Values

VIEWS

private static final String VIEWS

See Also:

• Constant Field Values

FILTERS

private static final String FILTERS

See Also:

• Constant Field Values

SHOWS

private static final String SHOWS

See Also:

• Constant Field Values

LISTS

private static final String LISTS

See Also:

• Constant Field Values

UPDATES

private static final String UPDATES

See Also:

• Constant Field Values

REWRITES

private static final String REWRITES

See Also:

• Constant Field Values

FULLTEXT

private static final String FULLTEXT

See Also:

• Constant Field Values

INDEXES

private static final String INDEXES

See Also:

• Constant Field Values

MAP_JS

private static final String MAP_JS

See Also:

• Constant Field Values

REDUCE_JS

private static final String REDUCE_JS

See Also:

• Constant Field Values

dbc

private CouchDbClientBase dbc

Constructor Details

CouchDbDesign

CouchDbDesign(CouchDbClientBase dbc)

Method Details

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)
• CouchDbClientBase.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.

Returns:

a list of all design documents

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

populateMap

private Map<String,String> populateMap(String rootPath,
 List<String> elements,
 String element)

readContent

public String readContent(List<String> elements,
 String rootPath,
 String element)