33 lines
1.1 KiB
Java
33 lines
1.1 KiB
Java
package dev.relism.extension;
|
|
|
|
/**
|
|
* Semantic execution phases for {@link FlashExtension#priority()}.
|
|
*
|
|
* <p>Phase determines the order in which annotation-processor middlewares are injected into
|
|
* the chain. Lower value = runs earlier (outermost wrapper = first at request time).
|
|
*
|
|
* <pre>
|
|
* Request ──► EARLY middlewares ──► DEFAULT middlewares ──► LATE middlewares ──► handler
|
|
* </pre>
|
|
*
|
|
* <p>Within the same phase, extensions execute in install order (sort is stable).
|
|
* Raw integers are valid for fine-grained ordering within a phase
|
|
* (e.g. {@code ExtensionPhase.EARLY.value + 10}).
|
|
*/
|
|
public enum ExtensionPhase {
|
|
|
|
/** Security guards, rate limiting — must short-circuit before expensive processing. */
|
|
EARLY(100),
|
|
|
|
/** Normal application extensions. Default when {@link FlashExtension#priority()} is not overridden. */
|
|
DEFAULT(500),
|
|
|
|
/** Observability, logging, diagnostics — must observe after all business logic. */
|
|
LATE(900);
|
|
|
|
/** The integer priority value used for sorting. */
|
|
public final int value;
|
|
|
|
ExtensionPhase(int value) { this.value = value; }
|
|
}
|