Examples of net.jini.space.JavaSpace05.contents()

net.jini.space.JavaSpace05.contents()
Creates a {@linkplain MatchSet match set} that can be used toexhaustively read through all of the matching entries in the space that are visible to the passed {@link Transaction} and remain visible for the lifetime of thematch set. May also yield additional entries that match but are only visible for part of the lifetime of the match set.
The tmpls parameter must be a {@link Collection} of {@link Entry} instances to be used astemplates. All of the entries placed in the match set will match one or more of these templates. tmpls may contain null values and may contain duplicates. An Entry is said to be visible to an invocation of this method if the Entry could have been returned by a singleton {@link JavaSpace#read JavaSpace.read} using the sametransaction.
The resulting match set must initially contain all of the visible matching entries in the space. During the lifetime of the match set an Entry may be, but is not required to be, added to the match set if it becomes visible. If the match set becomes empty, no more entries can be added and the match set enters the {@linkplain MatchSet exhausted} state.
Normally there are three conditions under which an Entry might be removed from the match set:
- Any Entry yielded by an invocation of the {@link MatchSet#next MatchSet.next} method on the matchset (either as the return value of a successful call or embedded in an {@link UnusableEntryException}) must be removed from the match set.
- Any Entry that remains in the match set after maxEntries entries are yielded by next invocations must be removed from the match set. In such a case, the criteria used to select which entries are yielded by next calls and which get removed from the set at the end is unspecified.
- Any Entry that during the lifetime of the match set becomes invisible may at the discretion of the implementation be removed from the match set.
An implementation may decide to remove an Entry from the set for other reasons. If it does so, however, it must {@linkplain MatchSet invalidate} the set.
If txn is non-null and still active, any Entry removed from the match set by a next call must be locked as if it had been returned by a read operation using txn. An implementation may establish the read lock on the Entry any time between when the Entry is added to the match set and when the Entry is removed from the match set by an invocation of next. These read locks are not released when the match set reaches either the exhausted state or the invalidated state. If from the space's perspective the txn leaves the active state, the space must remove from the match set any entries in the match set that have not yet been read locked. This may require the match set to be invalidated.
If the match set is leased and leaseDuration is positive, the initial duration of the lease must be less than or equal to leaseDuration. If leaseDuration is {@link Lease#ANY Lease.ANY}, the initial duration of the lease can be any positive value desired by the implementation.
If there are {@linkplain net.jini.core.constraint remotemethod constraints} associated with an invocation of thismethod, any remote communications performed by or on behalf of the match set's next method will be performed in compliance with these constraints, not with the constraints (if any) associated with next.
@param tmpls a {@link Collection} of {@link Entry}instances, each representing a template. All the entries added to the resulting match set will match one or more elements of tmpls @param txn the {@link Transaction} this operation should beperformed under, may be null @param leaseDuration the requested initial lease time onthe resulting match set @param maxEntries the maximum number of entries to removefrom the set via {@link MatchSet#next MatchSet.next} calls @return A proxy to the newly created {@linkplain MatchSet match set} @throws TransactionException if txn isnon-null and is not usable by the space @throws RemoteException if a communication error occurs @throws IllegalArgumentException if any non-nullelement of tmpls is not an instance of Entry, if tmpls is empty, if leaseDuration is neither positive nor {@link Lease#ANY Lease.ANY}, or if maxEntries is non-positive @throws NullPointerException if tmpls isnull

         * 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.");
        }

View Full Code Here

        /*
         * 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");

View Full Code Here

        /*
         * 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();

View Full Code Here

        reset();


        templates.add((SimpleEntry) sampleEntry1.clone());
        templates.add("not an Entry");
        try {
            space05.contents(templates, null, Lease.ANY, MAX_ENTRIES);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when a non-null element of tepmlates "
                                    + "is not an instance on Entry");
        } catch (IllegalArgumentException e) {}

View Full Code Here

                                    + "is not an instance on Entry");
        } catch (IllegalArgumentException e) {}


        templates.clear();
        try {
            space05.contents(templates, null, Lease.ANY, MAX_ENTRIES);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when templates is empty");
        } catch (IllegalArgumentException e) {}


        templates.add((SimpleEntry) sampleEntry1.clone());

View Full Code Here

                                    + "when templates is empty");
        } catch (IllegalArgumentException e) {}


        templates.add((SimpleEntry) sampleEntry1.clone());
        try {
            space05.contents(templates, null, 0, MAX_ENTRIES);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when leaseDuration is nither positive "
                                    + "nor Lease.ANY (0)");
        } catch (IllegalArgumentException e) {}

View Full Code Here

                                    + "when leaseDuration is nither positive "
                                    + "nor Lease.ANY (0)");
        } catch (IllegalArgumentException e) {}


        try {
            space05.contents(templates, null, Lease.ANY - 1, MAX_ENTRIES);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when leaseDuration is nither positive "
                                    + "nor Lease.ANY (Lease.ANY-1)");
        } catch (IllegalArgumentException e) {}

View Full Code Here

                                    + "when leaseDuration is nither positive "
                                    + "nor Lease.ANY (Lease.ANY-1)");
        } catch (IllegalArgumentException e) {}


        try {
            space05.contents(templates, null, Lease.ANY, 0);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when maxEntries is non-positive (0)");
        } catch (IllegalArgumentException e) {}


        try {

View Full Code Here

            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when maxEntries is non-positive (0)");
        } catch (IllegalArgumentException e) {}


        try {
            space05.contents(templates, null, Lease.ANY, -1);
            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when maxEntries is non-positive (-1)");
        } catch (IllegalArgumentException e) {}


        try {

View Full Code Here

            throw new TestException("IllegalArgumentException is not thrown "
                                    + "when maxEntries is non-positive (-1)");
        } catch (IllegalArgumentException e) {}


        try {
            space05.contents(null, null, Lease.ANY, MAX_ENTRIES);
            throw new TestException("NullPointerException is not thrown "
                                    + "when tmpls is null");
        } catch (NullPointerException e) {}


        cleanSpace(space);

View Full Code Here

0 1 2

TOP

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.