Examples of com.persistit.Exchange

com.persistit.Exchange
The main facade for fetching, storing and removing records from a Persistit™ database.

Applications interact with Persistit through instances of this class. A Exchange has two important associated member objects, a {@link com.persistit.Key} and a {@link com.persistit.Value}. A Key is a mutable representation of a key, and a Value is a mutable representation of a value. Applications manipulate these objects and interact with the database through one of the following four general patterns:
1. Modify the Key, perform a {@link com.persistit.Exchange#fetch fetch} operation, and query the Value.
2. Modify the Key, modify the Value, and then perform a {@link com.persistit.Exchange#store store} operation to insert or replacedata in the database.
3. Modify the Key, and then perform a {@link com.persistit.Exchange#remove remove} to remove one or more key/valuepairs.
4. Optionally modify the Key, perform a {@link com.persistit.Exchange#traverse traverse} operation, then query theresulting state of Key and/or Value to enumerate key/value pairs currently stored in the database.
Additional methods of Exchange include {@link #fetchAndStore fetchAndStore} and {@link #fetchAndRemove fetchAndRemove} which atomicallymodify the database and return the former value associated with the current Key.

Exchange is Not Threadsafe
Important: an Exchange and its associated Key and Value instances are not thread-safe. Generally each Thread should allocate and use its own Exchange instances. Were it to occur, modification of the Key or Value objects associated with an Exchange by another thread could cause severe and unpredictable errors, including possible corruption of the underlying data storage. While the methods of one Exchange instance are not threadsafe, Persistit is designed to allow multiple threads, using multiple Exchange instances, to access and update the underlying database in a highly concurrent fashion.

Exchange Pools
Normally each thread should allocate its own Exchange instances. However, depending on the garbage collection performance characteristics of a particular JVM it may be desirable to maintain a pool of Exchanges available for reuse, thereby reducing the frequency with which Exchanges need to be constructed and then garbage collected. An application may get an Exchange using {@link Persistit#getExchange(String,String,boolean)} or{@link Persistit#getExchange(Volume,String,boolean)}. These methods reuse a previously constructed Exchange if one is available in a pool; otherwise they construct methods construct a new one. Applications using the Exchange pool should call {@link Persistit#releaseExchange(Exchange,boolean)} to relinquish anExchange once it is no longer needed, thereby placing it in the pool for subsequent reuse.
@version 1.0

   */
  public Iterable<V> values(Object firstKey, Object secondKey) {
    try {
      exchange.clear();
      exchange.append(firstKey).append(secondKey).append(Key.BEFORE);
      Exchange iteratorExchange = new Exchange(exchange);
      KeyFilter filter = new KeyFilter().append(KeyFilter.simpleTerm(firstKey)).append(KeyFilter.simpleTerm(secondKey));
      return new ValueIterable<V>(iteratorExchange, filter);
    } catch (Exception e) {
      throw failToGetValues(e);
    }

View Full Code Here

   */
  public Iterable<V> values(Object firstKey) {
    try {
      exchange.clear();
      exchange.append(firstKey).append(Key.BEFORE);
      Exchange iteratorExchange = new Exchange(exchange);
      KeyFilter filter = new KeyFilter().append(KeyFilter.simpleTerm(firstKey));
      return new ValueIterable<V>(iteratorExchange, filter);
    } catch (Exception e) {
      throw failToGetValues(e);
    }

View Full Code Here

   * Lazy-loading values
   */
  public Iterable<V> values() {
    try {
      exchange.clear().append(Key.BEFORE);
      Exchange iteratorExchange = new Exchange(exchange);
      KeyFilter filter = new KeyFilter().append(KeyFilter.ALL);
      return new ValueIterable<V>(iteratorExchange, filter);
    } catch (Exception e) {
      throw failToGetValues(e);
    }

View Full Code Here

  }


  public Iterable<Entry<V>> entries() {
    exchange.clear().to(Key.BEFORE);
    KeyFilter filter = new KeyFilter().append(KeyFilter.ALL);
    return new EntryIterable<V>(new Exchange(exchange), filter);
  }

View Full Code Here

  }


  public Iterable<Entry<V>> entries(Object firstKey) {
    exchange.clear().append(firstKey).append(Key.BEFORE);
    KeyFilter filter = new KeyFilter().append(KeyFilter.simpleTerm(firstKey));
    return new EntryIterable<V>(new Exchange(exchange), filter);
  }

View Full Code Here


  public <V> Cache<V> createCache(String cacheName) {
    Preconditions.checkState(volume != null && volume.isOpened(), "Caches are not initialized");
    Preconditions.checkState(!cacheNames.contains(cacheName), "Cache is already created: " + cacheName);
    try {
      Exchange exchange = persistit.getExchange(volume, cacheName, true);
      exchange.setMaximumValueSize(Value.MAXIMUM_SIZE);
      Cache<V> cache = new Cache<V>(cacheName, exchange);
      cacheNames.add(cacheName);
      return cache;
    } catch (Exception e) {
      throw new IllegalStateException("Fail to create cache: " + cacheName, e);

View Full Code Here

        private boolean isExpanded() {
            return true;
        }


        private Row getNextRow(boolean forward) throws PersistitException {
            Exchange ex = setupExchange();
            boolean expanded = (isExpanded());
            if (!ex.traverse(forward ? Key.GT : Key.LT, expanded)) {
                return null;
            }
            Key key = ex.getKey();
            if (key.compareKeyFragment(_rootKey, 0, _rootKey.getEncodedSize()) != 0) {
                return null;
            }
            int keyBytesSize = key.getEncodedSize() - _rootKey.getEncodedSize();
            byte[] keyBytes = new byte[keyBytesSize];

View Full Code Here

            return new Row(keyBytes);
        }


        private String getValueTypeString() {
            try {
                Exchange ex = setupExchange();
                if (ex.getKey().getEncodedSize() == 0)
                    return "";
                ex.fetch();
                Value value = ex.getValue();
                if (!value.isDefined())
                    return "undefined";
                return value.getType().getName();
            } catch (PersistitException de) {
                return de.toString();

View Full Code Here

            }
        }


        private String getValueString() {
            try {
                Exchange ex = setupExchange();
                if (ex.getKey().getEncodedSize() == 0)
                    return "";
                ex.fetch();
                Value value = ex.getValue();
                if (value.getEncodedSize() > 50000) {
                    return "Too long to display: " + value.getEncodedSize();
                } else {
                    return value.toString();
                }

View Full Code Here

                return de.toString();
            }
        }


        private Key getKey() {
            Exchange ex = setupExchange();
            return ex.getKey();
        }

View Full Code Here

0 1 2 3 4 5

TOP

Related Classes of com.persistit.Exchange

com.foundationdb.qp.storeadapter.TempVolume

com.foundationdb.server.service.tree.TreeServiceExchangeCacheIT

com.foundationdb.server.service.tree.TreeServiceImpl

com.foundationdb.server.store.PersistitConstraintHandler$DeferredNotReferencedCheck

com.foundationdb.server.store.PersistitConstraintHandler$DeferredReferencingCheck

com.foundationdb.server.store.PersistitStoreSchemaManager

com.foundationdb.server.store.statistics.PersistitStoreIndexStatistics

com.persistit.Key.Direction

com.persistit.ui.PersistitTableModel$Row

com.thinkaurelius.titan.diskstorage.persistit.PersistitStoreManager

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of com.persistit.Exchange

Exchange is Not Threadsafe

Exchange Pools

Related Classes of com.persistit.Exchange