| | |
| | | mayInvoke=true) |
| | | public final class PluginResult |
| | | { |
| | | /** Contract for operation results. */ |
| | | public static interface OperationResult |
| | | { |
| | | /** |
| | | * Indicates whether processing on the associated operation should continue. |
| | | * |
| | | * @return {@code true} if processing on the associated operation should continue, or |
| | | * {@code false} if it should stop. |
| | | */ |
| | | boolean continueProcessing(); |
| | | |
| | | /** |
| | | * Retrieves the error message if {@link #continueProcessing()} returned {@code false}. |
| | | * |
| | | * @return An error message explaining why processing should stop or {@code null} if none is |
| | | * provided. |
| | | */ |
| | | LocalizableMessage getErrorMessage(); |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation if {@link #continueProcessing()} returned |
| | | * {@code false}. |
| | | * |
| | | * @return the result code for the operation or {@code null} if none is provided. |
| | | */ |
| | | ResultCode getResultCode(); |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation if {@link #continueProcessing()} returned |
| | | * {@code false}. |
| | | * |
| | | * @return the matched DN for the operation or {@code null} if none is provided. |
| | | */ |
| | | DN getMatchedDN(); |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation if {@link #continueProcessing()} returned |
| | | * {@code false}. |
| | | * |
| | | * @return the referral URLs for the operation or {@code null} if none is provided. |
| | | */ |
| | | List<String> getReferralURLs(); |
| | | } |
| | | |
| | | /** |
| | | * Defines a startup plugin result consisting of either continue |
| | | * skip further plugins, or stop startup with an error message. |
| | |
| | | new Startup(true, true, null); |
| | | |
| | | /** |
| | | * Construct a new startup plugin result. |
| | | * Constructs a new startup plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why startup should |
| | | * stop. |
| | | * @param errorMessage An message explaining why startup should stop. |
| | | */ |
| | | private Startup(boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | /** |
| | | * Defines a skip further plugin processing startup plugin result. |
| | | * |
| | | * @return a skip further plugin processing startup plugin |
| | | * result. |
| | | * @return a skip further plugin processing startup plugin result. |
| | | */ |
| | | public static Startup skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | /** |
| | | * Whether to continue startup. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | * @return {@code true} if processing should continue |
| | | * or {@code false} otherwise. |
| | | */ |
| | | public boolean continueProcessing() |
| | | { |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * Retrieves the error message if {@link #continueProcessing()} |
| | | * returned {@code false}. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | * stop or {@code null} if none is provided. |
| | | */ |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | |
| | | * plugins, or stop operation processing with a result code, |
| | | * matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class PreParse |
| | | public static final class PreParse implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | new PreParse(true, true, null, null, null, null); |
| | | |
| | | /** |
| | | * Construct a new pre parse plugin result. |
| | | * Constructs a new pre parse plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * stop. |
| | | */ |
| | | private PreParse (boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a skip further plugin processing pre parse plugin |
| | | * result. |
| | | * Defines a skip further plugin processing pre parse plugin result. |
| | | * |
| | | * @return a skip further plugin processing pre parse plugin |
| | | * result. |
| | | * @return a skip further plugin processing pre parse plugin result. |
| | | */ |
| | | public static PreParse skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | * Defines a new stop processing pre parse plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing pre parse plugin result. |
| | | * Constructs a new stop processing pre parse plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * |
| | | * @return a new stop processing pre parse plugin result. |
| | | */ |
| | |
| | | null, null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | | return continuePluginProcessing; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | * plugins, or stop operation processing with a result code, |
| | | * matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class PreOperation |
| | | public static final class PreOperation implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | new PreOperation(true, true, null, null, null, null); |
| | | |
| | | /** |
| | | * Construct a new pre operation plugin result. |
| | | * Constructs a new pre operation plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * stop. |
| | | */ |
| | | private PreOperation (boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a skip further plugin processing pre operation plugin |
| | | * result. |
| | | * Defines a skip further plugin processing pre operation plugin result. |
| | | * |
| | | * @return a skip further plugin processing pre operation plugin |
| | | * result. |
| | | * @return a skip further plugin processing pre operation plugin result. |
| | | */ |
| | | public static PreOperation skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | * Defines a new stop processing pre operation plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing pre operation plugin result. |
| | | * Constructs a new stop processing pre operation plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * |
| | | * @return a new stop processing pre operation plugin result. |
| | | */ |
| | |
| | | null, null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | | return continuePluginProcessing; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | * plugins, or stop operation processing with a result code, |
| | | * matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class PostOperation |
| | | public static final class PostOperation implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | * Constructs a new post operation plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | |
| | | * Defines a new stop processing post operation plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing post operation plugin result. |
| | | * Constructs a new stop processing post operation plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * |
| | | * @return a new stop processing post operation plugin result. |
| | | */ |
| | |
| | | null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | |
| | | /** |
| | | * Defines a post response plugin result for core server operation |
| | | * processing consisting of either continue or skip further |
| | | * plugins. |
| | | * processing consisting of either continue or skip further plugins. |
| | | */ |
| | | public static final class PostResponse |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a skip further plugin processing post response plugin |
| | | * result. |
| | | * Defines a skip further plugin processing post response plugin result. |
| | | * |
| | | * @return a skip further plugin processing post response plugin |
| | | * result. |
| | | * @return a skip further plugin processing post response plugin result. |
| | | */ |
| | | public static PostResponse skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | |
| | | new ImportLDIF(true, true, null); |
| | | |
| | | /** |
| | | * Construct a new import LDIF plugin result. |
| | | * Constructs a new import LDIF plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why startup should |
| | | * stop. |
| | | * @param errorMessage An message explaining why startup should stop. |
| | | */ |
| | | private ImportLDIF(boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a skip further plugin processing LDIF import plugin |
| | | * result. |
| | | * Defines a skip further plugin processing LDIF import plugin result. |
| | | * |
| | | * @return a skip further plugin processing LDIF import plugin |
| | | * result. |
| | | * @return a skip further plugin processing LDIF import plugin result. |
| | | */ |
| | | public static ImportLDIF skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | * @return {@code true} if processing should continue |
| | | * or {@code false} otherwise. |
| | | */ |
| | | public boolean continueProcessing() |
| | | { |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * Retrieves the error message if {@link #continueProcessing()} |
| | | * returned {@code false}. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | * stop or {@code null} if none is provided. |
| | | */ |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | |
| | | * plugins, or stop operation processing with a result code, |
| | | * matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class SubordinateModifyDN |
| | | public static final class SubordinateModifyDN implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | new SubordinateModifyDN(true, true, null, null, null, null); |
| | | |
| | | /** |
| | | * Construct a new subordinate modify DN plugin result. |
| | | * Constructs a new subordinate modify DN plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * stop. |
| | | */ |
| | | private SubordinateModifyDN(boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a continue processing subordinate modify DN plugin |
| | | * result. |
| | | * Defines a continue processing subordinate modify DN plugin result. |
| | | * |
| | | * @return a continue processing subordinate modify DN plugin |
| | | * result. |
| | | * @return a continue processing subordinate modify DN plugin result. |
| | | */ |
| | | public static SubordinateModifyDN continueOperationProcessing() |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a new stop processing subordinate modify DN plugin |
| | | * result. |
| | | * Defines a new stop processing subordinate modify DN plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | | * @return a new stop processing subordinate modify DN plugin |
| | | * result. |
| | | * @return a new stop processing subordinate modify DN plugin result. |
| | | */ |
| | | public static SubordinateModifyDN stopProcessing( |
| | | ResultCode resultCode, LocalizableMessage errorMessage, DN matchedDN, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing subordinate modify DN plugin |
| | | * result. |
| | | * Constructs a new stop processing subordinate modify DN plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * |
| | | * @return a new stop processing subordinate modify DN plugin |
| | | * result. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @return a new stop processing subordinate modify DN plugin result. |
| | | */ |
| | | public static SubordinateModifyDN stopProcessing( |
| | | ResultCode resultCode, LocalizableMessage errorMessage) |
| | |
| | | resultCode, null, null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | | return continuePluginProcessing; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | * further plugins, or stop operation processing with a result |
| | | * code, matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class SubordinateDelete |
| | | public static final class SubordinateDelete implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | new SubordinateDelete(true, true, null, null, null, null); |
| | | |
| | | /** |
| | | * Construct a new subordinate delete plugin result. |
| | | * Constructs a new subordinate delete plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param continuePluginProcessing Whether to invoke the rest of the plugins. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * stop. |
| | | */ |
| | | private SubordinateDelete(boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a continue processing subordinate delete plugin |
| | | * result. |
| | | * Defines a continue processing subordinate delete plugin result. |
| | | * |
| | | * @return a continue processing subordinate delete plugin |
| | | * result. |
| | | * @return a continue processing subordinate delete plugin result. |
| | | */ |
| | | public static SubordinateDelete continueOperationProcessing() |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a new stop processing subordinate delete plugin |
| | | * result. |
| | | * Defines a new stop processing subordinate delete plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | | * @return a new stop processing subordinate delete plugin |
| | | * result. |
| | | * @return a new stop processing subordinate delete plugin result. |
| | | */ |
| | | public static SubordinateDelete stopProcessing( |
| | | ResultCode resultCode, LocalizableMessage errorMessage, DN matchedDN, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing subordinate delete plugin |
| | | * result. |
| | | * Constructs a new stop processing subordinate delete plugin result. |
| | | * |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * |
| | | * @return a new stop processing subordinate delete plugin |
| | | * result. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @return a new stop processing subordinate delete plugin result. |
| | | */ |
| | | public static SubordinateDelete stopProcessing( |
| | | ResultCode resultCode, LocalizableMessage errorMessage) |
| | |
| | | resultCode, null, null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | | return continuePluginProcessing; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | * plugins, or stop operation processing with a result code, |
| | | * matched DN, referral URLs, and error message. |
| | | */ |
| | | public static final class IntermediateResponse |
| | | public static final class IntermediateResponse implements OperationResult |
| | | { |
| | | /** Whether to continue operation processing. */ |
| | | private final boolean continueProcessing; |
| | |
| | | null); |
| | | |
| | | /** |
| | | * Construct a new intermediate response plugin result. |
| | | * Constructs a new intermediate response plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param sendResponse Whether to send the intermediate response |
| | | * to the client. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param resultCode The result code for this result. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * stop. |
| | | */ |
| | | private IntermediateResponse(boolean continueProcessing, |
| | | boolean continuePluginProcessing, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a continue processing intermediate response plugin |
| | | * result. |
| | | * Defines a continue processing intermediate response plugin result. |
| | | * |
| | | * @param sendResponse Whether to send the intermediate response |
| | | * to the client. |
| | | * @return a continue processing intermediate response plugin |
| | | * result. |
| | | * @return a continue processing intermediate response plugin result. |
| | | */ |
| | | public static IntermediateResponse |
| | | continueOperationProcessing(boolean sendResponse) |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a new stop processing intermediate response plugin |
| | | * result. |
| | | * Defines a new stop processing intermediate response plugin result. |
| | | * |
| | | * @param sendResponse Whether to send the intermediate response |
| | | * to the client. |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param matchedDN The matched DN for this result. |
| | | * @param referralURLs The set of referral URLs for this result. |
| | | * |
| | | * @return a new stop processing intermediate response plugin |
| | | * result. |
| | | * @return a new stop processing intermediate response plugin result. |
| | | */ |
| | | public static IntermediateResponse stopProcessing( |
| | | boolean sendResponse, ResultCode resultCode, |
| | |
| | | } |
| | | |
| | | /** |
| | | * Contrust a new stop processing intermediate response plugin |
| | | * result. |
| | | * Constructs a new stop processing intermediate response plugin result. |
| | | * |
| | | * @param sendResponse Whether to send the intermediate response |
| | | * to the client. |
| | | * @param resultCode The result code for this result. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * |
| | | * @return a new stop processing intermediate response plugin |
| | | * result. |
| | | * @return a new stop processing intermediate response plugin result. |
| | | */ |
| | | public static IntermediateResponse stopProcessing( |
| | | boolean sendResponse, ResultCode resultCode, |
| | |
| | | errorMessage, resultCode, null, null); |
| | | } |
| | | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | */ |
| | | @Override |
| | | public boolean continueProcessing() |
| | | { |
| | | return continueProcessing; |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | |
| | | /** |
| | | * Whether to send the intermediate response to the client. |
| | | * |
| | | * @return <code>true</code> if the intermediate response should |
| | | * be sent to the client or <code>false</code> otherwise. |
| | | * @return {@code true} if the intermediate response should |
| | | * be sent to the client or {@code false} otherwise. |
| | | */ |
| | | public boolean sendResponse() |
| | | { |
| | | return sendResponse; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | | return errorMessage; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the result code for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the result code for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public ResultCode getResultCode() |
| | | { |
| | | return resultCode; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the matched DN for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the matched DN for the operation or <code>null</code> |
| | | * if none is provided. |
| | | */ |
| | | @Override |
| | | public DN getMatchedDN() |
| | | { |
| | | return matchedDN; |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the referral URLs for the operation |
| | | * if <code>continueProcessing</code> returned <code>false</code>. |
| | | * |
| | | * @return the refferal URLs for the operation or |
| | | * <code>null</code> if none is provided. |
| | | */ |
| | | @Override |
| | | public List<String> getReferralURLs() |
| | | { |
| | | return referralURLs; |
| | |
| | | new PostConnect(true, true, null, null, false); |
| | | |
| | | /** |
| | | * Construct a new post connect plugin result. |
| | | * Constructs a new post connect plugin result. |
| | | * |
| | | * @param continueProcessing Whether to continue startup. |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | | * @param errorMessage An message explaining why processing |
| | | * should stop. |
| | | * @param errorMessage An message explaining why processing should stop. |
| | | * @param disconnectReason The generic cause for the disconnect. |
| | | * @param sendDisconnectNotification Whether to send a disconnect |
| | | * notification to the client. |
| | |
| | | } |
| | | |
| | | /** |
| | | * Defines a skip further plugin processing post connect plugin |
| | | * result. |
| | | * Defines a skip further plugin processing post connect plugin result. |
| | | * |
| | | * @return a skip further plugin processing post connect plugin |
| | | * result. |
| | | * @return a skip further plugin processing post connect plugin result. |
| | | */ |
| | | public static PostConnect skipFurtherPluginProcesssing() |
| | | { |
| | |
| | | /** |
| | | * Whether to continue operation processing. |
| | | * |
| | | * @return <code>true</code> if processing should continue |
| | | * or <code>false</code> otherwise. |
| | | * @return {@code true} if processing should continue |
| | | * or {@code false} otherwise. |
| | | */ |
| | | public boolean continueProcessing() |
| | | { |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |
| | |
| | | } |
| | | |
| | | /** |
| | | * Retrieves the error message if <code>continueProcessing</code> |
| | | * returned <code>false</code>. |
| | | * Retrieves the error message if {@link #continueProcessing()} |
| | | * returned {@code false}. |
| | | * |
| | | * @return An error message explaining why processing should |
| | | * stop or <code>null</code> if none is provided. |
| | | * stop or {@code null} if none is provided. |
| | | */ |
| | | public LocalizableMessage getErrorMessage() |
| | | { |
| | |
| | | * Indicates whether to try to provide notification to the client |
| | | * that the connection will be closed. |
| | | * |
| | | * @return <code>true</code> if notification should be provided or |
| | | * <code>false</code> otherwise. |
| | | * @return {@code true} if notification should be provided or |
| | | * {@code false} otherwise. |
| | | */ |
| | | public boolean sendDisconnectNotification() |
| | | { |
| | |
| | | |
| | | /** |
| | | * Defines a post disconnect plugin result for client connection |
| | | * processing consisting of either continue or skip further |
| | | * plugins. |
| | | * processing consisting of either continue or skip further plugins. |
| | | */ |
| | | public static final class PostDisconnect |
| | | { |
| | |
| | | new PostDisconnect(true); |
| | | |
| | | /** |
| | | * Construct a new post disconnect plugin result. |
| | | * Constructs a new post disconnect plugin result. |
| | | * |
| | | * @param continuePluginProcessing Whether to invoke the rest |
| | | * of the plugins. |
| | |
| | | /** |
| | | * Whether to invoke the rest of the plugins. |
| | | * |
| | | * @return <code>true</code> if the rest of the plugins should |
| | | * be invoked for <code>false</code> to skip the rest of the |
| | | * plugins. |
| | | * @return {@code true} if the rest of the plugins should |
| | | * be invoked for {@code false} to skip the rest of the plugins. |
| | | */ |
| | | public boolean continuePluginProcessing() |
| | | { |