← Back to branch summary

~ubuntu-branches/ubuntu/wily/aspectj/wily-proposed

« back to all changes in this revision

Viewing changes to org.aspectj/modules/bridge/src/org/aspectj/bridge/IMessageHolder.java

  • Committer: Bazaar Package Importer
  • Author(s): Damien Raude-Morvan
  • Date: 2011-03-15 23:54:31 UTC
  • mfrom: (1.2.5 upstream)
  • mto: This revision was merged to the branch mainline in revision 9.
  • Revision ID: james.westby@ubuntu.com-20110315235431-iq2gxbsx08kpwuiw
* New upstream release.
* Updated Standards-Version to 3.9.1 (no changes needed).
* Fix local Javadoc links:
  - d/patches/07_javadoc_links.diff: Use locally installed
   javadoc packages and hyperlink with them.
  - d/control: Add B-D on default-java-doc and libasm3-java-doc.
* d/control: Drop B-D on itself (our new bootstrap infrastructure doesn't need
  that anymore).
* Split packages into :
  - aspectj: only contains CLI tools.
  - libaspectj-java: JAR librairies for /usr/share/java.
  - libaspectj-java-doc: 4 API's Javadoc.
  - aspectj-doc: Programming Guides and SDK Documentation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
org.aspectj/modules/bridge/src/org/aspectj/bridge/IMessageHolder.java
18
18
/**
19
19
 * Hold and query a collection of messages.
20
20
 */
21
 
public interface IMessageHolder
22
 
        extends IMessageHandler { // XXX do not extend - mix instead
23
 
    // XXX go to LT EQ GT GE LE rather than simple orGreater
 
21
public interface IMessageHolder extends IMessageHandler { // XXX do not extend - mix instead
 
22
        // XXX go to LT EQ GT GE LE rather than simple orGreater
24
23
        /** value for orGreater parameter */
25
24
        public static final boolean ORGREATER = true;
26
25
 
27
26
        /** value for orGreater parameter */
28
27
        public static final boolean EQUAL = false;
29
28
 
30
 
        /** 
31
 
         * Tell whether this holder has any message of this kind 
32
 
         * (optionally or greater).
 
29
        /**
 
30
         * Tell whether this holder has any message of this kind (optionally or greater).
 
31
         * 
33
32
         * @param kind the IMessage.Kind to check for - accept any if null
34
 
         * @param orGreater if true, also any greater than the target kind
35
 
         *         as determined by IMessage.Kind.COMPARATOR 
36
 
         * @return true if this holder has any message of this kind,
37
 
         *           or if orGreater and any message has a greater kind,
38
 
         *           as determined by IMessage.Kind.COMPARATOR
 
33
         * @param orGreater if true, also any greater than the target kind as determined by IMessage.Kind.COMPARATOR
 
34
         * @return true if this holder has any message of this kind, or if orGreater and any message has a greater kind, as determined
 
35
         *         by IMessage.Kind.COMPARATOR
39
36
         */
40
37
        boolean hasAnyMessage(IMessage.Kind kind, boolean orGreater);
41
38
 
42
39
        /**
43
 
         * Count the messages currently held by this holder.
44
 
         * Pass null to get all kinds.
 
40
         * Count the messages currently held by this holder. Pass null to get all kinds.
 
41
         * 
45
42
         * @param kind the IMessage.Kind expected, or null for all messages
46
 
         * @param orGreater if true, also any greater than the target kind
47
 
         *         as determined by IMessage.Kind.COMPARATOR 
 
43
         * @param orGreater if true, also any greater than the target kind as determined by IMessage.Kind.COMPARATOR
48
44
         * @return number of IMessage held (now) by this holder
49
45
         */
50
46
        int numMessages(IMessage.Kind kind, boolean orGreater);
51
47
 
52
48
        /**
53
 
         * Get all messages or those of a specific kind.
54
 
         * Pass null to get all kinds.
 
49
         * Get all messages or those of a specific kind. Pass null to get all kinds.
 
50
         * 
55
51
         * @param kind the IMessage.Kind expected, or null for all messages
56
 
     * @param orGreater if true, also get any greater than the target kind
57
 
     *         as determined by IMessage.Kind.COMPARATOR 
 
52
         * @param orGreater if true, also get any greater than the target kind as determined by IMessage.Kind.COMPARATOR
58
53
         * @return IMessage[] of messages of the right kind, or IMessage.NONE
59
54
         */
60
55
        IMessage[] getMessages(IMessage.Kind kind, boolean orGreater);
61
 
    
62
 
    /** @return unmodifiable List view of underlying collection of IMessage  */
63
 
    List getUnmodifiableListView();
64
 
    
65
 
    /**
66
 
     * Clear any messages.
67
 
     * @throws UnsupportedOperationException if message list is read-only
68
 
     */
69
 
    void clearMessages() throws UnsupportedOperationException;
 
56
 
 
57
        /** @return unmodifiable List view of underlying collection of IMessage */
 
58
        List<IMessage> getUnmodifiableListView();
 
59
 
 
60
        /**
 
61
         * Clear any messages.
 
62
         * 
 
63
         * @throws UnsupportedOperationException if message list is read-only
 
64
         */
 
65
        void clearMessages() throws UnsupportedOperationException;
70
66
}