blob: 1abf7dff7a94d598903a4dde5f281c7f23aa8b7c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
/* -*- Mode: JDE; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*
* This file is part of the debugger and core tools for the AspectJ(tm)
* programming language; see http://aspectj.org
*
* The contents of this file are subject to the Mozilla Public License
* Version 1.1 (the "License"); you may not use this file except in
* compliance with the License. You may obtain a copy of the License at
* either http://www.mozilla.org/MPL/ or http://aspectj.org/MPL/.
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
* for the specific language governing rights and limitations under the
* License.
*
* The Original Code is AspectJ.
*
* The Initial Developer of the Original Code is Xerox Corporation. Portions
* created by Xerox Corporation are Copyright (C) 1999-2002 Xerox Corporation.
* All Rights Reserved.
*/
package org.aspectj.ajdoc;
import com.sun.javadoc.Type;
/**
* Documentation for a piece of advice.
*
* @author Jeff Palm
*/
public interface AdviceDoc extends ExecutableMemberDoc,
com.sun.javadoc.ExecutableMemberDoc {
/**
* Returns <code>true</code> if the advice is <code>abstract</code>.
*
* @return <code>true</code> if the advice is <code>abstract</code>.
*/
public boolean isAbstract();
/**
* Returns a {@link #AspectDoc} representing the aspect
* that is overriden by this advice.
*
* @return a AspectDoc representing the aspect
* that is overriden by this advice.
*/
public AspectDoc overriddenAspect();
/**
* Returns the return type of this advice -- it may be null.
*
* @return the return type of this advice -- it may be null.
*/
public Type returnType();
/**
* Returns the array of docs this advice crosscuts.
*
* @return an array of docs this advice crosscuts.
*/
public com.sun.javadoc.ExecutableMemberDoc[] crosscuts();
/**
* Returns <code>true</code> if this is <code>throwing</code> advice.
*
* @return <code>true</code> if this is <code>throwing</code> advice.
*/
public boolean isThrowing();
/**
* Returns <code>true</code> if this is <code>returning</code> advice.
*
* @return <code>true</code> if this is <code>returning</code> advice.
*/
public boolean isReturning();
/**
* Returns the extra formal type that's the optional type
* to <code>after returning</code> or <code>after throwing</code>
* advice.
*
* @return an instance of Type that represents the the extra formal type
* that's the optional type to <code>after returning</code> or
* <code>after throwing</code> advice.
*/
public Type extraType();
}
|