Examples of net.jini.space.MatchSet

net.jini.space.MatchSet
A collection of {@link Entry} instances to be incrementallyreturned from a JavaSpaces service. Some operations on a space must return more entries than can be conveniently returned by a single call, generally because returning all the entries in one result would consume too many resources in the client or introduce too much latency before the first entry could be processed. In these cases, match sets are returned to incrementally return the necessary entries. A MatchSet instance is a proxy object that can be used to access a match set created by a space.
Typically match sets are created by some factory method on the space (for example, {@link JavaSpace05#contents JavaSpace05.contents}) which returns a MatchSet instance that will serve as a proxy to the match set. The match set will initially contain some population of entries specified by the operation that created it. These entries can be retrieved by calling {@link #next next}. A successful call to next will remove the returned Entry from the match set. Match sets can end up in one of two terminal states, exhausted or invalidated. Under what conditions a match set enters one of these states is specified by the operation that created it. An exhausted match set is empty and will have no more entries added. Calling next on an exhausted match set must always return null. Calling next on an invalidated match set may return a non-null value, or it may throw one of the allowed exceptions. In particular it may throw {@link NoSuchObjectException} to indicate that the matchset has been invalidated. Once next throws a NoSuchObjectException, all future next calls on that instance must also throw NoSuchObjectException. Calling next on an invalidated match set must never return null. Implementations must not add entries to an invalidated match set.
Between the time a match set is created and the time it reaches a terminal state, entries may be added by the space. However, an Entry that is removed by a next call must not be added back to a match set (though if there is a distinct but equivalent entry in the space it may be added). The space may also remove entries independent of next calls. The conditions under which entries will be removed independent of next calls or added after the initial creation of the match set are specified by the operation that created the match set.
If there is a possibility that a match set may become invalidated, it must be leased and an appropriate proxy must be returned by the {@link #getLease getLease} method. If there isno possibility that the match set will become invalidated, implementations should not lease the match set. If a match set is not leased, then getLease must return null.
An active lease on a match set serves as a hint to the space that the client is still interested in the match set, and as a hint to the client that the match set is still functioning. However, implementations are allowed to invalidate match sets associated with active leases and to unilaterally cancel leases associated with functioning match sets. If a match set is leased and the lease is active, implementations should, to the best of their ability, maintain the match set and not invalidate it. There are cases, however, where this may not be possible in particular, it is not expected that implementations will maintain match sets across crashes. If the lease expires or is canceled, an implementation should invalidate the match set. An implementation must unilaterally cancel a match set's lease if the match set is invalidated. An implementation may unilaterally cancel the lease at other times without necessarily invalidating the match set. Clients should not assume that the resources associated with a leased match set will be freed if the match set reaches the exhausted state, and should instead cancel the lease. This interface is not a remote interface; though in general a MatchSet is a proxy for some remote match set, only the next method is considered to be a remote method, and as outlined in its {@linkplain #next description}it deviates in a number of ways from normal Java(TM) Remote Method Invocation remote method semantics. @since 2.1


    protected Entry[] getEntryArray() {
      try {
  List acc = new java.util.LinkedList();
  if (proxy instanceof JavaSpace05) {
    MatchSet set =
      ((JavaSpace05) proxy).contents(Collections.singleton(null),
             null, Lease.ANY, Integer.MAX_VALUE);
    Lease lease = set.getLease();
    if (lease != null) {
      lease = (Lease) browser.leasePreparer.prepareProxy(lease);
      browser.leaseMgr.renewUntil(lease, Lease.ANY, null);
    }
    try {
      while (true) {
        try {
    Entry e = set.next();
    if (e == null)
      break;
    acc.add(e);
        } catch (UnusableEntryException e) {
    Browser.logger.log(Level.INFO, "unusable entry", e);

View Full Code Here

      logger.log(Level.INFO, 
           nameAndTrail() + "looking for " + tbf.size() + " entries");
      logger.log(Level.INFO, 
           nameAndTrail() + "using:" + TestEntries.toString(tmpls));


      final MatchSet cr;
      final Lease l;
      TestEntry e;
      try {
    cr = space.contents(tmpls, null, 60000, Long.MAX_VALUE);
    
    l = cr.getLease();
    if (tbf.size() < batchSize && l != null) {
        throw failure(
      "failed! got lease, but should not have. tbf.size:" + 
      tbf.size());
    } else if (tbf.size() >= batchSize && l == null) {
        throw failure(
       "failed! did not get lease, but should have. tbf.size:" +
       tbf.size());
    }
        
    if (l != null) {
        lrm.renewFor(l, Long.MAX_VALUE, 60000, null);
    }


    e = (TestEntry)cr.next();
      } catch (Throwable t) {
    throw failure("failed with " + t + " during contents call phase",
            t);
      }


      while (e != null) {
    if (!tbf.remove(e)) {
        throw failure("failed, " + TestEntries.toString(e) +
          " not in tbf");
    }
    
    try {
        e = (TestEntry)cr.next();
    } catch (Throwable t) {      
        throw failure("failed with " + t + " during next call", t);
    }
      }

View Full Code Here

      logger.log(Level.INFO, 
           nameAndTrail() + "looking for " + tbf.size() + " entries");
      logger.log(Level.INFO, 
           nameAndTrail() + "using:" + TestEntries.toString(tmpls));


      final MatchSet cr;
      final Lease l;
      TestEntry e;
      try {
    cr = space.contents(tmpls, null, 60000, Long.MAX_VALUE);


    l = cr.getLease();
    if (tbf.size() < batchSize && l != null) {
        throw failure(
            "failed! got lease, but should not have. tbf.size:" + 
      tbf.size());
    } else if (tbf.size() >= batchSize && l == null) {
        throw failure(
                        "failed! did not get lease, but should have. tbf.size:"
      + tbf.size());
    }
        
    if (l != null) {
        lrm.renewFor(l, Long.MAX_VALUE, 60000, null);
    }


    e = (TestEntry)cr.next();
      } catch (Throwable t) {
    throw failure("failed with " + t + " during contents call phase",
            t);
      }


      final LinkedList notInTBF = new LinkedList();
      
      while (e != null) {
    if (!tbf.remove(e)) {
        notInTBF.add(e);
        
        // Make sure all the extras match
        boolean found = TestEntries.isMatch(tmpls, e);
        if (!found) {
      throw failure("failed. " + TestEntries.toString(e) +
              " did not match any templates");
        }           
    }


    try {
        e = (TestEntry)cr.next();
    } catch (Throwable t) {      
        throw failure("failed with " + t + " during next call", t);
    }
      }

View Full Code Here

         * that an entry is removed from match set after performing
         * MatchSet.next() method
         */
        JavaSpace05 space05 = (JavaSpace05) space;
        templates.add(sampleEntry1);
        MatchSet matchSet = space05.contents(templates, null, Lease.ANY,
                                             MAX_ENTRIES);
        if (matchSet.next() == null) {
            throw new TestException("Match set is exhausted. "
                                    + "But it shouldn't be.");
        }


        // now it is supposed to be exhausted
        if (matchSet.next() != null) {
            throw new TestException("Match set was not exhausted. "
                                    + "But should have been.");
        }
        space.write(sampleEntry1, null, leaseForeverTime);
        Thread.sleep(1000);
        if (matchSet.next() != null) {
            throw new TestException("An entry added to exhausted match set. "
                                    + "But must not have been.");
        }
        reset();


        /*
         * After maxEntries entries are yielded by next invocations the match
         * set becomes empty. For this test case let maxEntries = 2
         */
        templates.add(null);    // for 3 existing entries
        matchSet = space05.contents(templates, null, Lease.ANY, 2);
        matchSet.next();
        matchSet.next();
        if (matchSet.next() != null) {
            throw new TestException("Match set is not empty after maxEntries "
                                    + "are yielded by next invocations");
        }
        reset();


        /*
         * The initial duration of the lease must be less than or equal to
         * leaseDuration. Let leaseDuration = instantTime.
         */
        templates.add(null);    // for 3 existing entries
        matchSet = space05.contents(templates, null, leaseForeverTime,
                                    MAX_ENTRIES);
        Lease lease = matchSet.getLease();
        if (lease != null) {
            long initialDuration = lease.getExpiration()
                    - System.currentTimeMillis();
            if (initialDuration > leaseForeverTime) {
                throw new TestException("Initial duration of the lease "

View Full Code Here

                               List expectedResult,
                               String testName) throws Exception
    {


        JavaSpace05 space05 = (JavaSpace05) space;
        MatchSet matchSet = space05.contents(templates, txn, leaseDuration,
                                             maxEntries);
        ArrayList result = new ArrayList();
        SimpleEntry entry = (SimpleEntry) matchSet.next();
        while (entry != null) {
            result.add(entry);
            entry = (SimpleEntry) matchSet.next();
        }
        if (result.size() != expectedResult.size()) {
            throw new TestException(testName + " failed. "
                                    + "Taken result is not as expected.");
        }

View Full Code Here


    protected Entry[] getEntryArray() {
      try {
  List acc = new java.util.LinkedList();
  if (proxy instanceof JavaSpace05) {
    MatchSet set =
      ((JavaSpace05) proxy).contents(Collections.singleton(null),
             null, Lease.ANY, Integer.MAX_VALUE);
    Lease lease = set.getLease();
    if (lease != null) {
      lease = (Lease) browser.leasePreparer.prepareProxy(lease);
      browser.leaseMgr.renewUntil(lease, Lease.ANY, null);
    }
    try {
      while (true) {
        try {
    Entry e = set.next();
    if (e == null)
      break;
    acc.add(e);
        } catch (UnusableEntryException e) {
    Browser.logger.log(Level.INFO, "unusable entry", e);

View Full Code Here

         * MatchSet.next() method
         */
        JavaSpace05 space05 = (JavaSpace05) space;
        templates.add(sampleEntry1);
        txn = getTransaction();
        MatchSet matchSet = space05.contents(templates, txn, Lease.ANY,
                                             MAX_ENTRIES);
        if (matchSet.next() == null) {
            throw new TestException(
                    "Match set is exhausted. But it shouldn't be.");
        }


        // -- now it is supposed to be exhausted
        if (matchSet.next() != null) {
            throw new TestException(
                    "Match set was not exhausted. But should have been.");
        }
        space.write(sampleEntry1, txn, leaseForeverTime);
        Thread.sleep(1000);
        if (matchSet.next() != null) {
            throw new TestException("An entry added to exhausted match set. "
                                    + "But must not have been.");
        }
        txn.commit();
        reset();


        /*
         * After maxEntries entries are yielded by next invocations the match
         * set becomes empty. For this test case let maxEntries = 2
         */
        templates.add(null);    // for 3 existing entries
        txn = getTransaction();
        matchSet = space05.contents(templates, txn, Lease.ANY, 2);
        matchSet.next();
        matchSet.next();
        if (matchSet.next() != null) {
            throw new TestException("Match set is not empty after maxEntries "
                                    + "are yielded by next invocations");
        }
        txn.commit();
        reset();


        /*
         * The initial duration of the lease must be less than or equal to
         * leaseDuration. Let leaseDuration = instantTime.
         */
        templates.add(null);    // for 3 existing entries
        txn = getTransaction();
        matchSet = space05.contents(templates, txn, leaseForeverTime,
                                    MAX_ENTRIES);
        Lease lease = matchSet.getLease();
        if (lease != null) {
            long initialDuration = lease.getExpiration()
                    - System.currentTimeMillis();
            if (initialDuration > leaseForeverTime) {
                throw new TestException("Initial duration of the lease "
                                        + "is more than leaseDuration");
            }
        } // else Lease is not tested as the matchset is not leased
        txn.commit();
        reset();


        //corresponds to item #6 in this method's comments
        txn = getTransaction();
        templates.add((SimpleEntry) sampleEntry1.clone());
        matchSet = space05.contents(templates, txn, leaseForeverTime,
                                    MAX_ENTRIES);
        matchSet.next();
        SimpleEntry entry = (SimpleEntry) space.take(
                (SimpleEntry) sampleEntry1.clone(), null, instantTime);
        if (entry != null) {
            throw new TestException("Locked entry can be taken "
                                    + "from the space.");

View Full Code Here

    {
        if (txn == null) {
            throw new TestException("Transaction is null for test " + testName);
        }
        JavaSpace05 space05 = (JavaSpace05) space;
        MatchSet matchSet = space05.contents(templates, txn, leaseDuration,
                                             maxEntries);
        ArrayList result = new ArrayList();
        SimpleEntry entry = (SimpleEntry) matchSet.next();
        while (entry != null) {
            result.add(entry);
            entry = (SimpleEntry) matchSet.next();
        }


        if (result.size() != expectedResult.size()) {
            throw new TestException(testName + " failed. "
                                    + "Taken result is not as expected.");

View Full Code Here

TOP

Related Classes of net.jini.space.MatchSet

com.sun.jini.example.browser.SpaceBrowser$SpaceEntryPanel

com.sun.jini.test.impl.outrigger.javaspace05.MutatingContentsTest$ReaderThread

com.sun.jini.test.impl.outrigger.javaspace05.StableContentsTest$ReaderThread

com.sun.jini.test.spec.javaspace.conformance.ContentsTest05

com.sun.jini.test.spec.javaspace.conformance.TransactionContentsTest05

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.