Couchbase API数据访问Guide

jieforest · 发表于 2013-3-17 12:59

ExecuteStore Operations

object.ExecuteStore(storemode, key, value)
object.ExecuteStore(storemode, key, value, expiresat)
object.ExecuteStore(storemode, key, value, validfor)
object.ExecuteStore(storemode, key, value, ReplicateTo)
object.ExecuteStore(storemode, key, value, PersistTo)
object.ExecuteStore(storemode, key, value, PersistTo, ReplicateTo)

复制代码

Parameters:

String key Key used to reference the value.
Object value Value to be stored
StoreMode storemode Storage mode for a given key/value pair can be Add, Replace or Set.
Timespan validfor Expiry timespan (in seconds) for key
DateTime expiresat Explicit expiry time for key
Enum PersistsTo Persist to one or more replicas. Master plus one, two, three replicas
Enum ReplicateTo Replicate to zero or more replicas

复制代码

jieforest · 发表于 2013-3-17 13:01

READING DATA

Get Operations

object.Get(key, expiry)
object.ExecuteGet(key, expiry)
object.ExecuteGet(key)
object.ExecuteGet(keyarray)
object.Get(key)
object.Get(keyarray)
object.GetWithCas(key)

复制代码

Parameters:

String key Key used to reference the value. The key cannot contain control characters or whitespace
object expiry Expiry time for the key in seconds. Values larger than 30*24*60*60 seconds (30 days) are interpreted as absolute times (from the epoch)
List <string> keyarray Array of keys used to reference one or more values

复制代码

jieforest · 发表于 2013-3-18 10:48

UPDATING DATA

Update existing information on the server:

object.Append(key, value)
object.Append(key, casvalue, value)
object.ExecuteAppend(key, value)
object.ExecuteAppend(key, casvalue, value)
object.Cas(storemode, key, value)
object.Cas(storemode, key, value, casunique)
object.Cas(storemode, key, value, validfor, casunique)
object.ExecuteCas(storemode, key, value)
object.ExecuteCas(storemode, key, value, casunique)
object.ExecuteCas(storemode, key, value, expiresat, casunique)
object.ExecuteCas(storemode, key, value, validfor, casunique)
object.Decrement(key, defaultvalue, offset)
object.Decrement(key, defaultvalue, offset, casunique)
object.Decrement(key, defaultvalue, offset, expiresat, casunique)
object.Decrement(key, defaultvalue, offset, validfor, casunique)
object.Decrement(key, defaultvalue, offset, expiresat)
object.Decrement(key, defaultvalue, offset, validfor)
object.Decrement(key, defaultvalue, offset)
object.Decrement(key, defaultvalue, offset, casunique)
object.Decrement(key, defaultvalue, offset, validfor, casunique)
object.Decrement(key, defaultvalue, offset, expiresat)
object.Decrement(key, defaultvalue, offset, validfor)
object.ExecuteDecrement(key, defaultvalue, offset)
object.ExecuteDecrement(key, defaultvalue, offset, casunique)
object.ExecuteDecrement(key, defaultvalue, offset, expiresat,
casunique)
object.ExecuteDecrement(key, defaultvalue, offset, validfor,
casunique)
object.ExecuteDecrement(key, defaultvalue, offset, expiresat)
object.ExecuteDecrement(key, defaultvalue, offset, validfor)
object.ExecuteRemove(key)
object.Remove(key)
object.ExecuteIncrement(key, defaultvalue, offset)
object.ExecuteIncrement(key, defaultvalue, offset, casunique)
object.ExecuteIncrement(key, defaultvalue, offset, expiresat,
casunique)
object.ExecuteIncrement(key, defaultvalue, offset, validfor,
casunique)
object.ExecuteIncrement(key, defaultvalue, offset, expiresat)
object.ExecuteIncrement(key, defaultvalue, offset, validfor)
object.Increment(key, defaultvalue, offset)
object.Increment(key, defaultvalue, offset, casunique)
object.Increment(key, defaultvalue, offset, expiresat, casunique)
object.Increment(key, defaultvalue, offset, validfor, casunique)
object.Increment(key, defaultvalue, offset, expiresat)
object.Increment(key, defaultvalue, offset, validfor)
object.ExecutePrepend(key, value)
object.ExecutePrepend(key, casunique, value)
object.Prepend(key, value)
object.Prepend(key, casunique, value)
object.Touch(key, expiry)

复制代码

jieforest · 发表于 2013-3-18 10:48

UPDATING DATA

Update existing information on the server:

object.Append(key, value)
object.Append(key, casvalue, value)
object.ExecuteAppend(key, value)
object.ExecuteAppend(key, casvalue, value)
object.Cas(storemode, key, value)
object.Cas(storemode, key, value, casunique)
object.Cas(storemode, key, value, validfor, casunique)
object.ExecuteCas(storemode, key, value)
object.ExecuteCas(storemode, key, value, casunique)
object.ExecuteCas(storemode, key, value, expiresat, casunique)
object.ExecuteCas(storemode, key, value, validfor, casunique)
object.Decrement(key, defaultvalue, offset)
object.Decrement(key, defaultvalue, offset, casunique)
object.Decrement(key, defaultvalue, offset, expiresat, casunique)
object.Decrement(key, defaultvalue, offset, validfor, casunique)
object.Decrement(key, defaultvalue, offset, expiresat)
object.Decrement(key, defaultvalue, offset, validfor)
object.Decrement(key, defaultvalue, offset)
object.Decrement(key, defaultvalue, offset, casunique)
object.Decrement(key, defaultvalue, offset, validfor, casunique)
object.Decrement(key, defaultvalue, offset, expiresat)
object.Decrement(key, defaultvalue, offset, validfor)
object.ExecuteDecrement(key, defaultvalue, offset)
object.ExecuteDecrement(key, defaultvalue, offset, casunique)
object.ExecuteDecrement(key, defaultvalue, offset, expiresat,
casunique)
object.ExecuteDecrement(key, defaultvalue, offset, validfor,
casunique)
object.ExecuteDecrement(key, defaultvalue, offset, expiresat)
object.ExecuteDecrement(key, defaultvalue, offset, validfor)
object.ExecuteRemove(key)
object.Remove(key)
object.ExecuteIncrement(key, defaultvalue, offset)
object.ExecuteIncrement(key, defaultvalue, offset, casunique)
object.ExecuteIncrement(key, defaultvalue, offset, expiresat,
casunique)
object.ExecuteIncrement(key, defaultvalue, offset, validfor,
casunique)
object.ExecuteIncrement(key, defaultvalue, offset, expiresat)
object.ExecuteIncrement(key, defaultvalue, offset, validfor)
object.Increment(key, defaultvalue, offset)
object.Increment(key, defaultvalue, offset, casunique)
object.Increment(key, defaultvalue, offset, expiresat, casunique)
object.Increment(key, defaultvalue, offset, validfor, casunique)
object.Increment(key, defaultvalue, offset, expiresat)
object.Increment(key, defaultvalue, offset, validfor)
object.ExecutePrepend(key, value)
object.ExecutePrepend(key, casunique, value)
object.Prepend(key, value)
object.Prepend(key, casunique, value)
object.Touch(key, expiry)

复制代码

jieforest · 发表于 2013-3-18 10:50

Parameters:

String key Key used to reference the value.
Object value Value to be stored
StoreMode storemode Storage mode for a given key/value pair
Timespan validfor Expiry timespan (in seconds) for key
DateTime expiresat Explicit expiry time for key
Object defaultvalue Value to be stored if the key does not exists
offset Integer offset value to increment or decrement (default 1)
casunique Unique value used to verify a key/value combination

复制代码

jieforest · 发表于 2013-3-18 10:51

QUERYING DATA

With Couchbase Server 2.0, you can add views and query those views using your applications.
Create a view object to be used when querying a view :

GetView(designName, viewName)

复制代码

Parameters:

String designName Design document name
String viewName View name within a design document

复制代码

jieforest · 发表于 2013-3-18 10:52

There is also a generic version of GetView, which has a third boolean parameter that tells the client to lookup the original document by its ID.

GetView<T>(designName, viewName, bLookup)

复制代码

You can iterate over the returned collection as follows:

var beersByNameAndABV = client.GetView<Beer>(“beers”, “by_name_and_abv”);
foreach(var beer in beersByNameAndABV) { … }

复制代码

If you iterate over a strongly typed view, each item is of the type you specified. If you use the non-generic version, each item you enumerate over will be of type IViewRow. IViewRow provides methods for accessing details of the row that are not present when using strongly typed views.

jieforest · 发表于 2013-3-18 10:53

To get the original document from Couchbase:

row.GetItem()

复制代码

To get a Dictionary representation of the view:

row.Info

复制代码

To get the original document’s ID:

row.ItemId

复制代码

To get the key emitted by the map function:

row.ViewKey

复制代码

To limit the number of documents returned by the query to 10:

GetView(designName, viewName).Limit(10)

复制代码

jieforest · 发表于 2013-3-19 13:03

To group the results when using _count for example:

GetView(designName, viewName).Group(true)

复制代码

To disallow stale results in the view:

GetView(designName, viewName).Stale(StaleMode.False)

复制代码

To limit the number of results to and order the results in descending order:

GetView(designName, viewName).Limit(5).Descending(true)

复制代码

jieforest · 发表于 2013-3-19 13:06

GETTING STARTED WITH COUCHBASE C# LIBRARIES

Using the NuGet package manager you can get the Couchbase .Net client using ‘Install-Package CouchbaseNetClient’

To create a new MVC project using Couchbase Server, select File -> New Project and then select Web -> ASP.Net MVC4 application under the Visual C# project templates. Give your project a name and click “OK” to create the solution.

Couchbase API数据访问Guide

浏览过的版块