| /* |
| * Copyright 2002-2007,2009 The Apache Software Foundation. |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package com.opensymphony.xwork2; |
| |
| import com.opensymphony.xwork2.config.entities.ActionConfig; |
| |
| /** |
| * Handles cases when the result or action is unknown. |
| * <p/> |
| * This allows other classes like Struts plugins to provide intelligent defaults easier. |
| */ |
| public interface UnknownHandler { |
| |
| /** |
| * Handles the case when an action configuration is unknown. Implementations can return a new ActionConfig |
| * to be used to process the request. |
| * |
| * @param namespace The namespace |
| * @param actionName The action name |
| * @return An generated ActionConfig, can return <tt>null</tt> |
| * @throws XWorkException |
| */ |
| public ActionConfig handleUnknownAction(String namespace, String actionName) throws XWorkException; |
| |
| /** |
| * Handles the case when a result cannot be found for an action and result code. |
| * |
| * @param actionContext The action context |
| * @param actionName The action name |
| * @param actionConfig The action config |
| * @param resultCode The returned result code |
| * @return A result to be executed, can return <tt>null</tt> |
| * @throws XWorkException |
| */ |
| public Result handleUnknownResult(ActionContext actionContext, String actionName, ActionConfig actionConfig, String resultCode) throws XWorkException; |
| |
| /** |
| * Handles the case when an action method cannot be found. This method is responsible both for finding the method and executing it. |
| * |
| * @since 2.1 |
| * @param action The action object |
| * @param methodName The method name to call |
| * @return The result returned from invoking the action method, can return <tt>null</tt> |
| * @deprecated @throws NoSuchMethodException If the method cannot be found should return null instead, |
| * don't throw exception as other UnknownHandles won't be invoked |
| * 'throws NoSuchMethodException' signature will be removed with next |
| * major release |
| */ |
| public Object handleUnknownActionMethod(Object action, String methodName) throws NoSuchMethodException; |
| } |