1 /*
2 AtclauseOrder
3 violateExecutionOnNonTightHtml = (default)false
4 target = (default)CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, \
5 CTOR_DEF, VARIABLE_DEF, RECORD_DEF, COMPACT_CTOR_DEF
6 tagOrder = (default)@author, @deprecated, @exception, @param, @return, \
7 @see, @serial, @serialData, @serialField, @since, @throws, @version
8
9
10 */
11
12 package com.puppycrawl.tools.checkstyle.checks.javadoc.atclauseorder;
13
14 import java.awt.*;
15 import java.lang.reflect.AnnotatedElement;
16 import java.lang.reflect.GenericDeclaration;
17 import java.lang.reflect.Type;
18 import java.util.Set;
19
20 import javax.transaction.xa.XAException;
21 import javax.transaction.xa.Xid;
22
23 public interface InputAtclauseOrderNewArrayDeclaratorStructure
24 <D extends GenericDeclaration> extends Type, AnnotatedElement {
25 /**
26 * Returns an array of {@code Type} objects representing the
27 * upper bound(s) of this type variable. If no upper bound is
28 * explicitly declared, the upper bound is {@code Object}.
29 *
30 * <p>For each upper bound B: <ul> <li>if B is a parameterized
31 * type or a type variable, it is created, (see {@link
32 * java.lang.reflect.ParameterizedType ParameterizedType} for the
33 * details of the creation process for parameterized types).
34 * <li>Otherwise, B is resolved. </ul>
35 *
36 * @throws TypeNotPresentException if any of the
37 * bounds refers to a non-existent type declaration
38 * @throws MalformedParameterizedTypeException if any of the
39 * bounds refer to a parameterized type that cannot be instantiated
40 * for any reason
41 * @return an array of {@code Type}s representing the upper // violation
42 * bound(s) of this type variable
43 */
44 Type[] getBounds();
45
46 /**
47 * Obtains a list of prepared transaction branches from a resource
48 * manager. The transaction manager calls this method during recovery
49 * to obtain the list of transaction branches that are currently in
50 * prepared or heuristically completed states.
51 *
52 * @param flag One of TMSTARTRSCAN, TMENDRSCAN, TMNOFLAGS. TMNOFLAGS
53 * must be used when no other flags are set in the parameter.
54 *
55 * @exception XAException An error has occurred. Possible values are
56 * XAER_RMERR, XAER_RMFAIL, XAER_INVAL, and XAER_PROTO.
57 *
58 * @return The resource manager returns zero or more XIDs of the // violation
59 * transaction branches that are currently in a prepared or
60 * heuristically completed state. If an error occurs during the
61 * operation, the resource manager should throw the appropriate
62 * XAException.
63 */
64 Xid[] recover(int flag) throws XAException;
65
66 }
67
68 class Other {
69 /**
70 * The focus traversal keys. These keys will generate focus traversal
71 * behavior for Components for which focus traversal keys are enabled. If a
72 * value of null is specified for a traversal key, this Component inherits
73 * that traversal key from its parent. If all ancestors of this Component
74 * have null specified for that traversal key, then the current
75 * KeyboardFocusManager's default traversal key is used.
76 *
77 * @serial
78 * @see #setFocusTraversalKeys // violation
79 * @see #getFocusTraversalKeys // violation
80 * @since 1.4 // violation
81 */
82 Set<AWTKeyStroke>[] focusTraversalKeys;
83 }